refine-issue-plan

Installation
SKILL.md

Refine Issue Plan

Turn incomplete issue context into an implementation-ready plan without discarding the original request. Separate analysis, approval, issue mutation, and implementation.

1. Resolve the task

  • Identify the exact tracker, repository or project, and issue when supplied.
  • Verify that any local checkout belongs to the resolved issue before using it as evidence.
  • Read the complete issue body, comments, attachments, metadata, linked designs, and existing child links when available.
  • Treat the current conversation as planning evidence. Capture approved decisions, rejected options, constraints, and intentional placeholders.
  • Inspect repository context for discoverable facts instead of asking the user. Read project instructions before inspecting or proposing changes.
  • When only issue text is available, work from it and mark repository-dependent details as unknown.
  • Use read-only operations during analysis. Do not modify the issue or implement the task yet.

2. Audit readiness

Summarize only what affects execution:

Installs
1
First Seen
Aug 25, 2026
refine-issue-plan — ilya-valasiuk/agent-skills