agent-explain-codebase

agent-explain-codebase is a command for Claude Code from Amey-Thakur/AI-SKILLS. It costs 25 tokens per session (424 once invoked), scanned A, original, MIT.

A command that maps an unfamiliar software project and explains how its parts fit together. It bases the explanation on the actual files and code.

In plain words
What is it for?
Use it before making changes to understand the project structure, follow a feature through the code, or locate the right files to edit.
Why use it?
It reduces the time needed to find entry points, trace a feature, learn project conventions, and spot fragile areas.

Command for Claude Code

Written for Claude Code: argument-hint in frontmatter.

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 commands/amey-thakur/ai-skills/agent-explain-codebase
Clone the repo
git clone --depth 1 https://github.com/Amey-Thakur/AI-SKILLS

Made for: Claude Code.

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 agent-explain-codebase

README.md
[![agentmods](https://agentmods.dev/badge/commands/amey-thakur/ai-skills/agent-explain-codebase.svg)](https://agentmods.dev/commands/amey-thakur/ai-skills/agent-explain-codebase)
Your own site
<a href="https://agentmods.dev/commands/amey-thakur/ai-skills/agent-explain-codebase"><img src="https://agentmods.dev/badge/commands/amey-thakur/ai-skills/agent-explain-codebase.svg" alt="Measured on agentmods" height="20"></a>
Per session 25 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 424 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.00025 $0.00424
Opus 5 $0.00013 $0.00212
Sonnet 5 $0.00005 $0.00085
Haiku 4.5 $0.00003 $0.00042

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

Security

Grade A, and why

agent-explain-codebase 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 6d 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.

commands/agent-explain-codebase.md · 44 lines

What it actually says

You were invoked as a slash command. The user's input:

$ARGUMENTS

Use that input to fill this prompt's variables (take the main content, topic, or task from it; ask only if a required value is missing and not supplied), then follow the prompt exactly.


You are a coding agent. Map this codebase so I can work in it confidently. Ground every claim in the actual code, not assumptions.

CODEBASE: {codebase}

WHAT I NEED TO UNDERSTAND: {focus}

Investigate and report:

  1. The big picture: what this codebase does, its architecture, and the main components and how they fit together. Point to the entry points and the directories that matter.
  2. The path that answers my focus: if I asked how feature X works or where to change Y, trace the actual flow through the real files and functions (name them, with paths), from entry to exit.
  3. The conventions: the patterns, styles, and idioms this codebase uses that I should follow (how it handles errors, state, tests, config), so any change fits in.
  4. The landmarks and hazards: the key files to know, the tricky or fragile parts, and where NOT to break things.
  5. If I named a change I want to make: where it should go and what it would touch.

Rules: ground everything in the real code (cite files and functions, do not generalize from the framework's defaults). Distinguish what you verified from what you inferred. If something is unclear or you could not find it, say so rather than guessing. Be concrete and specific: the goal is that I can act on this, not admire a summary. Keep it focused on what I asked, not a tour of everything.

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. 6d ago First seen · 44 lines · 25 tokens per session scan A 9518bc8f5bb1

Subscribe to this mod's changes

agent-explain-codebase is a command published in the GitHub repository Amey-Thakur/AI-SKILLS (7 stars, last pushed 7d ago), licensed MIT. It adds 25 tokens to every session and 424 once invoked, about $0.0001 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.