use-this-repo

# 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: - root files - `.claude/` - `.github/` - `skills/` 5. Use `assets/adoption-plan-template.md` to produce a practical recommendation. ## 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.