bostonaholic/skills

The skills I use to build software with coding agents.
## Install
Copy/paste into your CLI prompt:
text
Install the skills from https://github.com/bostonaholic/skills, refer to the repo's AGENTS.md for instructions.
Or follow the installation instructions.
## Skills
### Engineering
addressing-pr-comments: Triage and address open PR feedback. Calls: attaching-pr-screenshots.
attaching-pr-screenshots: Attach local images to a PR body.
auditing-agent-token-usage: Audit Claude Code and Codex token and context costs.
auditing-complexity: Rank code complexity hotspots and CRAP change risk.
auditing-rails-tech-debt: Audit a Rails app for cited tech debt findings. Calls: simplifying-ruby-code.
auditing-repo-security: Audit a third-party repo before running it.
auditing-tests: Audit a test suite for low-value tests.
capturing-screenshots: Capture verified screenshots of an app.
choosing-determinism: Move a skill's deterministic steps into scripts it runs.
configuring-zsh: Place zsh config in the right startup file.
diagnosing-react-code: Scan a React package and fix its errors.
drawing-mermaid-diagrams: Write, render, and debug Mermaid diagrams.
explaining-architecture: Explain how a subsystem or runtime flow works. Calls: investigating-design-rationale.
explaining-code: Explain a PR, diff, or code briefly or in full. Calls: explaining-architecture.
fixing-root-causes: Trace each symptom to its root and fix it there.
freeing-disk-space: Find what fills the disk and clear regenerable files.
grooming-backlogs: Plan backlog grooming changes for approval.
hillclimbing: Iterate on measured changes until the criteria pass.
investigating-design-rationale: Investigate why code is shaped as it is. Calls: explaining-architecture.
landing-prs: Land a reviewed pull request on explicit request. Calls: rebasing-branches.
making-code-agent-friendly: Audit, review, and refactor code so many agents can change it in parallel.
merging-dependabot-prs: Plan and merge safe Dependabot updates one at a time, or only request rebases. Explicit invocation only.
proving-claims: Prove claims or a PR test plan with rated evidence.
rebasing-branches: Rebase the current branch onto its base and force-push with a lease.
rebasing-open-prs: Rebase all open pull requests onto their bases after confirmation. Explicit invocation only.
redesigning-from-first-principles: Redesign as if a new requirement was always there. Explicit invocation only.
redoing-implementations: Rebuild the current work as a simpler design. Explicit invocation only.
removing-comments: Remove low-value source comments, encoding constraints with approval. Explicit invocation only.
reviewing-code: Review a diff in a fresh-context read-only subagent.
reviewing-design-docs: Adversarially review a technical design document.
reviewing-security: Security-review a diff in a fresh-context read-only subagent.
simplifying-ruby-code: Find or fix over-engineered Ruby and Rails code.
summarizing-friction-logs: Prioritize frog friction logs across a workspace.
updating-bostonaholic-skills: Update the bostonaholic plugin installs and skill copies to the latest release. Explicit invocation only.