Reusable AI agent skills maintained in this repository. The work is shaped by Sebastian Wessel's article Spec-Driven Development, which explains this repository's spec-first approach for keeping autonomous AI agents aligned from business intent through implementation and review. Each skill lives in its own subdirectory under skills/ and follows Anthropic's Agent Skills best practices.

Contents

• Skill Index
• Spec-Driven Development
• Installation
• Repository Layout
• Documentation Pattern
• Adding a Skill
• Maintainer Notes

Skill Index

Spec-Driven Development

Read Spec-Driven Development for the rationale behind this repository. The article describes how clear specs, implementation plans, ticket execution, and review gates work together so AI agents can build production-ready systems without drifting from the intended business outcome.

Installation

Install this skill package with the open skills ecosystem CLI:

npx skills add sebastianwessel/skills

See Vercel's announcement of skills and skills.sh for the package ecosystem.

Repository Layout

skills/
└── <skill-name>/
    └── SKILL.md

Optional per-skill directories include references/, scripts/, assets/, and agents/.

Human-facing skill documentation lives outside the executable skill package:

docs/
└── skills/
    └── <skill-name>.md

Documentation Pattern

Each skill should have a concise human docs page with the same structure:

1. What the skill is for.
2. Installation.
3. What it does.
4. How it works.
5. Workflow or modes.
6. Included files.
7. Validation and safety notes.

Adding a Skill

1. Create skills/<skill-name>/SKILL.md.

2. Use concise YAML frontmatter with name and description.

3. Keep detailed reference material in files linked directly from SKILL.md.

4. Add docs/skills/<skill-name>.md for human-facing documentation.

5. Refresh this table of contents:

   python3 scripts/update-readme.py

Maintainer Notes

Repository instructions for agents are in AGENTS.md. Claude reads CLAUDE.md, which points back to the same shared guidance.