help
Scannednpx machina-cli add skill Q00/ouroboros/help --openclawFiles (1)
SKILL.md
4.2 KB
/ouroboros:help
Full reference guide for Ouroboros power users.
Usage
ooo help
/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 setup | Installation wizard | Plugin |
ooo welcome | First-touch welcome guide | Plugin |
ooo tutorial | Interactive hands-on learning | Plugin |
ooo help | This reference guide | Plugin |
Evolutionary Loop
| Command | Purpose | Mode |
|---|---|---|
ooo evolve | Start/monitor evolutionary development loop | MCP |
ooo ralph | Self-referential loop until verified ("don't stop") | Plugin + MCP |
Plugin = Works immediately after ooo setup.
MCP = Requires ooo setup (Python 3.14+ 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 |
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:run | Execute seed workflow | MCP |
/ouroboros:evaluate | 3-stage verification | MCP |
/ouroboros:unstuck | 5 lateral thinking personas | Plugin |
/ouroboros:status | Session status + drift check | MCP |
/ouroboros:setup | Installation wizard | Plugin |
/ouroboros:tutorial | Interactive hands-on learning | Plugin |
/ouroboros:help | This guide | Plugin |
Loop Skills
| Skill | Purpose | Best For |
|---|---|---|
/ouroboros:ralph | Self-referential loop until verified | "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 the plugin, run ooo setup once to register the MCP server.
This connects Claude Code to the Ouroboros Python core and unlocks all features.
ooo setup # One-time setup (~1 minute)
Overview
Full reference guide for Ouroboros commands and agents. It covers core commands, evolutionary loop tools, and natural-language triggers that map to actions. This guide helps power users quickly navigate the command set and agent roles to crystallize requirements.
How This Skill Works
The guide inventories available commands and agents, clarifies their operational modes (Plugin or MCP), and shows how natural language phrases map to specific commands. It centers Ouroboros on Socratic Interview, Seed Generation, PAL Routing, Lateral Thinking, and 3-Stage Evaluation to transform ideas into validated specifications.
When to Use It
- When you need a quick, authoritative reference for Ouroboros commands and agents
- During onboarding to learn the core commands (ooo, seed, run, evaluate, etc.) and their modes
- When you want to translate natural-language prompts into concrete actions using triggers like 'interview me' or 'crystallize'
- While debugging a workflow to confirm command behavior and agent roles (Plugin vs MCP)
- When exploring available agents to select the right assistant for your task
Quick Start
- Step 1: Open the guide with 'ooo help' or '/ouroboros:help'.
- Step 2: Browse core commands (ooo, interview, seed, run, evaluate, unstuck, status, setup, tutorial, help) and their Mode.
- Step 3: Test a trigger phrase such as 'interview me' or 'crystallize' to see how language maps to actions.
Best Practices
- Start with the /ouroboros:help reference to orient yourself before executing tasks
- Familiarize yourself with core commands and their modes (Plugin vs MCP) to avoid feature gaps
- Use natural-language triggers to experiment quickly and validate mappings to commands
- Consult the 3-stage verification (Mechanical > Semantic > Consensus) when evaluating results
- Review the list of available agents (e.g., socratic-interviewer, seed-architect, evaluator) to pick the best fit
Example Use Cases
- A user runs /ouroboros:seed to crystallize requirements into a seed spec for a new AI workflow
- A team uses 'interview me' to start a Socratic clarification via ooo interview
- An engineer runs 'evaluate' to perform 3-stage verification of outputs
- A developer triggers /ouroboros:run to execute a seed workflow in MCP mode
- An analyst consults /ouroboros:help to understand available agents like socratic-interviewer and seed-architect
Frequently Asked Questions
Add this skill to your agents
