Shepherd Review — Development skill for Claude Code
/shepherd-review — Quality Gate Before Pushing.
How to install Shepherd Review
Installs to ~/.claude/skills/mshadmanrahman-bug-shepherd-shepherd-review/SKILL.md
mkdir -p ~/.claude/skills/mshadmanrahman-bug-shepherd-shepherd-review && curl -fsSL https://raw.githubusercontent.com/mshadmanrahman/bug-shepherd/HEAD/commands/shepherd-review.md -o ~/.claude/skills/mshadmanrahman-bug-shepherd-shepherd-review/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Shepherd Review does
/shepherd-review — Quality Gate Before Pushing
A mandatory quality check before any bug fix is pushed. Ensures minimal, focused changes with proper evidence.
**Audience:** Developers who fixed a bug and want to verify before creating a PR. Also useful for PMs reviewing a developer's proposed fix.
Workflow
1. Load Configuration
Read `.claude/triage.config.yaml` for:
review.max_line_diff— flag if net lines exceed thisreview.tech_stack_rules— project-specific ch
Alternatives in Development
- Stop Review Gate — You are reviewing uncommitted changes before the author finishes their turn 664 ★
- Verify Theme — Run the full Graphite quality gate (drift, tokens, contrast, YAML) and report pass/fail 452 ★
- Engage.Gate — Run gate validation on the current phase before proceeding 348 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Phase Review
Run post-execution quality gate - verifies all deliverables before marking a track complete
Pre Ship
This is the final quality gate before shipping. Nothing goes to production without passing this checklist. Be
Phase Gate
Verify phase completion with quality gates before unlocking the next phase. Run when all issues in a phase are
Quality Review
Run docs-reviewer, code-review, and diff-scoped E2E in parallel as a quality gate
Tails Verdict
The quality stage. Runs the single gate, then the one isolated review, once. Use when a build is finished, nev
Creative Gate
Gate built creatives before anyone sees them — CD plans, role agents review in parallel, consolidated SHIP/FIX
Related Agents
Sp Reviewer
Use as a pre-push guardrail before committing or pushing. Runs lint, build, tests and a secret scan, reviews t
PR Shepherd
Takes an APPROVED loop PR from reviewer-approve to MERGED — pre-flight hygiene → push-delivery verification →
Ami Push Assistant
Pre-push quality, security, and git consistency orchestrator. Invoke whenever pushing code, performing git pus