Skills
Table of Contents
- 1. Agile (
compass-agile-) - 2. Pull requests (
compass-pr-) - 3. Documentation (
compass-doc-) - 4. Hand-written code (
compass-code-) - 5. Generated code (
compass-codegen-) - 6. DevOps (
compass-devops-) - 7. Skills (
compass-skill-) - 8. Principles (
compass-principle-) - 9. Methods (
compass-method-) - 10. The mode (
compass-helm) - 11. Rebuilding skills
- 12. See also
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 System, 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, compass-pr-merge,
compass-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.
1. Agile (compass-agile-)
Stories, tasks, sprints, backlog, journal, orientation.
| Name | Title | Description |
|---|---|---|
| compass-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… |
| compass-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/ f… |
| compass-agile-brainstorm-idea | Agile Brainstorm Idea | Explore user intent and design through collaborative dialogue — one question at a time, alternatives with t… |
| compass-agile-close-task | Agile Close Task | Close a task's bookkeeping before raising its PR (not after review): DONE, Result, story and sprint sync; c… |
| compass-agile-find-bearings | Agile Find Bearings | Initialise a session — compass-first operation, recipe search for command info, bearings, then a summary an… |
| compass-agile-find-heading | Agile Find Heading | Find the next work item — run compass heading, surface the ranked suggestions, and recommend the top action. |
| compass-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… |
| compass-agile-plan-sprint | Agile Plan Sprint | Run a sprint planning session: read the sprint mission, score next-backlog captures against sprint goals, p… |
| compass-agile-refine-backlog | Agile Refine Backlog | / |
| compass-agile-review-sprint | Agile Review Sprint | / |
| compass-agile-start-hotfix | Agile Start Hotfix | Start a hotfix: scaffold story and task on a hotfix/ branch from the production error. |
| compass-agile-start-story | Agile Start Story | Pick up a story: fetch main, create the feature branch, mark STARTED, stamp the journal. |
| compass-agile-start-task | Agile Start Task | Pick up a task: switch or create its branch, mark it STARTED, stamp the journal. |
2. Pull requests (compass-pr-)
PR lifecycle.
| Name | Title | Description |
|---|---|---|
| compass-pr-address-review | PR Address Review | Handle one complete PR review round: sync, read comments, decide, fix, push, reply, resolve, record. |
| compass-pr-merge | PR Merge | Merge a PR with guard rails: threads resolved, CI green, task bookkeeping already closed. |
| compass-pr-raise | PR Raise | Run the local code review, then open a pull request with compass pr create and post an @claude comment to t… |
| compass-pr-sync-branch | PR Sync Branch | Rebase the current feature branch on origin/main and report divergence; never work on a stale branch. |
3. Documentation (compass-doc-)
Recipes, knowledge, manual, memory, diagrams, search.
| Name | Title | Description |
|---|---|---|
| compass-doc-add | Doc Add | Create a document of any type — story, task, capture, knowledge, recipe, memory and the rest. Scaffold it,… |
| compass-doc-add-chart | Doc Add Chart | / |
| compass-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… |
| compass-doc-add-component-model | Doc Add Component Model | Create or update component_overview.org and the PlantUML class diagram for an ORE Studio component. |
| compass-doc-add-entity-chapter | Doc Add Entity Chapter | Author a complete user-manual chapter for a reference-data entity, from domain grounding through screenshot… |
| compass-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… |
| compass-doc-add-memory | Doc Add Memory | When the user gives feedback worth remembering, or asks "remember this", write or update a memory under doc… |
| compass-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… |
| compass-doc-find | Doc Find | Search every document in the repository: full-text search and structured filters over the org-roam graph. |
| compass-doc-review-academic | Review and write academic prose | Layered review of argumentative documentation: claim, spine, paragraph, sentence, term, evidence, honesty. |
| compass-doc-review-ste100 | Review and rewrite agent output using ASD-STE100 Simplified Technical English | Rewrites ambiguous English into ASD-STE100 style — one meaning per word, active voice, simple tense, short… |
| compass-doc-run-manual-screenshots | Doc Run Manual Screenshots | Turn a manual chapter's [SCREENSHOT NEEDED] placeholders into real, cropped screenshots – confirm a build… |
| compass-doc-show | Doc Show | Show the current state of anything — a document, the sprint, the fleet, the journal, services, CI checks, a… |
| compass-doc-sync-index | Doc Sync Index | Rebuild the compass search index and org-roam database when they are stale. |
| compass-doc-sync-recipes | Doc Sync Recipes | Compare a recipe topic's source-of-truth (HTTP routes, shell commands, SQL scripts, …) against the recipe… |
| compass-doc-update-manual | Doc Update Manual | When to update the user manual and how: find the right chapter, update prose, add screenshot placeholders,… |
4. Hand-written code (compass-code-)
Build, tests, review, investigation — code written by hand.
| Name | Title | Description |
|---|---|---|
| compass-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. |
| compass-code-add-tests | Code Add Tests | Generate Catch2 unit tests for ORE Studio components — domain, repository, messaging, generators, service,… |
| compass-code-investigate-test-failure | Code Investigate Test Failure | Investigate unit test failures by enabling logging, running the failing suite, parsing the result XML, and… |
| compass-code-review-comments | Review and clean code comments | Review and clean code comments — remove clutter, keep necessary explanations, place comments above the code… |
| compass-code-review-component | Code Review Component Skill | Deep audit of one or more ORE Studio components for technical debt, modernisation opportunities, and conven… |
| compass-code-review-data-model | Code Review Data Model Skill | Review a component's data model against the data-oriented design criteria: regime classification, layout, v… |
| compass-code-review-pr | Code Review PR Skill | Review changes in a pull request against the ORE Studio code-review checklist; produce findings bucketed by… |
| compass-code-run-build | Code Run Build | Run CMake operations on ORE Studio — configure, build, test, deploy site, deploy skills, generate PlantUML… |
| compass-code-run-feature-test | Code Run Feature Test | Test a feature after finishing implementation — ask about a build, confirm/recreate a fresh database, provi… |
| compass-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 compass-ag… |
5. Generated code (compass-codegen-)
Entities, components, and schemas produced by ores.codegen.
| Name | Title | Description |
|---|---|---|
| compass-codegen-add-component | Codegen Add Component | Scaffold a new ORE Studio component (api/core/service) via codegen profiles. |
| compass-codegen-add-entity | Codegen Add Entity | Create a complete full-stack ORE Studio entity across all layers via codegen — the orchestrator skill. |
| compass-codegen-add-sql-schema | Codegen Add SQL Schema | Guide for creating SQL table definitions, triggers, and population scripts for ORE Studio. |
| compass-codegen-add-surface-entity | Codegen Add Surface Entity | Add an entity to a user-facing surface — the CLI, the HTTP API, or the shell REPL. One three-phase procedur… |
| compass-codegen-fix-drift | Codegen Fix Drift | Run one component through the codegen drift-elimination method — baseline regen, survey, profile binding, b… |
| compass-codegen-sync-cmake-sources | compass-codegen-sync-cmake-sources | Regenerate CMake component file lists (component_files.cmake) after adding/removing a source file, or after… |
6. DevOps (compass-devops-)
Environment, database, services, shell, client, site.
| Name | Title | Description |
|---|---|---|
| compass-devops-deploy-manual | Devops Deploy Manual | Build and publish the user manual PDF. |
| compass-devops-deploy-settings | Devops Deploy Settings | Tangle Claude Code settings.json from its org source. |
| compass-devops-deploy-site | Devops Deploy Site | Build and publish the documentation website from the org-roam graph. |
| compass-devops-deploy-skills | Devops Deploy Skills | Build the Claude Code skills bundle from doc/llm/skills, then reload it in the running session. |
| compass-devops-deprovision-environment | Deprovision a named environment | Use compass env deprovision to remove a named worktree and its directory. |
| compass-devops-provision-environment | Provision a new named environment | Use compass env provision to create a named worktree, assign isolated ports, and write a skeleton .env. |
| compass-devops-recreate-db | Devops Recreate DB | Rebuild the database from scratch: drop, recreate, restore schema and seed data. |
| compass-devops-run-environment | Devops Run Environment | Run the full environment-readying sequence: stop services, recreate the database, start services, and provi… |
| compass-devops-run-shell | Devops Run Shell | Launch ores.shell with NATS and login defaults from .env, interactively or scripted with -f. |
| compass-devops-run-sql | Devops Run SQL | Run SQL in the environment via compass with credentials and connection from .env. |
| compass-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. |
| compass-devops-start-services | Devops Start Services | Start the service fleet and verify everything came up. |
| compass-devops-stop-services | Devops Stop Services | Stop the service fleet cleanly. |
| compass-devops-update-environment | Update a worktree to latest main | Bring a worktree fully up to date with main: fetch, detached checkout of the latest commit, sync submodules… |
7. Skills (compass-skill-)
The skills themselves.
| Name | Title | Description |
|---|---|---|
| compass-skill-add | Skill Add | Create or update Claude Code skills and rebuild the shipped skill bundle. |
| compass-skill-delete | Skill Delete | Retire a skill safely: check incoming links, re-point or downgrade them, remove the source, regenerate the… |
| compass-skill-review | Skill Review Skill | Review existing skills against the skill contract. Use when auditing skill quality, before adding a new ski… |
| compass-skill-show-catalogue | Skill Show Catalogue | Show the skills catalogue nicely grouped by domain prefix, with each skill's name, title, and description —… |
8. Principles (compass-principle-)
Local bindings on an upstream principle, supplying the project detail the rule cannot know.
| Name | Title | Description |
|---|---|---|
| compass-principle-never-block-on-the-human | Compass Principle Never Block On The Human | The local binding for never-block-on-the-human — proceed on reversible work and record the assumption; conf… |
| compass-principle-type-system-discipline | Compass Principle Type System Discipline | The C++ binding for type-system-discipline — what each upstream pattern becomes in this codebase, which the… |
9. Methods (compass-method-)
How a kind of work is approached, from framing to a verified end.
| Name | Title | Description |
|---|---|---|
| compass-method-bug-fix | Compass Method Bug Fix | The method for a reported defect — ground, reproduce, root-cause, fix, prove. States the predicate before t… |
| compass-method-feature | Compass Method Feature | The method for new or changed behaviour — ground, state the predicate, name the data shape, check what exis… |
| compass-method-figure-it-out | Compass Method Figure It Out | The method for work no method fits — design the phases first, state how each will be verified, then run the… |
| compass-method-investigation | Compass Method Investigation | The method for a read-only question — how does this work, why is it this way, are we sure. Ends in a cited… |
| compass-method-prototype | Compass Method Prototype | The method for settling an empirical question by observing it — the smallest thing that produces the observ… |
| compass-method-refactoring | Compass Method Refactoring | The method for a behaviour-preserving change to structure — establish the evidence that behaviour is preser… |
10. The mode (compass-helm)
The sticky posture a session enters, which matches work to a method and routes to everything else.
| Name | Title | Description |
|---|---|---|
| compass-helm | Compass Helm | The sticky mode. Declares the session System, matches the work to a method, copies that method's phases int… |
11. 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.
12. See also
- Component documentation guide — skills that author component overviews use this contract.
- Systems — sibling concept: role-shaped, not task-shaped.