bostonaholic/skills

Agent skills for pull requests, code and design review, codebase audits, and investigation. Each skill installs on its own.

These skills were extracted from the Team plugin. They do not need Team, and Team does not need them.

Install

Two ways in. The Claude Code plugin installs every skill as one managed bundle that updates when a new version ships. npx skills copies the skills you pick into your project or home directory, for Claude Code, Codex, and other agents; you own and edit the copies. Pick one: installing both gives you every skill twice.

Claude Code

claude plugin marketplace add bostonaholic/skills
claude plugin install bostonaholic-skills@bostonaholic

Update the marketplace first, then the plugin:

claude plugin marketplace update bostonaholic
claude plugin update bostonaholic-skills@bostonaholic

Any agent, whole set

npx skills@latest add bostonaholic/skills

Pick the skills you want, and which agents to install them on.

One skill

npx skills@latest add bostonaholic/skills --skill <name>

To update it:

npx skills@latest update <name>

A skill that calls another skill names it, and stops or falls back when that skill is missing.

Skills

Engineering

Audit Complexity audit-complexity

Rank where code complexity concentrates in a codebase.

Use for auditing where code complexity concentrates in a codebase, and its CRAP change risk when coverage data exists.

Usage: /audit-complexity [<path or subsystem> ...] [--out <dir>] [--coverage <file>]

npx skills@latest add bostonaholic/skills --skill audit-complexity

Source

Audit Tests audit-tests

Audit a test suite for low-value tests.

Use for auditing a whole test suite for low-value tests.

Usage: /audit-tests [<path or subsystem> ...] [--out <dir>]

npx skills@latest add bostonaholic/skills --skill audit-tests

Source

Code Review code-review

Review a diff with fresh-context discipline.

Use for reviewing code diffs with fresh context.

Usage: /code-review [<diff target>]

npx skills@latest add bostonaholic/skills --skill code-review

Source

Eng Design Doc Review eng-design-doc-review

Adversarially review a design document.

Use for reviewing technical designs with fresh context.

Usage: /eng-design-doc-review [<design-doc-path>]

npx skills@latest add bostonaholic/skills --skill eng-design-doc-review

Source

Groom Backlog groom-backlog

Groom a project backlog end to end.

Use for backlog grooming. Proposes tracker changes; each requires approval.

Usage: /groom-backlog [<project-number-or-url>] [--promote <issue-number>]

npx skills@latest add bostonaholic/skills --skill groom-backlog

Source

How how

Explain how a subsystem works.

Use for explaining subsystem architecture or runtime flow.

Usage: /how [<subsystem, feature, or question>]

Calls: why.

npx skills@latest add bostonaholic/skills --skill how

Source

No Comments no-comments

Remove low-value source comments.

Use for comment cleanup only on explicit request. Removes low-value comments and encodes valid constraints.

Usage: /no-comments [<files-or-diff>]

Explicit invocation only.

npx skills@latest add bostonaholic/skills --skill no-comments

Source

Paparazzi paparazzi

Capture verified screenshots of an app.

Use for screenshots of an app. Captures verified screenshots of an app.

Usage: /paparazzi [--out <dir>] [--url <app-url>] [<what to shoot>]

npx skills@latest add bostonaholic/skills --skill paparazzi

Source

PR Open Comments pr-open-comments

Triage unresolved PR review comments.

Use for addressing PR comments only on explicit request. Never infer from unresolved comments. Triages PR feedback.

Usage: /pr-open-comments [<pr-number-or-url>]

Calls: pr-screenshots.

npx skills@latest add bostonaholic/skills --skill pr-open-comments

Source

PR Rebase pr-rebase

Rebase a branch onto its base.

Use for branch rebases only on explicit request. Never infer from a behind branch. Rebases onto the branch base.

Usage: /pr-rebase [<pr-number-or-url>]

Explicit invocation only.

npx skills@latest add bostonaholic/skills --skill pr-rebase

Source

PR Screenshots pr-screenshots

Attach local images to a PR body.

Use for adding PR screenshots only on explicit request. Never infer from local images. Attaches them to the PR body.

Usage: /pr-screenshots [<pr-number-or-url>] [--entries <path>]

npx skills@latest add bostonaholic/skills --skill pr-screenshots

Source

PR Watch as Author pr-watch-as-author

Watch your own PR for review feedback and CI.

Use for watching authored PRs only on explicit request. Never infer from an open PR. Monitors feedback and CI.

Usage: /pr-watch-as-author [<pr-number-or-url>]

Calls: pr-open-comments.

npx skills@latest add bostonaholic/skills --skill pr-watch-as-author

Source

PR Watch as Reviewer pr-watch-as-reviewer

Watch a PR you review, then approve once.

Use for watching and approving reviewed PRs only on explicit request. Approves when feedback settles.

Usage: /pr-watch-as-reviewer [<pr-number-or-url>]

Explicit invocation only.

npx skills@latest add bostonaholic/skills --skill pr-watch-as-reviewer

Source

Prove prove

Prove claims or a PR test plan with evidence.

Use for proving claims or PR test plans with evidence. Produces evidence-rated verdicts.

Usage: /prove [<claims> | <pr-number-or-url>]

Calls: how, paparazzi, why.

npx skills@latest add bostonaholic/skills --skill prove

Source

Shipit shipit

Land a reviewed pull request.

Use for landing reviewed PRs only on explicit request. Never infer from approval, green CI, or completion. Verifies and merges.

Usage: /shipit [<pr-number>]

npx skills@latest add bostonaholic/skills --skill shipit

Source

Why why

Investigate the design rationale behind code.

Use for investigating design rationale behind code.

Usage: /why [<question, file, symbol, or decision>]

npx skills@latest add bostonaholic/skills --skill why

Source

Productivity

Agent Prompt agent-prompt

Compose an agent-optimized prompt for a task.

Use for composing agent-optimized task prompts.

Usage: /agent-prompt [<task description>] [--repo <path>] [--out <path>]

npx skills@latest add bostonaholic/skills --skill agent-prompt

Source

Retro retro

Mine this session for durable learnings.

Use for retrospectives only on explicit request. Never infer from session end or friction. Extracts durable learnings.

Usage: /retro [skill-name]

Explicit invocation only.

npx skills@latest add bostonaholic/skills --skill retro

Source