Skills
Table of Contents
Every Claude Code skill used with ORE Studio lives at
doc/llm/skills/<slug>/SKILL.org and is listed below, grouped by area. Skills are
task-shaped: each one is the playbook an LLM session loads to perform a
specific unit of work end-to-end. Compare with function, which is role-shaped.
See CMake Runner for the deployment workflow or return to Knowledge.
Skill naming. Every skill is named <domain>-<verb>[-<object>] in
kebab-case, after the action it performs — never a role, an
artefact, or the command it wraps: agile-add-story, pr-merge,
devops-setup-environment. The domain prefixes (agile-, pr-,
doc-, code-, codegen-, devops-, skill-) and the verbs are
closed registers defined in Skill naming conventions — read it before adding or
renaming a skill, and check this inventory for an existing skill
covering the same action. The slug is both the directory name under
doc/llm/skills/ and the name: field in the skill's frontmatter —
keep them identical. Note that deployment (deploy_skills) does not
remove stale directories from .claude/skills/, so after renaming a
skill delete the old deployed directory by hand.
Agile (agile-)
Stories, tasks, sprints, backlog, journal, orientation.
| Name | Title | Description |
|---|---|---|
| agile-add-capture | Agile Add Capture | File a single idea or observation into the product backlog inbox as a well-structured capture. |
| agile-add-release-notes | Agile Add Release Notes | Generate ORE Studio release notes from merged PRs and the closing sprint backlog, then tag main and open a… |
| agile-add-story | Agile Add Story | Create a story with docs only — no branch, no journal; backlog refinement and sprint planning use this. |
| agile-add-task | Agile Add Task | Add a task to an existing story, docs only — no branch side effects. |
| agile-add-timeline-snapshot | Agile Add Timeline Snapshot | Create a 20-minute timeline snapshot of recent agile activity; write it to the current sprint's timeline/ folder. |
| agile-brainstorm-idea | Agile Brainstorm Idea | Explore user intent and design through collaborative dialogue — one question at a time, alternatives with t… |
| agile-close-task | Agile Close Task | Close a task's bookkeeping at the end of the review round: DONE, Result, story and sprint sync; cascades to… |
| agile-find-bearings | Agile Find Bearings | Initialise a session — compass-first operation, recipe search for command info, bearings, then a summary an… |
| agile-find-heading | Agile Find Heading | Find the next work item — run compass heading, surface the ranked suggestions, and recommend the top action. |
| agile-open-sprint | Agile Open Sprint | Open a new ORE Studio sprint. Scaffold the sprint folder via codegen, set its mission, link it from the ver… |
| agile-plan-sprint | Agile Plan Sprint | Run a sprint planning session: read the sprint mission, score next-backlog captures against sprint goals, p… |
| agile-refine-backlog | Agile Refine Backlog | Run a backlog housekeeping session: scan the next/deferred captures, clarify descriptions, cull stale items… |
| agile-review-sprint | Agile Review Sprint | / |
| agile-show-backlog | Agile Show Backlog | Show the product backlog buckets: inbox, next, deferred, discarded. |
| agile-show-fleet | Agile Show Fleet | Show what every git worktree is doing: branch, story, task, open PR. |
| agile-show-journal | Agile Show Journal | Show the session journal: where we have been, story and task journeys per worktree. |
| agile-show-sprint | Agile Show Sprint | Show the current sprint's stories grouped by state, and audit for drift. |
| agile-show-status | Agile Show Status | Show where we are: current version, sprint, and in-flight stories and tasks. |
| agile-start-hotfix | Agile Start Hotfix | Start a hotfix: scaffold story and task on a hotfix/ branch from the production error. |
| agile-start-story | Agile Start Story | Pick up a story: fetch main, create the feature branch, mark STARTED, stamp the journal. |
| agile-start-task | Agile Start Task | Pick up a task: switch or create its branch, mark it STARTED, stamp the journal. |
Pull requests (pr-)
PR lifecycle.
| Name | Title | Description |
|---|---|---|
| pr-address-review | PR Address Review | Handle one complete PR review round: sync, read comments, decide, fix, push, reply, resolve, record. |
| pr-merge | PR Merge | Merge a PR with guard rails: threads resolved, CI green, task bookkeeping already closed. |
| pr-show-checks | PR Show Checks | Show CI check status for a PR, optionally watching until completion. |
| pr-sync-branch | PR Sync Branch | Rebase the current feature branch on origin/main and report divergence; never work on a stale branch. |
Documentation (doc-)
Recipes, knowledge, manual, memory, diagrams, search.
| Name | Title | Description |
|---|---|---|
| doc-add-chart | Doc Add Chart | / |
| doc-add-class-diagram | Doc Add Class Diagram | Author or update a PlantUML class diagram for an ORE Studio component, or the system-level architecture dia… |
| doc-add-component-model | Doc Add Component Model | Create or update component_overview.org and the PlantUML class diagram for an ORE Studio component. |
| doc-add-er-diagram | Doc Add ER Diagram | Author or update the PlantUML ER diagram for the ORE Studio SQL schema — tables, relationships, temporal pa… |
| doc-add-knowledge | Doc Add Knowledge | Create a knowledge document: scaffold, fill Summary and Detail, tag, and wire the knowledge index. |
| doc-add-memory | Doc Add Memory | When the user gives feedback worth remembering, or asks "remember this", write or update a memory under doc… |
| doc-add-recipe | Doc Add Recipe | Add new how-do-I recipes to ORE Studio under doc/recipes/<topic>/. Pick the right topic, scaffold via the c… |
| doc-find | Doc Find | Search every document in the repository: full-text search and structured filters over the org-roam graph. |
| doc-show | Doc Show | Show one document by UUID or prefix: metadata, blurb, incoming and outgoing links. |
| doc-sync-index | Doc Sync Index | Rebuild the compass search index and org-roam database when they are stale. |
| doc-sync-recipes | Doc Sync Recipes | Compare a recipe topic's source-of-truth (CLI parsers, HTTP routes, shell commands, SQL scripts, …) again… |
| doc-update-manual | Doc Update Manual | When to update the user manual and how: find the right chapter, update prose, add screenshot placeholders,… |
Hand-written code (code-)
Build, tests, review, investigation — code written by hand.
| Name | Title | Description |
|---|---|---|
| code-add-domain-type | Code Add Domain Type | Create a new ORE Studio domain type with JSON I/O, table I/O, generator, and repository support via codegen. |
| code-add-tests | Code Add Tests | Generate Catch2 unit tests for ORE Studio components — domain, repository, messaging, generators, service,… |
| code-investigate-test-failure | Code Investigate Test Failure | Investigate unit test failures by enabling logging, running the failing suite, parsing the result XML, and… |
| code-review-component | Code Review Component Skill | Deep audit of one or more ORE Studio components for technical debt, modernisation opportunities, and conven… |
| code-review-pr | Code Review PR Skill | Review changes in a pull request against the ORE Studio code-review checklist; produce findings bucketed by… |
| code-run-build | Code Run Build | Run CMake operations on ORE Studio — configure, build, test, deploy site, deploy skills, generate PlantUML… |
| code-start-branch | Code Start Branch | Create a clean branch off main for out-of-band work with no task attached; task-shaped work uses agile-star… |
Generated code (codegen-)
Entities, components, and schemas produced by ores.codegen.
| Name | Title | Description |
|---|---|---|
| codegen-add-cli-entity | Codegen Add CLI Entity | Create CLI commands for domain entities in ores.cli including import, export, list, delete, and add operati… |
| codegen-add-component | Codegen Add Component | Scaffold a new ORE Studio component (api/core/service) via codegen profiles. |
| codegen-add-entity | Codegen Add Entity | Create a complete full-stack ORE Studio entity across all layers via codegen — the orchestrator skill. |
| codegen-add-http-entity | Codegen Add HTTP Entity | Create HTTP REST API endpoints for domain entities in ores.http.server including CRUD operations and history. |
| codegen-add-qt-entity | Codegen Add QT Entity | Create Qt UI components for domain entities including list windows, detail dialogs, history dialogs, and co… |
| codegen-add-shell-entity | Codegen Add Shell Entity | Create shell commands for domain entities in ores.shell including list, add, history, and other operations. |
| codegen-add-sql-schema | Codegen Add SQL Schema | Guide for creating SQL table definitions, triggers, and population scripts for ORE Studio. |
| codegen-add-wt-entity | Codegen Add WT Entity | Create Wt web UI components for domain entities including list widgets, detail dialogs, and application int… |
DevOps (devops-)
Environment, database, services, shell, client, site.
| Name | Title | Description |
|---|---|---|
| devops-deploy-manual | Devops Deploy Manual | Build and publish the user manual PDF. |
| devops-deploy-settings | Devops Deploy Settings | Tangle Claude Code settings.json from its org source. |
| devops-deploy-site | Devops Deploy Site | Build and publish the documentation website from the org-roam graph. |
| devops-deploy-skills | Devops Deploy Skills | Build the Claude Code skills bundle from doc/llm/skills and purge stale deployed directories. |
| devops-recreate-db | Devops Recreate DB | Rebuild the database from scratch: drop, recreate, restore schema and seed data. |
| devops-run-client | Devops Run Client | Launch the Qt client detached, with optional colour and instance name for parallel runs. |
| devops-run-shell | Devops Run Shell | Launch ores.shell with NATS and login defaults from .env, interactively or scripted with -f. |
| devops-run-sql | Devops Run SQL | Run SQL in the environment via compass with credentials and connection from .env. |
| devops-setup-environment | Devops Setup Environment | Set up a working environment end-to-end: sync indexes, deploy skills and settings, init env, recreate the DB. |
| devops-show-services | Devops Show Services | Show service fleet status: running, stopped, missing. |
| devops-start-services | Devops Start Services | Start the service fleet and verify everything came up. |
| devops-stop-services | Devops Stop Services | Stop the service fleet cleanly. |
Skills (skill-)
The skills themselves.
| Name | Title | Description |
|---|---|---|
| skill-add | Skill Add | Create or update Claude Code skills and rebuild the shipped skill bundle. |
| skill-delete | Skill Delete | Retire a skill safely: check incoming links, re-point or downgrade them, remove the source, regenerate the… |
| skill-review | Skill Review Skill | Review existing skills against the skill contract. Use when auditing skill quality, before adding a new ski… |
| skill-show-catalogue | Skill Show Catalogue | Show the skills catalogue nicely grouped by domain prefix, with each skill's name, title, and description —… |
Retired skills
Removed by the Action-oriented skill cleanup story (sprint 20):
run-runbook (one skill per runbook instead), pr-manager and
pr-shepherd (dissolved into the pr- set), feature-branch-manager
(dissolved into the lifecycle skills plus code-start-branch),
agile-product-owner, system-architect, semi-autonomous-developer
(roles dissolved into actions), design-principles and
icon-guidelines (demoted to the knowledge docs they fronted).
Rebuilding skills
When skills change, redeploy them via the deploy_skills CMake
target. See How do I deploy the skills? for the recipe and the
CI hook that calls it.
See also
- Component documentation guide — skills that author component overviews use this contract.
- Functions — sibling concept: role-shaped, not task-shaped.