skills-lab

A small, growing collection of Agent Skills for Claude — built to be readable, portable, and easy to drop into your own environment. Each skill is self-contained and framework-free: copy the folder in, and it works.

Skills in this repo

Skill What it does
skill-debrief Run it at the end of a conversation to review the skills you used and propose surgical, evidence-based improvements to them — so the corrections you made this session don't come back next time. Zero setup, no dependencies.

More skills will land here over time; each gets its own folder under skills/.

Installing a skill

A skill is just a folder with a SKILL.md inside. To use one, put that folder where Claude looks for skills. You have two choices:

Everywhere (user-level) — available in every project on your machine:

# from the repo root
cp -R skills/skill-debrief ~/.claude/skills/

One project only — scoped to a single repo:

# from inside the project you want it in
mkdir -p .claude/skills
cp -R /path/to/skills-lab/skills/skill-debrief .claude/skills/

Prefer a symlink if you want the skill to update when you git pull this repo:

ln -s "$(pwd)/skills/skill-debrief" ~/.claude/skills/skill-debrief

That's it — Claude discovers the skill by its SKILL.md description and triggers it when your request matches. No config, no restart required.

Not using Claude Code?

Skills also work in the Claude apps and anywhere the skill format is supported. Each skill here is a standard SKILL.md folder, so it can be zipped into a .skill file and uploaded wherever skills are accepted.

Repo layout

skills-lab/
├── README.md
├── LICENSE
└── skills/
    └── <skill-name>/
        ├── SKILL.md          # the skill: frontmatter (name + description) + instructions
        └── references/       # optional deeper docs the skill loads only when needed

Each skill folder follows the same convention: a SKILL.md whose frontmatter description is what tells Claude when to use it, plus optional references/, scripts/, or assets/ loaded on demand.

License

MIT © Bree Hall (@bytesofbree)