Show HN: Skills for spec-driven AI software development

puristajs1 pts0 comments

GitHub - sebastianwessel/skills: AI Skills · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

sebastianwessel

skills

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>11 Commits<br>11 Commits

.agent

.agent

docs

docs

scripts

scripts

skills

skills

.gitignore

.gitignore

AGENTS.md

AGENTS.md

CLAUDE.md

CLAUDE.md

LICENSE

LICENSE

README.md

README.md

View all files

Repository files navigation

AI Skills

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

Contents

Skill Index

Spec-Driven Development

Installation

Repository Layout

Documentation Pattern

Adding a Skill

Maintainer Notes

Skill Index

Skill<br>Description<br>Human docs

spec-architect<br>Use when specs need creation, review, repair, or approval before autonomous or parallel AI implementation without ambiguity, invention, interface mismatch, drift, or gaps.<br>docs

spec-implementation-planner<br>Use when approved specs need end-to-end waves, AFK tickets, parallel-agent plans, dependencies, status tracking, or readiness checks.<br>docs

spec-implementation-review<br>Use when a completed or partial spec implementation wave, plan, or cross-ticket solution needs review before acceptance, merge, release, or handoff.<br>docs

spec-ticket-implementation<br>Use when implementing one approved spec plan ticket with strict read/write scope, acceptance verification, dependency checks, and no implementation-time decisions.<br>docs

Spec-Driven Development

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

Installation

Install this skill package with the open skills ecosystem CLI:

npx skills add sebastianwessel/skills

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

Repository Layout

└── SKILL.md">skills/<br>└── /<br>└── SKILL.md

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

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

.md">docs/<br>└── skills/<br>└── .md

Documentation Pattern

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

What the skill is for.

Installation.

What it does.

How it works.

Workflow or modes.

Included files.

Validation and safety notes.

Adding a Skill

Create skills//SKILL.md.

Use concise YAML frontmatter with name and description.

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

Add docs/skills/.md for human-facing documentation.

Refresh this table of contents:

python3 scripts/update-readme.py

Maintainer Notes

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

About

AI Skills

Resources

Readme

License

Apache-2.0 license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

star

Watchers

watching

Forks

forks

Report repository

Releases

No releases published

Packages

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

JavaScript<br>87.5%

Python<br>12.5%

You can’t perform that action at this time.

skills skill spec docs repository implementation

Related Articles