ouroboros-help

A reference guide for Ouroboros, a tool that turns unclear ideas into checked specifications for AI workflows.

In plain words
What is it for?
Use it to learn Ouroboros commands such as interviews, seed creation, evaluation, status checks, setup, and lateral-thinking exercises.
Why use it?
It helps users choose the right command for clarifying requirements, creating specifications, running workflows, checking results, and continuing sessions.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/q00/ouroboros/help
Any agent
npx skills add Q00/ouroboros --skill help
Clone the repo
git clone --depth 1 https://github.com/Q00/ouroboros

Made for: Claude Code, Codex.

Per session 15 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,746 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00015 $0.01746
Opus 5 $0.00008 $0.00873
Sonnet 5 $0.00003 $0.00349
Haiku 4.5 $0.00002 $0.00175

Measured today against content hash c865ef3022b7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ouroboros-help scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/help/SKILL.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/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:

  1. Socratic Interview - Exposes hidden assumptions
  2. Seed Generation - Creates immutable specifications
  3. PAL Routing - Auto-escalates/descends model complexity
  4. Lateral Thinking - 5 personas to break stagnation
  5. 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

Read the full file on GitHub · 158 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +12 lines c865ef3022b7
  2. 3d ago First seen · 146 lines · 15 tokens per session scan A a3a42d7fb533

Subscribe to this mod's changes

ouroboros-help is a skill published in the GitHub repository Q00/ouroboros (5,747 stars, last pushed yesterday), licensed MIT. It adds 15 tokens to every session and 1,746 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.