New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Ouroboros Session Status

by Q00 in Q00/ouroboros

Checks the state of an Ouroboros execution session and measures how far it has drifted from its original seed goal, using the Ouroboros MCP tools.

MITAuto-check passedAgent Workflows

Install Ouroboros Session Status

skills CLI
$ npx skills add Q00/ouroboros --skill ouroboros-status -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Q00/ouroboros ouroboros-status --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Q00/ouroboros.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/status .claude/skills/ouroboros-status && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ouroboros-status
GitHub stars
6.2k
Token cost
~1.1k tokens
SKILL.md length
451 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Checks the state of an Ouroboros execution session and measures how far it has drifted from its original seed goal, using the Ouroboros MCP tools.

  • Works in 2 steps: Session Status: Queries the current… → Drift Measurement: Measures how far the…
  • Checking whether an Ouroboros session is still running or has finished
  • SKILL.md covers Usage, How It Works, Instructions and Drift Thresholds, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill is a slash command, /ouroboros:ouroboros-status with an optional session ID, that reports on an Ouroboros execution session and can measure goal drift. It first loads the Ouroboros MCP tools, which are often registered as deferred tools and must be discovered before they can be called, and falls back to another path only when the MCP server is genuinely absent. It then takes the session ID from the argument or recent conversation, or asks you, and calls the session status tool.

If you ask about drift with a phrase such as am I drifting, it also calls the drift measurement tool. The reply shows running, completed or failed status and progress, plus the drift report when one was measured, with a warning and suggested actions when drift exceeds 0.3. It ends with a short state breadcrumb pointing to a next step, such as measuring drift or continuing with ooo run.

When your agent uses it

  • Checking whether an Ouroboros session is still running or has finished
  • Measuring how far execution has moved from the original goal
  • Deciding whether to correct course before continuing a run

Example prompts

  • “Show me the status of my Ouroboros session.”
  • “Am I drifting from the seed goal on this run?”
  • “Run a drift check on the session from earlier and tell me what to do if it is high.”

Requirements

  • The Ouroboros plugin and its MCP server

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Session Status: Queries the current state of an execution session
  2. Drift Measurement: Measures how far the execution has deviated from the original seed goal

What it can do on your machine

Read from SKILL.md and the folder at commit f587795. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ouroboros Session Status loads about 1.1k tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 451 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~15
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Q00/ouroboros at commit f587795, republished under its MIT licence (© Q00). 451 words, ~1,147 tokens.

Download SKILL.mdSave it as .claude/skills/ouroboros-status/SKILL.md (or your agent's skills folder).
name
ouroboros-status
description
Check session status and measure goal drift
aliases
drift
mcp_tool
ouroboros_session_status
mcp_args.session_id
$1

/ouroboros:ouroboros-status

Check session status and measure goal drift.

Usage

/ouroboros:ouroboros-status [session_id]

Trigger keywords: "am I drifting?", "session status", "drift check"

How It Works

  1. Session Status: Queries the current state of an execution session
  2. Drift Measurement: Measures how far the execution has deviated from the original seed goal

Instructions

When the user invokes this skill:

Load MCP Tools (Required first)

The Ouroboros MCP tools are often registered as deferred tools that must be explicitly loaded before use. You MUST perform this step before proceeding.

  1. Use the active runtime's tool-discovery capability to find and load the status MCP tools:
    tool discovery query: "+ouroboros session status"
  2. The tools will typically be named with prefix mcp__plugin_ouroboros_ouroboros__ (e.g., ouroboros_session_status, ouroboros_measure_drift). After runtime tool discovery returns, the tools become callable.
  3. If the tools are callable — already exposed, or loaded by discovery — proceed with the steps below. An empty discovery result for already-exposed tools is expected, not a failure. Skip to the Fallback section only if they are genuinely absent (no Ouroboros MCP server).

IMPORTANT: Do NOT skip this step. Do NOT assume MCP tools are unavailable just because they don't appear in your immediate tool list. They are almost always available as deferred tools that need to be loaded first.

Status Steps

  1. Determine the session to check:

    • If session_id provided: Use it directly
    • If no session_id: Check conversation for recent session IDs
    • If none found: Ask user for the session ID

  2. Call ouroboros_session_status MCP tool:

    Tool: ouroboros_session_status
Arguments:
  session_id: <session ID>

  3. If the user asks about drift (or says "am I drifting?"), also call ouroboros_measure_drift:

    Tool: ouroboros_measure_drift
Arguments:
  session_id: <session ID>
  current_output: <current execution output or file contents>
  seed_content: <original seed YAML>
  constraint_violations: []  (any known violations)
  current_concepts: []       (concepts in current output)

  4. Present results:

    • Show session status (running, completed, failed)
    • Show progress information
    • If drift measured, show the drift report
    • If drift exceeds threshold (0.3), warn and suggest actions
    • End with a state breadcrumb based on context:
      • No drift measured: ◆ Session active — say "am I drifting?" to measure drift, or continue with ooo run
      • Drift ≤ 0.3: ◆ On track — continue with ooo run or ooo evaluate when ready
      • Drift > 0.3: ◆ Significant drift detected → next: ooo interview to re-clarify, or ooo evolve to course-correct
Show full SKILL.md (117 more words)Show less

Drift Thresholds

Combined DriftStatusAction
0.0 - 0.15ExcellentOn track
0.15 - 0.30AcceptableMonitor closely
0.30+ExceededConsider consensus review or course correction

Fallback (No MCP Server)

If the MCP server is not available:

Session tracking requires the Ouroboros MCP server.
Run /ouroboros:setup to configure.

Without MCP, you can manually check drift by comparing
your current implementation against the seed specification.

Example

User: am I drifting?

Session: sess-abc-123
Status: running
Seed ID: seed-456
Messages Processed: 8

Drift Measurement Report
========================
Combined Drift: 0.12
Status: ACCEPTABLE

Component Breakdown:
  Goal Drift: 0.08 (50% weight)
  Constraint Drift: 0.10 (30% weight)
  Ontology Drift: 0.20 (20% weight)

You're on track. Goal alignment is strong.

◆ On track — continue with `ooo run` or `ooo evaluate` when ready

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.

© Q00, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/status of Q00/ouroboros.

Open the folder on GitHubat commit f587795

Compare with similar skills

Ouroboros Session Status next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ouroboros Session Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ouroboros Session Status this skillQ00/ouroboros6.2k—~1.1kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed

  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Warp GUI to Agent CLI Migration

    warpdotdev/warp

    Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.

    65k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed

More from Q00/ouroboros

All 23 skills in this repo

  • Ouroboros Maintainer Triage

    Q00/ouroboros

    Triages and works through GitHub issues and pull requests in the Q00/ouroboros repo as a maintainer, within a stated review boundary and clear limits on what it may change.

    6.2k GitHub stars~1.7k tokensUpdated 3 days ago
    Auto-check passed

  • Ouroboros PM Interview

    Q00/ouroboros

    Runs a guided product-manager interview that classifies each question automatically and produces a Product Requirements Document.

    6.2k GitHub stars~5.7k tokensUpdated 3 days ago
    Auto-check passed

  • Brownfield Repo Scanner

    Q00/ouroboros

    Scans a directory for existing git repositories and worktrees, then registers and manages which ones serve as default context during interviews.

    6.2k GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

  • Ouroboros Three-Stage Evaluate

    Q00/ouroboros

    Scores an agent's finished work with a three-stage pipeline: free mechanical checks, an advisory semantic review, and an optional multi-model consensus vote.

    6.2k GitHub stars~2.2k tokensUpdated 3 days ago
    Auto-check passed

  • Ouroboros Evolve Loop

    Q00/ouroboros

    Starts, monitors or rewinds an evolutionary development loop that refines an ontology and acceptance criteria generation by generation until it converges, using the Ouroboros MCP tools.

    6.2k GitHub stars~3.2k tokensUpdated 3 days ago
    Auto-check passed

  • Ouroboros Settings Opener

    Q00/ouroboros

    Opens or drives the Ouroboros settings GUI, picking a browser, TUI or chat-based approach depending on whether the user can reach a browser window.

    6.2k GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed

Works with

Categories

Questions about Ouroboros Session Status

What does Ouroboros Session Status do?

Checks the state of an Ouroboros execution session and measures how far it has drifted from its original seed goal, using the Ouroboros MCP tools. The skill is a slash command, /ouroboros:ouroboros-status with an optional session ID, that reports on an Ouroboros execution session and can measure goal drift. It first loads the Ouroboros MCP tools, which are often registered as deferred tools and must be discovered before they can be called, and falls back to another path only when the MCP server is genuinely absent.

When should I use Ouroboros Session Status?

Ouroboros Session Status fits situations like: checking whether an Ouroboros session is still running or has finished; measuring how far execution has moved from the original goal; deciding whether to correct course before continuing a run.

How do I install Ouroboros Session Status in Claude Code?

Run `npx skills add Q00/ouroboros --skill ouroboros-status -a claude-code`. Or copy the skill folder (skills/status in Q00/ouroboros) into .claude/skills/ouroboros-status in your project. Claude Code loads it when a task matches its description.

How do I install Ouroboros Session Status in Codex?

Run `npx skills add Q00/ouroboros --skill ouroboros-status -a codex`. Or copy the skill folder (skills/status in Q00/ouroboros) into .agents/skills/ouroboros-status in your project. Codex loads it when a task matches its description.

Can I use Ouroboros Session Status in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Q00/ouroboros --skill ouroboros-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ouroboros-status, .gemini/skills/ouroboros-status, .github/skills/ouroboros-status and .opencode/skills/ouroboros-status in your project.

What does Ouroboros Session Status need to run?

SKILL.md names no scripts, command-line tools or credentials: Ouroboros Session Status is instructions for the agent only. Our summary lists: The Ouroboros plugin and its MCP server.

Does Ouroboros Session Status access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ouroboros Session Status safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ouroboros Session Status use?

Ouroboros Session Status is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ouroboros Session Status use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ouroboros Session Status?

Skills that share tags, products or a category with Ouroboros Session Status: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Crush Configuration (charmbracelet/crush, 29k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ouroboros Session Status?

Q00 (a GitHub user) maintains it in Q00/ouroboros, which has 6,193 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 7, 2026.

Source: Q00/ouroboros on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.