> skills.catalog
AgentOps Skills
Every skill works alone. Compose them into flows when you want more structure.
The 12 factors describe the rules. The skills below enforce them in your runtime.
Core skills
/quickstartOne-line read on what to do next.
Use it when: First time in a repo. Or any time you’re lost.
/councilFactor: Validate Externally (V)Independent judges review your plan or PR.
Use it when: Multi-model consensus before you commit.
/researchFactor: Research Before You Build (IV)Codebase context plus prior learnings.
Use it when: Unfamiliar territory. Or where past decisions matter.
/pre-mortemFactor: Validate Externally (V)Pressure-test the plan before code.
Use it when: Load-bearing change. Run before /implement.
/implementFactor: Lock Progress Forward (VI)One scoped task. Built. Validated.
Use it when: You know what to build. Gates, not vibes.
/rpiResearch → plan → pre-mortem → build → vibe → post-mortem.
Use it when: The full lifecycle, end to end.
/vibeFactor: Validate Externally (V)Code-quality review before merge.
Use it when: Every merge. Auto-fires at the end of /rpi.
/evolveFactor: Compound Knowledge (VIII)Chase a goal autonomously, with regression gates.
Use it when: You have GOALS.md. Fix the worst fitness gap.
/dreamFactor: Extract Learnings (VII) · Compound Knowledge (VIII)Bounded corpus compounding. Never mutates source.
Use it when: Prepare learnings for the next run without touching product code.
Full catalog
Grouped by role. Every entry is a slash command in your agent chat.
Validation
/council/vibe/pre-mortem/post-mortemFlows
/research/plan/implement/crank/swarm/rpi/evolveBookkeeping
/retro/forge/flywheel/compileSession
/handoff/recover/status/trace/provenance/dreamProduct
/product/goals/release/readme/docUtility
/brainstorm/bug-hunt/complexity/scaffold/pushFull reference lives in the AgentOps repo.
The ao CLI
The repo-native operator surface behind the skills. Handles retrieval, health checks, compounding, goals, and terminal workflows. Always-on orchestration belongs to a a dedicated out-of-session substrate; AgentOps owns the loop and the corpus.
| ao quick-start | Set up AgentOps in a repo. |
| ao doctor | Health check. |
| ao demo | Value path in 5 minutes. |
| ao search "query" | Search sessions and local knowledge. |
| ao lookup --query "topic" | Retrieve curated learnings. |
| ao context assemble | Build a task briefing. |
| ao rpi phased "fix auth startup" | Run the phased lifecycle. |
| ao evolve --max-cycles 1 | One autonomous improvement cycle. |
| ao maturity --scan | Check corpus hygiene. |
| ao vibe-check | Flywheel + repo health. |
The CLI is optional but recommended. Install instructions on the Install page.
The .agents/ directory
AgentOps writes all bookkeeping to a local .agents/ directory in your repo: learnings, findings, handoffs, pre-mortems, plans, and per-run execution packets. It is plain text: grep it, diff it, review it, commit it, or ignore it. No telemetry, no cloud service, no lock-in.
This is how Factor VII: Extract Learnings and Factor VIII: Compound Knowledge are implemented in practice. The rule lives in the factor; the runtime artifact lives in the repo.