codebase-survey

codebase-survey is a skill for Claude Code, Codex from Simone-Tarantino/godot-superpowers. It costs 77 tokens per session (2,021 once invoked), scanned A, original, MIT.

A read-only survey of an existing Godot game project, mapping the scenes, scripts, shared startup systems, resources, and signals a proposed feature may affect. Godot is a game engine, and signals are its event notifications between objects.

In plain words
What is it for?
Use it before adding a non-trivial feature to an existing Godot project to document affected code, dependencies, risks, and relevant files.
Why use it?
It grounds feature planning in the project’s actual files and interfaces, reducing the risk of designing against assumptions.

Skill for Claude CodeCodex

Part of the godot-superpowers plugin — 33 skills, 15 agents, 4 hooks, 5 MCP servers 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/simone-tarantino/godot-superpowers/codebase-survey
Any agent
npx skills add Simone-Tarantino/godot-superpowers --skill codebase-survey
Clone the repo
git clone --depth 1 https://github.com/Simone-Tarantino/godot-superpowers

Made for: Claude Code, Codex.

Or install godot-superpowers, the plugin that ships this one along with the rest of its 33 skills, 15 agents, 4 hooks, 5 MCP servers.

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 codebase-survey

README.md
[![agentmods](https://agentmods.dev/badge/skills/simone-tarantino/godot-superpowers/codebase-survey.svg)](https://agentmods.dev/skills/simone-tarantino/godot-superpowers/codebase-survey)
Your own site
<a href="https://agentmods.dev/skills/simone-tarantino/godot-superpowers/codebase-survey"><img src="https://agentmods.dev/badge/skills/simone-tarantino/godot-superpowers/codebase-survey.svg" alt="Measured on agentmods" height="20"></a>
Per session 77 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,021 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.00077 $0.02021
Opus 5 $0.00039 $0.01010
Sonnet 5 $0.00015 $0.00404
Haiku 4.5 $0.00008 $0.00202

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

Security

Grade A, and why

codebase-survey 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/codebase-survey/SKILL.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Codebase Survey

Maps the parts of an existing Godot project that a planned feature will touch. Output anchors the downstream feature-spec and feature-plan to real files, real APIs, and real risks — not to memory or wishful thinking.

Core rule: read-only. This skill never edits .gd, .tscn, .tres, or .gdshader. It writes exactly one file: docs/features/<YYYY-MM-DD>-<slug>-survey.md.

When to invoke

  • A user asks to add / change / extend a feature on a project that already has code.
  • The change touches 2+ files OR 1+ autoload OR 1+ existing scene.
  • Before feature-spec — survey is the input the spec depends on.

Skip the survey for:

  • Trivial features under the shared shortcut: touches one file AND adds no new mechanic AND adds no new public surface (no new signal / exported var / autoload / input action). In that case, feature-spec records Survey reference: none (trivial shortcut) and feature-plan accepts the same string. Any of the three conditions failing makes the survey mandatory.
  • Greenfield projects (no code yet — use game-brainstorminggdd-writer instead).
  • Read-only investigations (use the Explore agent).

File path convention

  • Location: docs/features/
  • Filename: <YYYY-MM-DD>-<slug>-survey.md
    • Date is the day the survey is written.
    • Slug is kebab-case of the feature working title (e.g. 2026-05-12-double-jump-survey.md).
  • One survey per feature. When re-surveying after major project changes, write a NEW dated file rather than editing — keep the trail.
  • The matching feature-spec and feature-plan reuse the same <YYYY-MM-DD>-<slug> prefix:
    • docs/features/<YYYY-MM-DD>-<slug>-feature.md
    • docs/plans/<YYYY-MM-DD>-<slug>-feature-plan.md

Inputs

  • The user's feature description (one or two sentences is fine — survey expands it).
  • The existing project tree (project.godot, scenes/, scripts/, autoload/, resources/).
  • The latest GDD (docs/design/*-gdd.md) if one exists — link it so the spec inherits design pillars.

Read the full file on GitHub · 158 lines

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 · 158 lines · 77 tokens per session scan A 3df26e801230

Subscribe to this mod's changes

codebase-survey is a skill published in the GitHub repository Simone-Tarantino/godot-superpowers (2 stars, last pushed 4mo ago), licensed MIT. It adds 77 tokens to every session and 2,021 once invoked, about $0.0004 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

game-build-team

Build a Godot 4 / GDScript game feature with a coordinated agent team — a Manager (you), a Creative Director, a Logic Developer, an Animation Developer, and a Tester — that iteratively and autonomously design, build, juice, and verify the feature against the project's design contract to a strict, un-skippable quality…

Varalix-Digitech-Solutions/game-build-team-skill · 248 tokens

avatar-contribution-pr

Turn an avatar GitHub issue (from the in-app avatar-editor easter egg) into a merged sprite — validate the art, then either add a new module or replace an existing one, and open a PR that closes the issue. Handles both "Avatar contribution: " (a brand-new sprite) and "Avatar edit: " (a hand-redraw of an existing…

khromov/codebay · 0 tokens

yume-asset-designer

Visual + audio + UI-style designer for Yume games. Picks ONE consistent strategy per project (library lookup / AI-gen prompt / code-draw shape) for visuals; writes audio cue mappings and localized strings. Per ADR 0009 — owns audio/cues.json (semantic event → sound name) and ui/strings.json (localizable HUD text), in…

kamwoh/yume · 116 tokens

yume-design

Run the Yume text-to-game pipeline. Orchestrates 7 specialist skills (yume-game-designer → game-planner → systems-designer → content-designer → asset-designer → qa-tester, plus tech-director on demand) with optional user-approval gates. Skills load into orchestrator context (no subagent spawn — Tier 2.6 architecture).…

kamwoh/yume · 163 tokens

yume-content-designer

Entities + initial state designer for Yume games. Translates GDD + world plan into entity definitions (entities/.json), initial placements (per-level entities.json), and world initial state (world/state.json). Picks tag names, state field names, default values, positions. Per ADR 0009 — narrowed scope: rules are NOT…

kamwoh/yume · 116 tokens

yume-game-reviewer

Adversarial reviewer for Yume GDDs. Reads docs/games/ /GDD.md and applies critical-but-fair scrutiny across 15 depth axes (mechanical/strategic/pacing/feedback/aesthetic/scope/adversarial + total content scope, signature moments, theme/identity, replay value, real-UX, spatial-design/level-layout). Outputs review.md…

kamwoh/yume · 173 tokens