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.mdAGENTS.mdCLAUDE.md.claude/.github/skills/
- Look for:
- missing referenced files
- missing required
AGENTS.mdcommand 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.