# ooo

ooo drives spec-first development: clarifies requirements against live git history, freezes an immutable seed, and runs execution loops until test verification passes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 300 installs · ★ 61 repo stars
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/ooo/SKILL.md
- Updated: 2026-11-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ooo

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill ooo -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ooo/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ooo/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill ooo -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ooo/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill ooo -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ooo/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/ooo/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/ooo/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill ooo -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/ooo
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ooo/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill ooo -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/ooo/SKILL.md

## When to use it
- 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
- 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

## Similar
- [speckit-git-remote](https://affpapa.org/en/nevibecode/skills/speckit-git-remote.md) — skill · ★ 110 repo stars
- [speckit-git-feature](https://affpapa.org/en/nevibecode/skills/speckit-git-feature.md) — skill · ★ 110 repo stars
- [speckit-plan](https://affpapa.org/en/nevibecode/skills/speckit-plan.md) — skill · 2600 installs
- [speckit-implement](https://affpapa.org/en/nevibecode/skills/speckit-implement.md) — skill · 2500 installs
- [speckit.optimize](https://affpapa.org/en/nevibecode/commands/speckitoptimize.md) — command · ★ 372 repo stars
- [cli-anything-hermes](https://affpapa.org/en/nevibecode/skills/cli-anything-hermes.md) — skill · 314 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 99 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
