validate-learning-repo · git:20260315.41435a9 · 2026-03-15 · sha256 9a42fc43d9f376d2

validate-learning-repo git:20260315.41435a9A

Immutable. This exact content never changes and is served at /api/v1/blob/9a42fc43d9f376d2.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_7l6teamzuk7vyx34/9a42fc43d9f376d23ad6e67a09698f95d15d70577e78166c976efeb10fd4accc.json

Then /plugin install validate-learning-repo@markdownregistry-7l6teamzuk7vyx34 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
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/`
   - `skills/`
4. Look for:
   - missing referenced files
   - 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.