← All skills

scan

95 / 100 · Low risk

Fine to try.

By wshobson/agents (GitHub) · coding · 42,412 stars · scanned at commit 9c61ab2

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.

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'scan' ] || [ -L ~/.agents/skills/'scan' ]; then echo 'A skill folder named scan already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/wshobson/agents' "$d" && git -C "$d" checkout --quiet '9c61ab243def98f72da12abd41cfcf5bcd91af9d' -- 'plugins/ship-mate/skills/scan' && mkdir -p ~/.agents/skills && cp -R "$d"/'plugins/ship-mate/skills/scan' ~/.agents/skills/'scan' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'scan' ~/.claude/skills/'scan' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for wshobson/agents shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/wshobson/agents.svg)](https://zalavijaysinh.github.io/skilltrust/repos/wshobson/agents/)

Score history