Coding-Agent Skills
Skills are plain Markdown playbooks that live in .claude/skills/. Any team member can invoke them with a /skill-name slash command in Claude Code, and the agent follows the same steps every time — consistent, reviewable, no ad-hoc prompting required.
Available skills
📝 /release-docs
Generate a combined release blog post for a new version.
Use when: cutting a release or when someone asks "what changed in 0.4.x"
Produces: docs/releases/YYYY-MM-DD-release-X-Y-Z.md — release notes narrative + upgrade guide in one file, picked up by the Docusaurus releases blog plugin.
Inputs: to-version, from-version (auto-detected from git tags if omitted), optional values.yaml for personal impact analysis.
🔄 /update-docs
Audit and sync all documentation surfaces after a release or feature addition.
Use when: after cutting a release, adding a new agent, or updating platform features.
Checks:
| # | Surface | Stale when… |
|---|---|---|
| 1 | Release blog posts | A git tag has no matching docs/releases/ file |
| 2 | Homepage version string | Helm --version in index.tsx is behind latest tag |
| 3 | Published versions | A released tag is missing from docs/published-versions.json |
| 4 | Features page tiles | New feature docs without a tile in features.tsx |
| 5 | Agent docs | Agent directory with no docs/docs/agents/<name>.md |
| 6 | Sidebar | Doc directory not in sidebars.ts |
| 7 | Navbar label | Version label behind latest tag |
🧪 /integration-testing
Run the full end-to-end integration test suite against a running Docker Compose stack.
Use when: validating a feature branch before raising a PR, or after a major refactor.
📡 /streaming-testing
Compare A2A streaming behaviour across two supervisor versions side-by-side.
Use when: validating streaming correctness after changes to the supervisor or event pipeline.
💾 /persistence
Test and manage LangGraph persistence backends (Redis, Postgres, MongoDB).
Use when: switching persistence backends, validating checkpoint isolation, or debugging cross-agent memory issues.
🚦 /quality-gates
Run all pre-commit quality gates — lint, Python tests, UI tests — in one command.
Use when: before raising a PR or after resolving merge conflicts.
# Run all gates
./skills/quality-gates/run_all.sh
# Auto-fix lint first, then validate
./skills/quality-gates/run_all.sh --fix
Adding a new skill
See Create a Skill for the full guide. The short version:
- Create
.claude/skills/<your-skill-name>/SKILL.md - Add an entry to
.claude/skills/README.md - Add a row to the table above
The skill is immediately available as /your-skill-name to anyone using Claude Code in this repo.