petmakris

audit

Master codebase audit for claude-annotate. Runs all focused sub-audits — `/audit-engine-boundary`, `/audit-http-surface`, `/audit-plugin-manifest`, `/audit-docs-truth`, `/audit-code-health` — then presents one unified actionable report. Use when the user says "/audit", "audit the codebase", "run a full audit", "full sweep", or wants everything checked instead of one targeted sub-audit.

annotate-doctor

Check that this machine can run claude-annotate and claude-ide-review — python3 and its version, curl, state directory permissions, server health, and the separately-installed webcompanion daemon show-diff depends on. Invoked only when the user types `/annotate-doctor`, or when a skill's preflight has just failed and the user asks why. Never self-triggers. Reports problems and prints the command the user should run; for webcompanion specifically, offers to run that command itself once the user confirms — every other remedy stays report-only.

interactive-review

Per-line threaded Q&A on a GitHub PR diff, surfaced in IntelliJ via the IDE plugin. User clicks any diff line, asks a question, Claude wakes via WEBCOMPANION_EVENT, appends a reply to the line's thread, and the IDE refreshes that thread. Triggered by /interactive-review <PR>. Watcher events are WEBCOMPANION_EVENT / WEBCOMPANION_FINISHED / WEBCOMPANION_CANCELLED.

walkthrough

Answer a codebase question as an ordered sequence of anchored steps walked in IntelliJ, not as terminal prose. Claude generates the steps, the IDE plugin walks the user through them, and the user can ask a question on any step which Claude answers in place. Triggered by /walkthrough <question>. Watcher events are WEBCOMPANION_EVENT / WEBCOMPANION_FINISHED / WEBCOMPANION_CANCELLED.

dataflow

Map one feature's path through a codebase — controller, DTO, mapper, service, domain, repository, table — as an interactive diagram in the browser, where every node opens in the editor and any node can be questioned. Use when someone asks how a feature is wired end to end, what classes are involved in X, where a value goes between the API and the database, or says they cannot follow the flow. Triggered by /dataflow <class or feature>. Watcher events are WEBCOMPANION_EVENT / WEBCOMPANION_FINISHED / WEBCOMPANION_CANCELLED.

deck

Use when the user wants to review or change a single-file HTML presentation deck in a browser — "open the deck", "let me comment on these slides", "show me the deck and let me steer it". Renders every slide, lets any element be commented on, and edits the .html in place. Not for building a deck from scratch and not for generic HTML editing.

show-diff

Open code diffs in VS Code's multi-file diff editor, and never summarise them — branch against its base, a commit against the one before it, a branch against another workspace's branch, or uncommitted work including untracked files. Knows the Wealth Platform checkouts under ~/projects/wp/ through `wp diffable`, and works on any git checkout. Use when the user asks to see, show, open or review a diff, asks what a branch or a repo changed, or names things to compare. Not for reviewing a GitHub PR (that is mb-pr-review) and not for answering what the code does.