SKILL.md
Validate learning repo
Use this skill when the task is to verify that the repository still teaches the right thing and that examples still match reality.
Workflow
- Read
references/checklist.md. - Run
scripts/check-required-files.sh. - Compare:
- README.md - AGENTS.md - CLAUDE.md - .claude/ - .github/ - skills/
- Look for:
- missing referenced files - missing required AGENTS.md command entries - repo guidance that teaches a required section or workflow but does not include it in practice - example trees that no longer match the repository - invalid agent or skill naming - duplicated guidance in the wrong layer - unsupported or invented conventions
- Format findings with
assets/report-template.md.
Output requirements
- Group findings into:
- broken or misleading - should improve - already good
- Prefer exact file paths.
- Be concrete.
- Do not suggest abstract "best practices" unless they clearly apply to this repo.