# Validate Learning Repo

> 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.

- Skill: `igniteui/validate-learning-repo` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add igniteui/validate-learning-repo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/igniteui/validate-learning-repo/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: igniteui (https://skillmd.com/u/igniteui)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/igniteui/validate-learning-repo

---


# 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
   - 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
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.

