skill.check_refs

Goal

• Check that all the skill and rule files have references

Workflow

Find Files

• Look for all the markdown files, both SKILL.md and <TOPIC>.rules.md

  > find .claude/skills -name "*.md"
  

Read Context

• Read context about rules from .claude/skills/skill.rules.md

Check Rules

• For each file, apply all the following rules and report violations as described below

Check Files Existence

• Make sure the file follows .claude/skills/skill.rules.md # SKILL.md File Format

Check Header References

• Make sure the file follows .claude/skills/skill.rules.md # References and Dependencies

Check for Other Violations

• Use the rules in .claude/skills/skill.rules.md to look for clear violations
• Report a violation only when certain it is one

Report Violations

• Report all the violations in a file cfile using the format .claude/skills/cfile.rules.md

Ask the User Which Problems to Fix

• Ask the user which problems to fix by printing a numbered list of problems

Verification

• [ ] Every file under .claude/skills matching SKILL.md or <TOPIC>.rules.md was checked
• [ ] cfile follows the format in .claude/skills/cfile.rules.md
• [ ] Every reported violation is one the reviewer is confident about