prompting:scan

Scan

Run the scanner over the paths in $ARGUMENTS, defaulting to the current directory:

bun ${CLAUDE_SKILL_DIR}/scripts/scan.ts [<path>...] [--all] [--quiet] [--score]

It reports each alert as file:line:col: level: check: message on stdout and a per-check count table on stderr, and exits non-zero on any alert. A check is an error once the precision eval confirms it and a warning until then. --quiet drops the table. --score replaces it with one row per scanned file, clean files included, giving its alerts, its prose words outside frontmatter and code, and alerts per 1,000 words, plus a total. Run it before and after an edit round over the same paths to compare them.

Without --all it reads the paths that hold documents a model executes: SKILL.md, CLAUDE.md, AGENTS.md, .claude/agents, .claude/commands, .claude/rules, a skill's references/, and a prompt/ or prompts/ directory holding .md or .txt files. Use --all for a prompt that lives somewhere else, such as one extracted from a string in a product repo. It reads .md and .txt under either setting, so --all widens which documents count without pulling in source files. Either way it also scans the files a scanned CLAUDE.md or AGENTS.md imports with @path, up to four hops deep, and lists on stderr each import outside the scanned paths or missing. It skips node_modules, .git, fixtures, __snapshots__, and evals.

Checks

Rewrites

Sharpen the sentence the alert names.

• Prompting.WeakModality: the instruction is a suggestion the model can decline, so whether it fires is left to the run.
• Prompting.VagueCriterion: the done-state is one the model cannot check. The model decides for itself when to stop.

Deletions

Delete the span the alert names.

• Prompting.NoOp: the instruction restates a default the model already follows, spending context and changing nothing.
• Prompting.StaleMeasurement: the document reports a tally a past run counted. The run prints the number again, so the document caches its own output and drifts as the work behind it moves.
• Prompting.TicketRef: a bare issue number points at a tracker the model cannot read, and the prose around it goes stale when the issue closes.