claude-code20 minintermediateverified: claude-fable-5, 2026-07
SOP: Issue in, draft PR out — with guardrails
When done: claude -p "/work-issue 42" reads the issue, works on a branch,
and opens a draft PR you review. 20 minutes; needs gh authenticated.
Before you start
- [ ]
gh auth statusshows logged in;gh issue listworks in the repo. - [ ] The repo has a check command (tests/build) — no check, no autonomy.
Steps
- Create the skill
.claude/skills/work-issue/SKILL.md: - Guardrail the permissions. Draft PRs only (the skill says it; your
- Test on a toy issue. File "add a --version flag", run
- (Optional) go headless:
claude -p "/work-issue 42"from cron or a
`
---
name: work-issue
description: Take a GitHub issue number, implement it on a branch, open a draft PR.
---
1. gh issue view <n> — read title, body, comments. If acceptance criteria
are missing or ambiguous, comment your understanding on the issue and
STOP (don't guess unattended).
2. Branch: issue-<n>-<slug> off the default branch. Never work on main.
3. Implement smallest-first; run the repo's check command after each step.
4. Checks green → push branch, gh pr create --draft with: what/why,
how it was verified, anything you're unsure of. Link the issue.
5. Checks not green after honest effort → push anyway as draft PR titled
"WIP/blocked", describing exactly where it's stuck. Never open a
ready-for-review PR with failing checks.
`
✓ Check: /work-issue appears in your skills list.
review makes it real). Optionally deny gh pr merge in settings —
the agent proposes, you merge.
✓ Check: settings deny list includes merge if you added it.
/work-issue <n>.
✓ Check: draft PR exists, branch named right, checks documented in the body.
phone SSH session — same skill, no babysitting.
✓ Check: headless run produces the same draft-PR shape.
Verify the whole thing
A real small issue end-to-end; you should be able to review the PR knowing
exactly what was verified and what wasn't, without opening the transcript.
Rollback
Delete the skill folder; delete test branches (git branch -D, close PRs).
When it breaks
| Symptom | Cause | Fix |
|---|---|---|
| PR opened ready-for-review with red checks | step 5's rule missing/softened | the WIP-draft rule is the safety valve — restore exact wording |
| Agent guesses on vague issues | stop-and-comment rule skipped | acceptance-criteria gate is non-negotiable for unattended runs |
| Branch chaos | worked on main or reused branches | branch naming rule + git checkout -b in step 2, always fresh |
Changelog
- 0.1.0 (2026-07-04) — initial, verified on Claude Fable 5.
One email when a pack ships or gets re-benchmarked on a new model. No noise.