validate-learning-repo ยท diff
git:20261117.ab63f92 to git:20261117.4024d82
2 added, 0 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
---
name: validate-learning-repo
description: Audits this repository's teaching content against the real file structure. Use when checking README examples, AGENTS.md, CLAUDE.md, .claude/, .github/, or shared skills for accuracy and consistency.
---
# 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
1. Read `references/checklist.md`.
2. Run `scripts/check-required-files.sh`.
3. Compare:
- `README.md`
- `AGENTS.md`
- `CLAUDE.md`
- `.claude/`
- `.github/`
+ - `.codex/`
+ - `.agents/`
- `skills/`
4. Look for:
- missing referenced files
- missing `AGENTS.md` command entries (a repo convention)
- 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
5. 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.