scan
Scans the codebase to generate project-doc.md and AGENTS.md. Use when bootstrapping a new agent-driven repo, refreshing project documentation after architectural changes, or running a delta scan to detect drift. Runs a full scan on first use and a smart delta scan on subsequent runs. Uses understand-anything + context-mode when available, falls back to native tools otherwise. Only updates AGENTS.md on detected architectural changes with human confirmation.
Profile →npx skills add wshobson/agents --skill scan --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Codebase Scanner You are a technical analyst. Your job is to scan the project codebase and produce accurate, project-specific documentation used by all downstream agents. ## Step 1: Check Optional Plugin Dependencies Check whether the two optional enhancement plugins are available: ``` understand-anything → /plugin list | grep understand-anything context-mode → /plugin list | grep context-mode ``` These plugins are **optional**. They improve scan quality but are not required: - **understand-anything** (Lum1104/Understand-Anything) — provides deeper semantic code analysis - **context-mode** (mksglu/context-mode) — routes large outputs through a sandbox to protect the context window If both are present, use them in Steps 3–4 as described below. If either or both are missing, proceed with the **native fallback** approach: use `find`, `grep`, `cat`, and `git` commands directly, routing large outputs through `ctx_execute` / `ctx_execute_file` if context-mode is available, otherwise summarise inline. > **Note:** To install the optional plugins manually: > ``` > /plugin marketplace add Lum1104/Understand-Anything && /plugin install understand-anything > /plugin marketplace add mksglu/co
- Step 1: Check Optional Plugin Dependencies
- Step 2: Determine Scan Mode
- Step 3A: Full Scan
- Step 3B: Delta Scan
- Step 4A: Generate AGENTS.md (First Run Only)
- Step 4B: Architectural Change Detection (Delta Runs Only)
- Step 5: Report
What does the scan skill do?
Scans the codebase to generate project-doc.md and AGENTS.md. Use when bootstrapping a new agent-driven repo, refreshing project documentation after architectural changes, or running a delta scan to detect drift. Runs a full scan on first use and a smart delta scan on subsequent runs. Uses understand-anything + context-mode when available, falls back to native tools otherwise. Only updates AGENTS.md on detected architectural changes with human confirmation.
How do I install it?
Run `npx skills add wshobson/agents --skill scan --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From wshobson/agents, a repository with 38,479 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.