At a glance
What it does
Look up Ouroboros commands and agents for turning unclear ideas into validated specifications and running their workflows.
Before you choose it
This reference skill explains the Ouroboros command set, matching natural-language triggers, available agents, and setup. It covers interviewing to clarify requirements, generating immutable Seed specifications, executing and evaluating workflows, handling stalled work, and evolutionary loops.
Best for
Ouroboros users who need a command reference or want to choose the right requirement-clarification, specification, evaluation, or workflow command.
Common tasks
- Find the command to run a Socratic interview or generate a Seed specification.
- Identify the right command when an execution is stuck, a session must be resumed, or workflow results need evaluation.
- Learn which Ouroboros agent or loop fits requirement refinement and iterative convergence.
Permissions and data
The supplied guide describes local setup and MCP-backed commands but does not enumerate permissions or data handling.
Permissions- MCP-backed features require running `ooo setup` once.
- Data collection, retention, and sharing practices are not described in the supplied skill document.
- The guide mentions publishing Seed specifications as GitHub Issues.
- Credential requirements are not described in the supplied evidence.
Limitations
- This is a reference guide, not the Ouroboros runtime or installer.
- Several commands require one-time setup to register the MCP server; the guide says this unlocks all features.
- The supplied license disclaims warranties.
What DSHub checked
- The pinned skill document contains command, agent, trigger, and setup guidance.
- The source is pinned to a specific Git commit.
- An MIT license was detected.
What DSHub did not check
- DSHub did not install, run, or test this skill or its referenced commands.
- Runtime compatibility beyond the setup note is not declared.
Pinned install
Primary action
This standalone skill does not have a DSH Plugin install action. Use its source documentation for the delivery method.
Maintainer source
Skill instructions
name: ouroboros-help description: "Full reference guide for Ouroboros commands and agents"
/ouroboros:ouroboros-help
Full reference guide for Ouroboros power users.
Usage
ooo help
/ouroboros:ouroboros-help
What Is Ouroboros?
Ouroboros is a requirement crystallization engine for AI workflows. It transforms vague ideas into validated specifications through:
- Socratic Interview - Exposes hidden assumptions
- Seed Generation - Creates immutable specifications
- PAL Routing - Auto-escalates/descends model complexity
- Lateral Thinking - 5 personas to break stagnation
- 3-Stage Evaluation - Mechanical > Semantic > Consensus
All Commands
Core Commands
| Command | Purpose | Mode |
|---|---|---|
ooo |
Welcome + quick start | Plugin |
ooo interview |
Socratic requirement clarification | Plugin |
ooo seed |
Generate validated seed spec | Plugin |
ooo run |
Execute seed workflow | MCP |
ooo evaluate |
3-stage verification | MCP |
ooo unstuck |
5 lateral thinking personas | Plugin |
ooo status |
Session status + drift check | MCP |
ooo resume-session |
List in-flight sessions and re-attach commands | CLI |
ooo setup |
Installation wizard | Plugin |
ooo config |
Settings GUI — per-stage agents & models (browser here, TUI in a terminal) | CLI |
ooo welcome |
First-touch welcome guide | Plugin |
ooo tutorial |
Interactive hands-on learning | Plugin |
ooo help |
This reference guide | Plugin |
ooo pm |
PM-focused interview + PRD generation | MCP |
ooo qa |
General-purpose QA verdict for any artifact | Plugin |
ooo cancel |
Cancel stuck or orphaned executions | CLI |
ooo update |
Check for updates + upgrade to latest | Plugin |
ooo brownfield |
Scan and manage brownfield repo defaults | MCP |
ooo publish |
Publish Seed as GitHub Issues for teams | Plugin |
Evolutionary Loop
| Command | Purpose | Mode |
|---|---|---|
ooo evolve |
Start/monitor evolutionary development loop | MCP |
ooo ralph |
Client-driven loop until verified (uses background evolve_step jobs) | Plugin + MCP |
Plugin = Works immediately after ooo setup.
MCP = Requires ooo setup (Python >= 3.12 auto-detected). Run setup once to unlock all features.
Natural Language Triggers
| Phrase | Triggers |
|---|---|
| "interview me", "clarify requirements", "socratic interview" | ooo interview |
| "crystallize", "generate seed", "create seed", "freeze requirements" | ooo seed |
| "ouroboros run", "execute seed", "run seed", "run workflow" | ooo run |
| "evaluate this", "3-stage check", "verify execution" | ooo evaluate |
| "think sideways", "i'm stuck", "break through", "lateral thinking" | ooo unstuck |
| "am I drifting?", "drift check", "session status" | ooo status |
Utility Triggers
| Phrase | Triggers |
|---|---|
| "write prd", "pm interview", "product requirements", "create prd" | ooo pm |
| "qa check", "quality check" | ooo qa |
| "cancel execution", "stop job", "kill stuck", "abort execution" | ooo cancel |
| "in-flight sessions", "mcp disconnected", "lost Ouroboros execution" | ooo resume-session |
| "update ouroboros", "upgrade ouroboros" | ooo update |
| "open settings", "change model", "change agent", "configure backend" | ooo config |
| "brownfield defaults", "brownfield scan" | ooo brownfield |
| "publish to github", "create issues from seed", "seed to issues" | ooo publish |
Loop Triggers
| Phrase | Triggers |
|---|---|
| "ralph", "don't stop", "must complete", "until it works", "keep going" | ooo ralph |
| "evolve", "evolutionary loop", "iterate until converged" | ooo evolve |
Available Skills
Core Skills
| Skill | Purpose | Mode |
|---|---|---|
/ouroboros:welcome |
First-touch welcome experience | Plugin |
/ouroboros:interview |
Socratic requirement clarification | Plugin |
/ouroboros:seed |
Generate validated seed spec | Plugin |
/ouroboros:ouroboros-run |
Execute seed workflow | MCP |
/ouroboros:evaluate |
3-stage verification | MCP |
/ouroboros:unstuck |
5 lateral thinking personas | Plugin |
/ouroboros:ouroboros-status |
Session status + drift check | MCP |
/ouroboros:resume-session |
List in-flight sessions and re-attach commands | CLI |
/ouroboros:setup |
Installation wizard | Plugin |
/ouroboros:tutorial |
Interactive hands-on learning | Plugin |
/ouroboros:ouroboros-config |
Settings GUI | Plugin |
/ouroboros:ouroboros-help |
This guide | Plugin |
/ouroboros:pm |
PM-focused interview + PRD generation | MCP |
/ouroboros:qa |
General-purpose QA verdict for any artifact | Plugin |
/ouroboros:cancel |
Cancel stuck or orphaned executions | CLI |
/ouroboros:update |
Check for updates + upgrade to latest | Plugin |
/ouroboros:brownfield |
Scan and manage brownfield repo defaults | MCP |
/ouroboros:publish |
Publish Seed as GitHub Issues for teams | Plugin |
Loop Skills
| Skill | Purpose | Best For |
|---|---|---|
/ouroboros:ralph |
Client-driven loop over background evolve_step jobs | "Don't stop", must complete |
/ouroboros:evolve |
Evolutionary ontology refinement | Spec iteration until convergence |
Available Agents
| Agent | Purpose |
|---|---|
ouroboros:socratic-interviewer |
Exposes hidden assumptions through questioning |
ouroboros:ontologist |
Finds root problems vs symptoms |
ouroboros:seed-architect |
Crystallizes requirements into seed specs |
ouroboros:evaluator |
Three-stage verification |
ouroboros:contrarian |
"Are we solving the wrong problem?" |
ouroboros:hacker |
"Make it work first, elegance later" |
ouroboros:simplifier |
"Cut scope to absolute minimum" |
ouroboros:researcher |
"Stop coding, start investigating" |
ouroboros:architect |
"Question the foundation, redesign if needed" |
Setup
After installing Ouroboros, run ooo setup once to register the MCP server.
This connects your runtime backend to the Ouroboros Python core and unlocks all features.
ooo setup # One-time setup (~1 minute)
RFC #1392 State Breadcrumb Footer
Your final response MUST end with exactly one breadcrumb footer line:
◆ <current state> → next: <recommended action>
Derive <current state> from live session state via ouroboros_session_status when that MCP projection is available; otherwise derive it from this skill's actual outcome. Never use a linear Step N of M footer because Ouroboros is an evolutionary loop. When the next action is genuinely a choice, list 2-3 honest options in the next: clause. The breadcrumb line must be the last line of the response.
Operate deliberately
Install and manage
Prerequisites and target Profile
Target： Codex Profile
Delivery： Skill Files — https://raw.githubusercontent.com/Q00/ouroboros/03714ba446186423dcb46e25d12bd19c3a2e82f6/skills/help/SKILL.md。
Compatibility and access
Requires Ouroboros setup for MCP Backed commands： Not declared in supplied evidence。
Review compatibility evidence ↗
Risk facts
MIT licensed; provided without warranty.
Evidence ↗Evidence and editorial reviewManifest, Bundle patch, distribution and freshness
Immutable evidence
Review status and source activity
Approved for publication after reviewing the source-linked content and immutable release record. AI assisted with the draft; the publication decision was human.
Human reviewed Sep 5, 2026, 5:17 PM UTC。GitHub facts last checked Sep 5, 2026, 4:31 PM UTC。
No material source change has been recorded since this evidence baseline.