MichaelVessia/shepherd-pr
modules/programs/agents/shared/skills/shepherd-pr/SKILL.md
Shepherd an already-open PR across the line: monitor CI + bot comments, invoke `fix-pr` on issues, then merge when clean (respecting repo branch protection). Composes `monitor-pr` + `merge-pr`. Use when user says "shepherd", "shepherd PR", "watch and merge", or wants hands-off ship-it behavior on an existing PR.
$ install --global
skillsauthnpx skillsauth add MichaelVessia/nixos-config shepherd-prInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 8:08 AM165.8s1 file scanned
SKILL.md
- name:
- shepherd-pr
- description:
- |
- Shepherd an already-open PR across the line:
- monitor CI + bot comments,
- allowed-tools:
- Bash(gh *), Skill
shepherd-pr
Arguments: $ARGUMENTS (optional PR number or URL; else current branch PR).
This skill is a recipe: monitor-pr → merge-pr. All real work is delegated.
1) Monitor
Invoke monitor-pr with $ARGUMENTS.
- If it exits clean, proceed to step 2.
- If it exits blocked, stop. Print its report verbatim and exit. Do NOT merge.
2) Merge
Invoke merge-pr with $ARGUMENTS.
merge-pr enforces all policy (no CHANGES_REQUESTED bypass, uses repo's
allowed merge method, uses gh pr merge --auto to respect branch
protection).
3) Report
Combine the two sub-reports into a single final summary:
## Shepherd-PR
- **PR**: <URL>
- **Monitor outcome**: clean | blocked (<reason>)
- **Merge outcome**: merged | queued (auto-merge) | not attempted | blocked (<reason>)
- **fix-pr invocations**: 0 | 1 | 2 | 3
If the PR was queued via auto-merge, tell the user it will land on its own once branch protection clears.
Related Skills
MichaelVessia/plannotator-visual-explainer
development
VerifiedTrustedCommunity
Generate self-contained HTML visualizations with Plannotator theming. Use for implementation plans, PR explainers, architecture diagrams, data tables, slide decks, and any visual explanation of technical concepts. Plans and PR explainers follow Plannotator's prescriptive approach; all other visual content delegates to nicobailon/visual-explainer.
2SKILL.mdUpdated Jun 12, 2026
MichaelVessia/plannotator-setup-goal
development
VerifiedTrustedCommunity
Turn an idea or objective into a goal package for /goal. Interviews the user, builds a reviewed fact sheet via Plannotator, then explores the codebase to produce an execution plan.
2SKILL.mdUpdated Jun 12, 2026
MichaelVessia/plannotator-review
development
VerifiedTrustedCommunity
Open Plannotator's browser-based code review UI for the current worktree or a pull request URL, then act on the feedback that comes back.
2SKILL.mdUpdated Jun 12, 2026
MichaelVessia/plannotator-last
testing
VerifiedTrustedCommunity
Open Plannotator on the latest rendered assistant message and use the returned annotations to revise that message or continue.
2SKILL.mdUpdated Jun 12, 2026