Claude Skills

A personal collection of custom Claude Code skills — reusable, prompt-driven capabilities that extend what Claude Code can do in a session.

What's here

Skill	Description
add-single-adr	Adds a single Architecture Decision Record to the VA Design System docs site — from a PR, rough notes, or formatted markdown
ship-notes	Generates bi-weekly ship notes / sprint summaries from git history across configured repos

How skills work

Each skill lives in its own subdirectory under skills/ and contains at minimum a SKILL.md file. Claude Code loads a skill when invoked via the Skill tool, which injects the skill's instructions into the active session.

Skills in this repo are works-in-progress — they get iterated on as I find gaps or want different behavior.

Using a skill

To use a skill from this repo, point your Claude Code config at it or copy the skill directory into your project's .claude/skills/ folder. Then invoke it by name:

/ship-notes

Adding a new skill

1. Create a new directory under skills/<skill-name>/
2. Add a SKILL.md with a frontmatter name and description, followed by instructions
3. Add any supporting config files (see ship-notes/config.example.yml for a pattern)
4. Update the table above