
Do Issue
Finish a GitHub-issue fix workflow by running dependent tasks in order, dispatching a final code review, and updating issue status before one consolidated PR.
Overview
do-issue is an agent skill most often used in Ship (also Build) that executes sequential GitHub-issue tasks, runs a final code review, and updates issue status before a consolidated PR.
Install
npx skills add https://github.com/athola/claude-night-market --skill do-issueWhat is this skill?
- Phase 5 sequential Task-tool prompts when work depends on prior issue tasks
- Phase 6 batched final review across multiple issue numbers with explicit verify checklist
- gh issue comment/close snippets tied to short HEAD commit
- Pre-PR consolidation: confirm all issue commits live on one branch via git log
- Documented as Phases 5–6 (sequential tasks + final review)
- Final review checklist covers 5 verification areas (criteria, tests, regressions, quality, docs)
Adoption & trust: 1 installs on skills.sh; 304 GitHub stars; 1/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
You have partially implemented GitHub issues on one branch and need dependent tasks finished, reviewed, and issues closed without splitting work across branches.
Who is it for?
Solo builders running agent-driven GitHub issue workflows who already decomposed work into tasks with dependencies.
Skip if: Greenfield features with no issues, repos without gh CLI access, or teams that merge without any review gate.
When should I use this skill?
Issue workflow phases 5–6: sequential dependent tasks remain or you need final review and gh status updates before PR.
What do I get? / Deliverables
Dependent tasks complete in order, a final review subagent signs off on all linked issues, gh comments reflect the fix commit, and one branch is verified ready for PR.
- Completed sequential task implementations
- Final review subagent report
- Issue comments and optional closes via gh
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Ship because the skill’s documented value is closure: sequential execution after deps, consolidated pre-PR check, and acceptance-criteria review—not greenfield planning. Review matches Phase 6’s superpowers:code-reviewer dispatch and verification of criteria, tests, regressions, and docs before handoff.
Where it fits
Run Task 2 only after Task 1 middleware merged, with prompts that cite issue acceptance criteria.
Dispatch superpowers:code-reviewer across issues #42–#44 before opening one PR.
Post gh completion comments so reviewers see commit SHAs and change bullets without digging through agent logs.
How it compares
Use instead of ad-hoc “fix the ticket” chat when you need explicit sequential deps, a batched reviewer prompt, and gh status updates in one ritual.
Common Questions / FAQ
Who is do-issue for?
Indie and solo developers using Claude Code (or similar) to close GitHub issues through phased Task-tool workflows and gh.
When should I use do-issue?
During Build when finishing dependent implementation tasks on an issue, and during Ship when you need a final multi-issue code review, issue comments, and a single-branch pre-PR check.
Is do-issue safe to install?
It instructs shell git/gh and subagent review—review the Security Audits panel on this page and restrict repo tokens before running automated close comments.
SKILL.md
READMESKILL.md - Do Issue
# Phases 5-6: Completion Execute sequential tasks and finalize the workflow. ## Phase 5: Sequential Tasks For tasks with dependencies, execute sequentially: ``` Task tool (general-purpose): description: "Issue #42 - Task 2: Add login endpoint" prompt: | You are implementing Task 2 from Issue #42. This task depends on completed Task 1 (auth middleware). [Task requirements] Verify Task 1's middleware works before building on it. ``` Review after each sequential task following the subagent-driven-development pattern. ## Phase 6: Final Review Dispatch detailed review of all changes: ``` Task tool (superpowers:code-reviewer): description: "Final review: Issues #42, #43, #44" prompt: | Review complete implementation for issues: #42, #43, #44 Verify: - All acceptance criteria met - Tests detailed and passing - No regressions introduced - Code quality meets standards - Documentation updated if needed ``` ## Update Issue Status For each completed issue: ```bash # Add completion comment gh issue comment 42 --body "Fixed in commit $(git rev-parse --short HEAD) Changes: - Implemented auth middleware - Added login endpoint - Added detailed tests Ready for review." # Optionally close issue gh issue close 42 --comment "Completed via automated fix workflow" ``` ## Pre-PR Consolidation Check Before creating the PR, verify all work is on ONE branch: ```bash # Confirm current branch contains all issue commits git log --oneline --grep="Fixes #42" --grep="Fixes #43" \ --all-match HEAD # If commits are on separate branches, cherry-pick or # rebase them onto the shared branch first. ``` ## Finish Development Use `superpowers:finishing-a-development-branch` to: - Verify all tests pass - Present merge options - Execute chosen completion path **One PR rule**: Always create exactly ONE pull request that references all issues via `Fixes #N` lines in the body. See Step 6.2 in the do-issue command for the template. Never create separate PRs per issue. ## Tooling Reflection (Night-Market Feedback Loop) After completing the workflow, reflect on the *tooling itself* (skills, agents, commands, hooks) rather than the repo code: - Did any skill behave unexpectedly or have unclear guidance? - Was a subagent slow, redundant, or missing context? - Did the do-issue command skip steps or require unnecessary manual intervention? - Did a hook fire incorrectly or miss a case? **If yes**, post to https://github.com/athola/claude-night-market/discussions (Learnings category) using the pattern from `fix-pr` Step 6.7. Always target the night-market repo, not the current working repo. **If no observations**, skip this step silently. > Repo-specific learnings stay in the current repo. Tooling > learnings always go to > https://github.com/athola/claude-night-market/discussions > so the framework can improve. ### Record Lessons Learned (decision journal) If this work involved rework, a failed approach, or a blocker, record it to `docs/lessons-learned.md` so the insight survives past the session (draft and confirm): - If leyline is installed, invoke `Skill(leyline:decision-journal)` and append a lesson entry (`what_happened`, `what_didnt_work`, `root_cause`, `action`; set `phase` to `execute`). Show the draft; append on confirmation. - Fallback (leyline absent): append to `docs/lessons-learned.md` using the in-file ENTRY TEMPLATE; assign the next `LL-NNN` id. ## Example Final Output ``` Final Review: All requirements met Issues Summary: #42: 3 tasks completed, all tests passing #43: 2 tasks completed, all tests passing #44: 1 task completed, all tests passing PR: fix(auth): add middleware and login endpoint (#42, #43, #44) - Fixes #42, Fixes #43, Fixes #44 - All issues consolidated in single PR ``` # Phase 1: Issue Discovery Parse input arguments and retrieve issue content from the detected git platform. Check session context for `git_platform:` to determine which CLI