issue-to-pr

Convert a GitHub issue into a plan-only pull request.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/pzheng460/claude-workflow-plugin --skill issue-to-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-to-pr
Source: https://github.com/pzheng460/claude-workflow-plugin/tree/main/skills/issue-to-pr
Command: npx skills add https://github.com/pzheng460/claude-workflow-plugin --skill issue-to-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a GitHub issue into an actionable PR by validating issue completeness, mapping to appropriate implementation skills, and producing a plan-only PR when ready.

Core Features & Use Cases

  • Issue intake and classification: automatically fetches the issue, assesses type, and validates against checklists from workflow skills.
  • Research and planning: gathers references and writes a concrete plan that maps issue details to an implementation approach.
  • Plan-first PR creation: creates the initial PR containing only the plan file to be refined in subsequent steps.

Quick Start

Provide a GitHub issue or URL to automatically generate a plan-driven PR.

Frequently Asked Questions about issue-to-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a GitHub issue into an actionable PR plan?

To convert a GitHub issue into an actionable PR plan, provide the issue URL to automatically fetch details, validate completeness against checklists, research references, and generate a plan-only PR for subsequent execution.

What is a plan-driven PR and how does it work with GitHub issues?

A plan-driven PR is an initial pull request containing only a generated plan file. It works by mapping validated GitHub issue details to an implementation approach, linking the plan to an execution skill for subsequent refinement.

Does this workflow validate issue completeness before generating a PR?

Yes, the workflow validates issue completeness before generating a PR. It automatically fetches the GitHub issue, assesses its type, and checks the details against checklists from workflow skills to ensure readiness.

How to automatically create a PR from a GitHub issue?

You can automatically create a PR from a GitHub issue by providing the issue URL. The system fetches the issue, validates it, researches references, and produces a plan-first PR to guide implementation.

Can I use this to map GitHub issues to implementation skills?

Yes, you can use this to map GitHub issues to implementation skills. The workflow validates issue completeness, generates a concrete plan, and links the resulting plan-only PR to the appropriate implementation skill for execution.

What are the limitations of generating plan-only PRs from issues?

A limitation of generating plan-only PRs from issues is that the initial PR contains only the plan file. Actual code implementation requires subsequent steps and linking to the appropriate implementation skill to execute the generated plan.