plan-issue

Generate and post an implementation plan for a GitHub issue with a plan-pending label.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/rjskene/pipeline --skill plan-issue-rjskene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-issue
Source: https://github.com/rjskene/pipeline/tree/main/skills/plan-issue
Command: npx skills add https://github.com/rjskene/pipeline --skill plan-issue-rjskene

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill converts a GitHub issue into a structured, ready-to-execute implementation plan while enforcing trust boundaries and preventing untrusted automation.

Core Features & Use Cases

  • Trusted-only planning gate: Checks the issue opener’s authorAssociation and refuses auto-planning for untrusted openers, surfacing the issue for human triage instead.
  • Path-aware planning: Chooses a planning mode (A/B/C/D) based on labels (or a cached recommended_path from trusted classification feedback).
  • End-to-end plan posting: Drafts the canonical “Implementation Plan” comment, publishes it via the shared helper, and applies the plan-pending label.
  • Revision-safe updates: When trusted feedback exists on an earlier plan, rewrites the plan with a required “Changes from previous plan” section.
  • Label-aware browser predicates: For needs-browser issues, requires machine-checkable predicates the browser-evaluation sub-skill can run.

Quick Start

Tell the AI to run /pipeline:plan-issue <issue_number> to produce and post an implementation plan comment for that issue and mark it as plan-pending.

Frequently Asked Questions about plan-issue

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

FAQPage Schema
How do I automatically generate an implementation plan from a GitHub issue?

To generate an implementation plan from a GitHub issue, trigger the plan-issue pipeline command with the issue number. It drafts a canonical plan comment, publishes it, and applies a plan-pending label to the issue.

Can I restrict automated issue planning to trusted contributors only?

Yes, automated issue planning can be restricted to trusted contributors using a trusted-opener gate. It checks the author association and refuses auto-planning for untrusted openers, surfacing them for human triage.

How does label-driven workflow automation choose a planning path for GitHub issues?

Label-driven workflow automation selects a planning path by reading specific GitHub issue labels. It can also use a cached recommended path from prior trusted classification feedback to determine the correct planning mode.

How do I update an existing implementation plan comment based on new feedback?

To update an existing implementation plan, the workflow detects trusted feedback on an earlier plan and rewrites it. The revised comment includes a required Changes from previous plan section to ensure revision-safe updates.

How are GitHub issues requiring browser testing handled during implementation planning?

GitHub issues requiring browser testing enforce label-aware browser predicates during implementation planning. This requires machine-checkable predicates that a browser-evaluation sub-skill can execute to validate the conditions.

What happens to the terminal state of a GitHub issue after posting an implementation plan?

After posting an implementation plan, the workflow handles the terminal state by applying a plan-pending label to the GitHub issue. This communicates that the issue is awaiting execution of the published plan.