Claude-skill-registry card-structure-validator

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/card-structure-validator" ~/.claude/skills/majiayu000-claude-skill-registry-card-structure-validator && rm -rf "$T"

manifest: skills/data/card-structure-validator/SKILL.md

卡片結構驗證

檢驗日文學習卡片的結構完整性，提供診斷報告和修復建議。

使用方式

讀取指定卡片，執行結構檢查，輸出診斷報告。

請檢查 zettelkasten/verb-u/030_manabu.md 的卡片結構

檢查項目

YAML Frontmatter

欄位	必要性	驗證規則
card_id	必要	格式： `{category}_{number}`
title	必要	格式： `"日文 (讀音)"` 或 `"日文A vs 日文B"`
category	必要	須為有效分類（noun, verb-u, grammar 等）
jlpt_level	必要	n5, n4, n3, n2, n1 之一
tags	建議	陣列格式
dictionary	建議	包含 reading, pos, definition_ja

必要區塊

區塊	驗證規則
日文解釋	`### 日文` 或 `### 日文解釋` 標題存在
中文解釋	`### 中文` 或 `### 中文解釋` 標題存在
英文解釋	`### English` 標題存在
例句	`## 例句` 區塊存在，且有編號例句

連結格式

檢查項	正確格式
Markdown 連結	`[text](path.md)`
相對路徑	`../category/file.md`
禁止格式	`[[wikilink]]`

輸出格式

## 卡片結構診斷報告

**檔案**：{path}
**card_id**：{id}

### ✅ 通過的檢查
- YAML frontmatter 格式正確
- 必要區塊完整
- 連結格式正確

### ⚠️ 警告
- 缺少 dictionary.definition_en（可選欄位）
- tags 數量較少（建議 3-5 個）

### ❌ 錯誤
- 缺少 English 解釋區塊
- card_id 格式不符（應為 verb-u_030）

### 修復建議
1. 新增 `### English` 區塊
2. 修正 card_id 為 `verb-u_030`

與 Agent 的關係

角色	職責
card-structure-handler（Agent）	批次建立卡片結構，並發執行
card-structure-validator（Skill）	人工抽查驗證，互動式報告

互補而非替代：Agent 負責建立，Skill 負責驗證。

注意事項

此 Skill 只讀取和分析，不修改任何檔案
若需修復，請根據報告手動編輯或使用相關腳本
批次驗證請使用
```
verify-meta.py
```
腳本