Agent skill

Ghost Exo

by ghostsecurity in ghostsecurity/skills

The single interface for building, improving, and debugging exo workflows.

Apache-2.0Auto-check passedDevelopment

Install Ghost Exo

skills CLI
$ npx skills add ghostsecurity/skills --skill ghost-exo -a claude-code

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

GitHub CLI
$ gh skill install ghostsecurity/skills ghost-exo --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/ghostsecurity/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/exo/skills/exo .claude/skills/ghost-exo && 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
ghost-exo
GitHub stars
408
Token cost
~1.3k tokens
SKILL.md length
656 words
Files
10 (incl. scripts)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

The single interface for building, improving, and debugging exo workflows.

  • The user wants to create a new exo workflow
  • SKILL.md covers Prerequisites, Pick the connection, Always read first and Classify the intent, plus 2 more sections
  • Runs Python scripts from its folder; needs EXO_API_KEY
  • Improve an existing one

What it does

Ghost Exo is an agent skill from ghostsecurity/skills. The single interface for building, improving, and debugging exo workflows. Routes to one of three intents. BUILD takes a rough idea, or an agent template slug from the ghostsecurity.ai catalog, through interrogation, assessment, resource creation in dependency order, and one manual run, then hands off. IMPROVE runs the observe-and-iterate loop over recent runs, proposing and applying changes behind two gates. DEBUG diagnoses one failed or misbehaving run by walking the dependency graph of everything it touched…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts (for example `agents/openai.yaml`, `intents/build.md` and `intents/debug.md`).

It sits in Development, covering Debugging. It works with Model Context Protocol. The repository describes itself as: Ghost Security's collection of AppSec skills for AI coding agents. The licence is Apache-2.0.

When your agent uses it

  • The user wants to create a new exo workflow
  • Improve an existing one
  • Find out why a specific run failed

Example prompts

  • “/ghost-exo”

Requirements

  • Python 3
  • A credential in EXO_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 25fdf06. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    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 these keys or tokens, usually read from environment variables:

    • EXO_API_KEY

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

Context cost

Ghost Exo loads about 1.3k tokens when it runs. Until then it costs about 166 tokens; SKILL.md has 656 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from ghostsecurity/skills at commit 25fdf06, republished under its Apache-2.0 licence (© ghostsecurity). 656 words, ~1,262 tokens.

Download SKILL.mdSave it as .claude/skills/ghost-exo/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
ghost-exo
description
The single interface for building, improving, and debugging exo workflows. Routes to one of three intents. BUILD takes a rough idea, or an agent template slug from the ghostsecurity.ai catalog, through interrogation, assessment, resource creation in dependency order, and one manual run, then hands off. IMPROVE runs the observe-and-iterate loop over recent runs, proposing and applying changes behind two gates. DEBUG diagnoses one failed or misbehaving run by walking the dependency graph of everything it touched. Use whenever the user wants to create a new exo workflow, iterate on or improve an existing one, or find out why a specific run failed.
license
apache-2.0
metadata.version
1.2.0

exo

One front door for the exo workflow lifecycle. This skill is a router. It classifies the request into one of three intents, loads the shared substrate, then loads the matching intent recipe and follows it.

Prerequisites

Exo is an agent workflow platform. Every intent drives it through an exo MCP server.

Pick the connection

Several exo connections coexist normally, one per workspace, sometimes several on one deployment. Enumerate the exo MCP servers this session has before doing anything else.

With exactly one, use it. With more than one, ask which through the structured question tool and stop until the user answers, because a wrong guess writes to the wrong workspace. Do not switch connections partway through an intent. Start over if the target changes.

Call whoami on the chosen server. It confirms the connection and returns the workspace ID. Report that ID so the user can see which workspace they are about to change. If no exo MCP tools are present or whoami fails, read resources/bootstrap.md and follow it, then call whoami again. Do not classify an intent until it succeeds.

scripts/exo-skill.py reaches the same workspace over REST, and it has to reach the same one. It reads EXO_API_URL, EXO_API_KEY, and EXO_WORKSPACE_ID from the process environment, falling back to the profile named by --profile, which is the file ${XDG_CONFIG_HOME:-~/.config}/exo/<name>.env. Pass --profile with the name of the MCP server you chose on every call, so the two cannot point at different workspaces.

Always read first

Read resources/common.md. It holds the shared substrate every intent uses: the run-walking read primitives, the worker capability rules that decide which tools a skill may use and how it declares them, the DTO discovery discipline, the resource write primitives, the runtime contract for output, metrics, completion, and memory that every step runs under, the unprobeable nodes, and the note on why the improve intent reads the debug recipe inline rather than invoking it.

Classify the intent

If the request is aboutIntentRead
Why a specific run failed, what went wrong with a run_id, diagnosing one rundebugintents/debug.md
Improving, iterating on, tightening, or speeding up an existing workflow over its recent runsimproveintents/improve.md
Turning an idea into a new workflow, building, creating, or scaffolding a workflow, or building from an agent template slugbuildintents/build.md

Pick exactly one. If the request is genuinely ambiguous between intents, ask the user which one in a single question rather than guessing.

Show full SKILL.md (251 more words)Show less

User interaction

Put every question to the user through the harness's structured question tool, whatever it is called here. Free-text prose questions with bullet lists or "Q1/Q2/Q3" prompts are not allowed, even when the question feels open-ended. Bucket open areas into concrete options and let the user type a custom answer instead. Batch related questions into one call so the user answers a structured form rather than a thread of replies. Respect the current limits of the tool you have, and ask directly in prose only when no structured tool is available or the answer is inherently free-form, such as a name, a metric, or a path. This applies to intent disambiguation, the build interrogation in intents/build.md, the proposal and rerun gates in intents/improve.md, and any candidate-disambiguation prompt in intents/debug.md.

Require an explicit answer at every approval, production write, credential, and rerun gate. Never attach auto-resolution to those questions.

The boundaries between intents are intentional gates, not friction to remove. A build that ends in a first run does not auto-continue into improve, because the user owns when to cross from constructing to iterating. An improve pass that finds a failed run reads the debug walk inline rather than switching intents, because the diagnosis is a sub-procedure of the loop, not a separate request.

Paths

All paths in the intent files are relative to this skill's root directory: scripts/ for executables, resources/ for shared docs and templates, intents/ for the three recipes. agents/ holds per-harness interface metadata that no recipe reads.

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

Files

SKILL.md and 9 other files (scripts) in plugins/exo/skills/exo of ghostsecurity/skills.

  • SKILL.md
  • agents/openai.yaml
  • intents/build.md
  • intents/debug.md
  • intents/improve.md
  • resources/blueprint.template.md
  • resources/bootstrap.md
  • resources/common.md
  • resources/workflow-assessment.md
  • scripts/exo-skill.py

Open the folder on GitHubat commit 25fdf06

Compare with similar skills

Ghost Exo 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.

Ghost Exo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ghost Exo this skillghostsecurity/skills408—~1.3kAutomated safety check: PassApache-2.0
Debugging Executionsn8n-io/n8n207k—~2.6kAutomated safety check: PassCustom licence
LangBot Plugin Developmentlangbot-app/LangBot18k—~3.9kAutomated safety check: PassApache-2.0
Graph-Based Bug Tracingtirth8205/code-review-graph32k1 repos~287Automated safety check: PassMIT
Extension Puppeteer Debuggingmengxi-ream/read-frog10k—~2kAutomated safety check: NotesGPL-3.0
Octocode Code Researchbgauryy/octocode949—~1.5kAutomated safety check: PassMIT

Similar skills

  • Official

    Debug failed or wrong-output workflow executions using executions tools.

    207k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • LangBot Plugin Development

    langbot-app/LangBot

    Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.

    18k GitHub stars~3.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Graph-Based Bug Tracing

    tirth8205/code-review-graph

    Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.

    32k GitHub starsUsed in 1 repo~287 tokens
    DevelopmentAuto-check passed
  • Extension Puppeteer Debugging

    mengxi-ream/read-frog

    Debug the built Read Frog extension in real Chrome. An agent skill from mengxi-ream/read-frog.

    10k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check: notes
  • Octocode Code Research

    bgauryy/octocode

    Researches code with evidence: traces callers, imports and cross-repo links, diagnoses failures and reports findings with exact file and line references and a confidence label.

    949 GitHub stars~1.5k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • LinkedIn MCP Issue Investigator

    stickerdaniel/linkedin-mcp-server

    Investigates a reported LinkedIn-MCP issue by matching the reporter's tool call to the exact source file and tests, without applying a fix.

    3.8k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from ghostsecurity/skills

  • Ghost Repo Context

    ghostsecurity/skills

    Scans directory structure, detects projects, maps dependencies, and documents code organization into a repo.md file.

    408 GitHub stars~786 tokensUpdated 9 days ago
    Auto-check: notes
  • Ghost Report

    ghostsecurity/skills

    Ghost Security — combined security report. An agent skill from ghostsecurity/skills.

    408 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check: notes
  • Ghost Scan Deps

    ghostsecurity/skills

    Ghost Security - Software Composition Analysis (SCA) scanner.

    408 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check: notes
  • Ghost Scan Secrets

    ghostsecurity/skills

    Ghost Security - Secrets and credentials scanner. An agent skill from ghostsecurity/skills.

    408 GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check: notes

Categories

Questions about Ghost Exo

What does Ghost Exo do?

The single interface for building, improving, and debugging exo workflows. Ghost Exo is an agent skill from ghostsecurity/skills. The single interface for building, improving, and debugging exo workflows.

When should I use Ghost Exo?

Ghost Exo fits situations like: the user wants to create a new exo workflow; improve an existing one; find out why a specific run failed.

How do I install Ghost Exo in Claude Code?

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

How do I install Ghost Exo in Codex?

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

Can I use Ghost Exo 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 ghostsecurity/skills --skill ghost-exo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ghost-exo, .gemini/skills/ghost-exo, .github/skills/ghost-exo and .opencode/skills/ghost-exo in your project.

What does Ghost Exo need to run?

Going by SKILL.md and its folder, Ghost Exo needs Python for the scripts in its folder and credentials named EXO_API_KEY. Our summary lists: Python 3; A credential in EXO_API_KEY.

Does Ghost Exo 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 Ghost Exo 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ghost Exo use?

Ghost Exo is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ghost Exo use?

About 1.3k tokens (SKILL.md is roughly 5k 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 Ghost Exo?

Skills that share tags, products or a category with Ghost Exo: Debugging Executions (n8n-io/n8n, 207k stars), LangBot Plugin Development (langbot-app/LangBot, 18k stars), Graph-Based Bug Tracing (tirth8205/code-review-graph, 32k stars) and Extension Puppeteer Debugging (mengxi-ream/read-frog, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ghost Exo?

ghostsecurity (a GitHub organization) maintains it in ghostsecurity/skills, which has 408 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 28, 2026.

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