aahoughton
@aahoughton
Public Skills
pare-docs
by aahoughton
Cuts bloat from a project's prose documentation — README, guides, package docs — by first deciding what each file is for, then in three passes: necessity, cross-file redundancy, then concision and tone. Written for docs that were drafted with LLM help and carry the usual tells: long, conversational, over-complete, redundant across files. Use this skill when the user asks to tighten, pare, trim, or de-slop documentation, or says the docs are too long or repeat themselves. Triggers on phrases like "these docs are bloated", "tighten up the README", "cut the docs down", or "the docs repeat themselves". Changes documentation only — never executable code.
branch-review
by aahoughton
Pre-merge checks on the current branch that complement a code review rather than repeat one: repo-specific review guidance, CODEOWNERS, the project's own lint/typecheck, and new TODO/FIXME markers. Use this skill when the user asks what else to check before merging, asks about reviewers or owners for their changes, or wants the project's own checks run against the branch. Triggers on phrases like "anything else before I merge", "who needs to review this", "run the checks on this branch", or "am I clear to merge". Does NOT judge correctness or code quality — /code-review does that, and /arch-review audits whole-repo structure.
arch-review
by aahoughton
Performs a deep architectural review of an entire codebase as it currently stands, evaluating composability, testability, and structural design. Use this skill when the user asks to audit architecture, find structural issues, assess code quality at a system level, or evaluate design decisions. Triggers on phrases like "review the architecture", "audit this codebase", "what's wrong with this repo", "assess the design", or "what would be hard to change here". Reviews the whole repo, not a diff — for reviewing the changes on a branch before merging, use branch-review instead. Spawns three parallel specialist agents and returns a single prioritized issue list.