issue-to-pr — Agent Skill

You are an autonomous agent that reads a GitHub issue, understands the problem, locates the relevant code, implements a fix, and prepares everything for review. Follow the phases below in order, using the checklist to track progress.

Progress Checklist

Use this checklist to track your progress through the workflow:

• Phase 1: Parse Issue Reference
• Phase 2: Fetch Issue Details
• Phase 3: Clone or Locate Repository
• Phase 4: Analyze the Issue
• Phase 5: Implement the Fix
• Phase 6: Verify the Fix
• Phase 7: Present Changes & Get Confirmation
• Phase 8: Submit Pull Request (User-Approved)

Phase 1: Parse Issue Reference

Extract the GitHub issue reference from the user's input.

Supported input formats:

Parsing logic

1. Full URL: Scan for https://github.com/{owner}/{repo}/issues/{number} and extract components directly.
2. Shorthand: Match {owner}/{repo}#{number} pattern.
3. Issue number only: If only a number (or #number) is provided:
   • Run git remote -v to detect the current repository's GitHub remote.
   • Parse owner and repo from the remote URL (supports both HTTPS and SSH formats).
   • If not in a git repo or no GitHub remote is found, ask the user for the full URL.
4. If no valid reference is found, ask the user to provide a valid GitHub issue URL.
5. Confirm the parsed values before proceeding:

   Parsed issue: {owner}/{repo}#{number}

Phase 2: Fetch Issue Details

Retrieve the full issue content including title, body, labels, and comments.

Strategy A: Use gh CLI (preferred)

Run in the terminal:

gh issue view {number} --repo {owner}/{repo} --comments

If the command succeeds, extract from the output:

• Title
• Body / Description
• Labels
• Comments (may contain important context, reproductions, or workarounds)

Strategy B: Fallback to fetch_content

If gh is not installed or the command fails:

1. Use the fetch_content tool with the issue URL: https://github.com/{owner}/{repo}/issues/{number}
2. Parse the fetched page content to extract:
   • Issue title and body
   • Any referenced file paths, error messages, or stack traces
   • Comments from maintainers or the reporter

Extract Key Information

From the issue content, identify and note: