ghost

ghost is a skill for Claude Code from rana/skills. It costs 41 tokens per session (396 once invoked), scanned A, original, MIT.

A project audit that searches for hidden assumptions and dependencies, such as required environment variables, services, ports, timing, data, or tools.

In plain words
What is it for?
Use it to inspect a codebase and its Markdown documents for implicit contracts, startup-order assumptions, missing configuration, external services, and undocumented build or data requirements.
Why use it?
It exposes requirements that may be understood by the original team but are undocumented and could cause failures during building, deployment, or overnight operation.

Skill for Claude Code

Written for Claude Code: argument-hint in frontmatter.

Part of the y plugin — 64 skills, 14 commands, 8 agents shipped together

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/rana/skills/ghost
Any agent
npx skills add rana/skills --skill ghost
Clone the repo
git clone --depth 1 https://github.com/rana/skills

Made for: Claude Code.

Or install y, the plugin that ships this one along with the rest of its 64 skills, 14 commands, 8 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ghost

README.md
[![agentmods](https://agentmods.dev/badge/skills/rana/skills/ghost.svg)](https://agentmods.dev/skills/rana/skills/ghost)
Your own site
<a href="https://agentmods.dev/skills/rana/skills/ghost"><img src="https://agentmods.dev/badge/skills/rana/skills/ghost.svg" alt="Measured on agentmods" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 396 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.1 $0.00041 $0.00396
Opus 5 $0.00020 $0.00198
Sonnet 5 $0.00008 $0.00079
Haiku 4.5 $0.00004 $0.00040

Measured 5d ago against content hash bc64b890a9ad, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

ghost 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 5d ago.

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/ghost/SKILL.md · 38 lines

What it actually says

Read all project markdown documents and examine the codebase to ground in the project's actual state.

Ghost Dependency Audit

Systematically surface the invisible substrate:

  1. Environment assumptions — Variables read but not documented, config files expected but not templated, paths assumed to exist, permissions required but unspecified.
  2. Service dependencies — External services called without explicit documentation. DNS entries assumed. Ports expected to be open. Health checks missing.
  3. Timing assumptions — Operations that assume ordering but don't enforce it. Race conditions waiting to happen. Startup sequences that depend on undocumented timing.
  4. Implicit contracts — Module boundaries where the interface is convention rather than code. Data formats assumed but not validated. Error handling that assumes specific upstream behavior.
  5. Build & deploy assumptions — Tools expected to be installed. Versions assumed. Build order dependencies. Network access during build.
  6. Data assumptions — Seed data expected. Migration order dependencies. Schema assumptions not enforced by constraints. Encoding assumptions.
  7. Human assumptions — Knowledge required but not documented. Procedures that exist only in someone's head. Tribal knowledge.

Focus area: $ARGUMENTS

For every ghost dependency found:

  1. What the assumption is (specific)
  2. Where it lives in the code or process
  3. What happens when the assumption is violated
  4. How to make it explicit (document, validate, or enforce)

Present as an action list. No changes to files — document only.

Output

Order findings by "what breaks at 2am" severity. State the total count when complete.

What questions would I benefit from asking?

What am I not asking?

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. 5d ago First seen · 38 lines · 41 tokens per session scan A bc64b890a9ad

Subscribe to this mod's changes

ghost is a skill published in the GitHub repository rana/skills (1 stars, last pushed 5mo ago), licensed MIT. It adds 41 tokens to every session and 396 once invoked, about $0.0002 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-31.

Related

Other skills, from other repositories

skill-audit

Audit codebases for quality, consistency, and broken patterns — use for pre-release or tech debt review.

nyldn/claude-octopus · 24 tokens

critical-code-reviewer

Rigorously review code or pull requests for correctness, security, accessibility, maintainability, tests, and edge cases. Use when users request a critical code review, want a guided walkthrough of findings, need implementer-facing feedback, or want to prepare, create, or submit a GitHub pull request review.

posit-dev/skills · 67 tokens

brooks-sweep

Full-sweep mode: runs a unified analysis across all quality dimensions — code decay, architecture, tech debt, and test quality — then applies fixes directly to the codebase. Safe changes are auto-applied; risky changes are confirmed before execution. Drawing on twelve classic engineering books. Triggers when: user…

hyhmrright/brooks-lint · 178 tokens

second-pass-review

Independent audit of sanitized specs in workspace/output/. Three parallel LLM-based reviewer roles check structural leakage, content contamination, and behavioral completeness. Run AFTER Layer 5 sanitization, BEFORE implementation handoff.

prime-radiant-inc/greenfield · 44 tokens

codex-review

Get an independent code review from OpenAI Codex (GPT-5) on uncommitted changes, a branch diff, a PR, or a specific module — returns findings grouped by severity with file:line references. Use when the user says "review this", "review my changes", "check this PR", "what did I miss", or before they commit or merge…

Sateezg/codex-bridge · 78 tokens

check-pr

Read-only inspection of a single GitHub PR lifecycle — checks CI, review threads, description sync, and mergeability, and returns PASS or FAIL with per-gate findings. Never invokes the merge button. Use when verifying a PR is ready to merge, polling lifecycle progress, checking mergeability, or babysitting a GitHub PR…

doodledood/manifest-dev · 74 tokens