Scan

Generates and maintains two critical files for agent-driven repos: project-doc.md (a structured architecture blueprint) and AGENTS.md (project-specific instructions every agent reads before working). Runs a full codebase scan on first use, then switches to smart delta scans that only re-analyze changed files via git diff. The clever bit is architectural change detection: it only updates AGENTS.md when it spots new frameworks, directory patterns, or major dependencies, and asks for human confirmation first. Optionally hooks into understand-anything for deeper semantic analysis and context-mode to keep large outputs out of your context window. Honestly feels like the kind of thing you'd write yourself after the third time onboarding someone to a complex repo and realizing the docs are stale again.

skills.sh installs: 5K
GitHub stars: 42.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add wshobson/agents --skill scan --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

SKILL.md on GitHub

Details

Repository: github.com/wshobson/agents
Categories: Documentation, AI & Agent Building
First seen: Jun 3, 2026