ooo — Claude Code skill: what it does, how to install
ooo drives spec-first development: clarifies requirements against live git history, freezes an immutable seed, and runs execution loops until test verification passes.
no license 300 installs ★ 61 updated 2026-11-19
npx skills add akillness/jeo-skills --skill ooo -a claude-codeWhat ooo does
The workflow begins with a Socratic interview weighted by active repository metrics. It extracts commit logs, code churn, and author data into .ouroboros/interview-context.md before locking down the seed contract. Then spec-kit generates the task breakdown using /speckit.plan and /speckit.tasks.
Execution runs software through cli-anything CLI-Hub harnesses instead of raw shell commands. Each step expects --json output, using structured artifacts to verify criteria before accepting completion.
Running the account-model-setup.py helper requires the explicit Python binary from the environment where ouroboros-ai is installed. Using the default system interpreter fails because discovery modules will be missing.
What it helps with
- ground requirements gathering in live git churn and commit history
- freeze immutable specifications to avoid project drift
- turn frozen seeds into task breakdowns with spec-kit
- validate CLI execution artifacts with structured json outputs
- maintain an automated test-verification loop until all checks pass
Example prompts for the agent
- Run ooo to interview me on the latest git changes and define the seed
- Generate the spec-kit execution plan and tasks for this milestone
- ooo ralph: loop implementation until tests pass and output matches criteria
How to install ooo
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill ooo -a claude-code2Manually: put the files in place
~/.claude/skills/ooo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ooo/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill ooo -a codex2Manually: put the files in place
.agents/skills/ooo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill ooo -a cursor2Manually: put the files in place
.cursor/skills/ooo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install akillness/jeo-skills .agent-skills/ooo/SKILL.md2Manually: put the files in place
.github/skills/ooo/SKILL.md1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill ooo -a gemini-cli2Platform CLI
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/oooManually: put the files in place
.devin/skills/ooo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill ooo -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ooo
How to install ooo in Claude Code?
Run npx skills add akillness/jeo-skills --skill ooo -a claude-code. The skill installs into ~/.claude/skills/ooo/SKILL.md.
What does ooo do during the interview phase?
It generates .ouroboros/interview-context.md from working tree status, commit history, and code churn. The interview then uses this data to clarify ambiguity before drafting the specification.
Which Python binary is required for model setup?
The helper script needs the exact Python executable from the virtual environment where ouroboros-ai was installed. Pointing to the system PATH interpreter triggers import errors.