skills

Reusable SKILL.md workflows for AI coding agents.

A skill is a small folder with a SKILL.md instruction file and, when needed, supporting references, scripts, or templates. Agents load the skill when the task matches it, then read helper files only as needed.

Start

Give your agent this repo:

https://github.com/barlevalon/skills

Then ask for a workflow:

Use TDD to implement this change.
Diagnose this bug before fixing it.
Prepare a release plan.

If your agent cannot read GitHub URLs, clone the repo and give it the local skills/ folder or a complete skill folder.

git clone https://github.com/barlevalon/skills.git

Use with your tool

• opencode / Codex: add an AGENTS.md rule. See setup.
• Cursor: add a .cursor/rules rule. See setup.
• VS Code Copilot: add .github/copilot-instructions.md. See setup.
• Continue: add a .continue/rules rule. See setup.
• Cline: add a .clinerules/ rule. See setup.
• Package-aware tools: use @barlevalon/skills.

Pick a skill

Work	Skill
Plan a feature	write-a-prd, prd-to-plan, grill-with-docs, grilling
Debug	diagnose
Build test-first	tdd
Prototype	prototype
Improve architecture	improve-codebase-architecture, codebase-design, domain-modeling
Review code	thermo-nuclear-code-quality-review
Write docs	documentation-system
Write or edit skills	writing-great-skills
Release	release-prep
Commit message	caveman-commit
Handoff	handoff
Visual explanation	plannotator-visual-explainer

Full list: docs/usage.md

Docs

• Setup
• Workflow map
• Skill reference
• Maintainer release process

Credits

• caveman, caveman-commit, caveman-help: based on JuliusBrussee/caveman by Julius Brussee.
• codebase-design, diagnose, domain-modeling, grilling, grill-with-docs, handoff, improve-codebase-architecture, prd-to-plan, prototype, write-a-prd, writing-great-skills, zoom-out: based on mattpocock/skills by Matt Pocock.
• find-skills: based on vercel-labs/skills by Vercel.
• worktrunk: based on max-sixty/worktrunk by Maximilian Roos.
• thermo-nuclear-code-quality-review: based on cursor/plugins by Cursor.
• plannotator-*: based on backnotprop/plannotator by backnotprop.

License

MIT