Skills

Use this section when you want to choose the right OAT skill for a task. If you are writing or changing skills, jump to the contributor docs instead.

Contents

• Writing Skills - Contributor guide to skill authoring, contracts, and governance.
• Docs Workflows - How docs CLI helpers and docs skills work together.

Key Skills by Use Case

• Start a new tracked project: oat-project-new or oat-project-quick-start (quick start accepts a project name plus optional description; if you omit the description it should ask before discovery begins)
• Resume an existing project: oat-project-open and oat-project-progress
• Execute a ready plan: oat-project-implement
• Import an existing plan: oat-project-import-plan
• Split a broad discovery or brainstorm into child projects: oat-project-split
• Retroactively capture existing work: oat-project-capture
• Run or receive reviews: oat-project-review-provide, oat-project-review-receive, or the non-project review variants
• Capture a scoped, shippable backlog item: oat-pjm-add-backlog-item directly when the work is already scoped, or oat-brainstorm when the thought hasn't converged yet — the brainstorm dispatcher's "scoped backlog item" destination pre-fills the title / description / acceptance criteria / scope estimate / priority from the conversation and then runs oat-pjm-add-backlog-item with confirmed inputs
• Manage the repo backlog and reference docs: oat-pjm-update-repo-reference, oat-pjm-review-backlog
• Work on docs surfaces: oat-docs-bootstrap (guided bootstrap of a new docs app), oat-docs-analyze, oat-docs-apply, and oat-project-document
• Generate a shipping digest or scheduled recap: oat-wrap-up
• Research a topic in depth: deep-research
• Analyze an artifact, codebase, or document: analyze
• Compare options with domain-aware dimensions: compare
• Verify a claim adversarially: skeptic
• Merge multiple analysis artifacts: synthesize
• Capture or refine ideas: oat-idea-new (capture a new idea), oat-idea-ideate (resume an existing tracked idea or expand a scratchpad seed — not for blank-slate brainstorms; use oat-brainstorm for those), oat-idea-scratchpad, oat-idea-summarize
• Run a project-independent brainstorming conversation: oat-brainstorm — entry point with an explicit activation contract. Hard Activation fires only on the brainstorm verb ("let's brainstorm", "brainstorm this", "can we brainstorm X", "help me brainstorm X", or /oat-brainstorm); ambiguous exploratory phrasing answers conversationally without the banner and offers structured mode only after sustained exploration. Once entered, runs a structured design conversation (one question at a time, 2-3 approaches with a recommendation) and routes to inline / doc-to-path / idea / backlog item / project handoffs based on installed packs. See Tool Packs for the brainstorm pack details.

If You Are Trying To...

• choose the right skill for a task, stay in this guide page
• write or update a skill, use Writing Skills
• understand how docs-specific skills fit with docs commands, use Docs Workflows

Full Catalog

Discovery Source

AGENTS.md is the session-facing registry. It should stay aligned with skill frontmatter and the canonical skill directories under .agents/skills/.

Legacy compatibility note: review-backlog and update-repo-reference may still exist in some environments, but prefer the oat-pjm-* family for the current file-backed backlog/reference workflow.