use-this-repo ยท diff
git:20260315.41435a9 to git:20261117.ab63f92
3 added, 28 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: use-this-repo
- description: Help a user understand this repository, decide which AI structure pieces they need, and adapt the template to their own project.
+ description: Explain this repository's AI structure, what each layer and file is for, and how the Claude, GitHub/Copilot, and shared skill layers fit together. Use when someone asks what this repo is, how its layers connect, or which file does which job. For copying or adapting the structure into another project, use adopt-this-repo instead.
---
# Use this repo
Use this skill when the user wants to:
- understand what this repository is for
- learn how the Claude, GitHub, and shared skill layers fit together
- - decide which files and folders to copy into their own project
- - adapt this repository structure to a real project
- - create a small adoption plan from this repository
## What this repository is
This repository is a practical learning repo for AI-enabled project structure.
It demonstrates:
- shared agent instructions in `AGENTS.md`
- Claude-specific project guidance in `CLAUDE.md`
- internal Claude rules, agents, and skills in `.claude/`
- internal GitHub/Copilot instructions, agents, and skills in `.github/`
- external/shared user-facing skills in `skills/`
## Workflow
1. Read `references/repo-map.md`.
2. Run `scripts/quickstart-check.sh` to confirm the expected starter files are present.
- 3. Identify the user's goal:
- - learn the structure
- - copy the structure
- - simplify the structure
- - adapt the structure to an existing repo
- 4. Explain the repository in this order:
+ 3. Explain the repository in this order:
- root files
- `.claude/`
- `.github/`
- `skills/`
- 5. Use `assets/adoption-plan-template.md` to produce a practical recommendation.
+ 4. If the user wants to copy or adapt the structure, hand off to the `adopt-this-repo` skill.
## Output requirements
Always:
- explain this repository using the real folders and files that exist
- separate internal maintainer AI from external/shared user-facing AI
- - recommend the smallest useful structure first
- keep the explanation concrete and specific to this repository
-
- When suggesting adoption:
- - tell the user what to copy first
- - tell the user what can wait until later
- - explain why each piece exists
- - avoid suggesting extra folders unless they solve a real need
-
- ## Default recommendation order
-
- For most users, recommend this adoption order:
- 1. `README.md`
- 2. `AGENTS.md`
- 3. `CLAUDE.md`
- 4. `.claude/`
- 5. `.github/`
- 6. `skills/`
## Important distinction
- `.claude/` = internal Claude setup for maintainers
- `.github/` = internal GitHub/Copilot setup for maintainers
- `skills/` = external/shared skills for users and outside agents
Do not mix those layers together.