Checks:

• Backtick-wrapped @ links - backticks disable resolution
• Relative paths like skills/ or skills/gardening-skills-wiki/~/ - should use skills/ absolute paths
• All skills/ references resolve to existing files
• Skills referenced in INDEX files exist
• Orphaned skills (not in any INDEX)

Fixes:

• Remove backticks from @ references
• Convert skills/ and skills/gardening-skills-wiki/~/ relative paths to skills/ absolute paths
• Update broken skills/ references to correct paths
• Add orphaned skills to their category INDEX
• Remove references to deleted skills

2. Naming Consistency (check-naming.sh)

Checks:

• Directory names are kebab-case
• No uppercase or underscores in directory names
• Frontmatter fields present (name, description, when_to_use, version, type)
• Skill names use active voice (not "How to...")
• Empty directories

Fixes:

• Rename directories to kebab-case
• Add missing frontmatter fields
• Remove empty directories
• Rephrase names to active voice

3. INDEX Coverage (check-index-coverage.sh)

Checks:

• All skills listed in their category INDEX
• All category INDEX files linked from main INDEX
• Skills have descriptions in INDEX entries

Fixes:

• Add missing skills to INDEX files
• Add category links to main INDEX
• Add descriptions for INDEX entries

Common Issues and Fixes

Broken Links

❌ BROKEN: skills/debugging/root-cause-tracing
   Target: /path/to/skills/debugging/root-cause-tracing/SKILL.md

Fix: Update the reference path - skill might have moved or been renamed.

Orphaned Skills

⚠️  ORPHANED: test-invariants/SKILL.md not in testing/INDEX.md

Fix: Add to the category INDEX:

- skills/gardening-skills-wiki/test-invariants - Description of skill

Backtick-Wrapped Links

❌ BACKTICKED: skills/testing/condition-based-waiting on line 31
   File: getting-started/SKILL.md
   Fix: Remove backticks - use bare @ reference

Fix: Remove backticks:

# ❌ Bad - backticks disable link resolution
`skills/testing/condition-based-waiting`

# ✅ Good - bare @ reference
skills/testing/condition-based-waiting

Relative Path Links

❌ RELATIVE: skills/testing in coding/SKILL.md
   Fix: Use skills/ absolute path instead

Fix: Convert to absolute path:

# ❌ Bad - relative paths are brittle
skills/testing/condition-based-waiting

# ✅ Good - absolute skills/ path
skills/testing/condition-based-waiting

Naming Issues

⚠️  Mixed case: TestingPatterns (should be kebab-case)

Fix: Rename directory:

cd ~/.claude/skills/testing
mv TestingPatterns testing-patterns
# Update all references to old name

Missing from INDEX

❌ NOT INDEXED: condition-based-waiting/SKILL.md

Fix: Add to testing/INDEX.md:

…

Naming Variables

帮助你为变量选择清晰准确、易维护的命名，提升代码可读性。

qaskills

提供面向 AI 编码代理的测试技能目录，帮助快速查找与应用 QA 能力。