Agent skill
gh-issue-planner
Read the current GitHub issue description from the branch-based issue number, agree on a plan, and update the issue description when the plan diverges. Use for planning tasks that must sync an agreed plan back to the active GitHub issue using the gh CLI.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/gh-issue-planner
SKILL.md
Issue Plan Sync
Overview
Keep a GitHub issue description aligned with an agreed plan. Read the current issue body, confirm the plan, and update the issue description when the plan changes.
Workflow
- Read the current issue and its description.
- Run
scripts/issue_plan_sync.sh showto print the issue URL and body.
- Run
- Draft the plan as a short, ordered list and confirm agreement.
- Keep the plan small and concrete: steps, owners, or decision points.
- If the agreed plan diverges from the current issue body, update the plan section.
- Write the plan to
plan.mdand runscripts/issue_plan_sync.sh update plan.md.
- Write the plan to
- Re-read the issue body to confirm the update.
- Run
scripts/issue_plan_sync.sh show.
- Run
Plan Section Rules
- The script inserts or replaces a plan section bounded by:
<!-- PLAN:START --><!-- PLAN:END -->
- If the markers are missing, the plan section is appended to the issue body.
- Use
--replace-bodyonly when the entire issue description should be replaced.
Script Usage
Show issue URL and body:
scripts/issue_plan_sync.sh show
Update only the plan section (preferred):
scripts/issue_plan_sync.sh update plan.md
Replace the entire issue body:
scripts/issue_plan_sync.sh update plan.md --replace-body
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?