issue-planner

Parses Markdown build-out plans to generate GitHub issues and a project board.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/olivermorgan2/workflow-generator --skill issue-planner-olivermorgan2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-planner
Source: https://github.com/olivermorgan2/workflow-generator/tree/main/skills/issue-planner
Command: npx skills add https://github.com/olivermorgan2/workflow-generator --skill issue-planner-olivermorgan2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the manual overhead of translating high-level product plans into structured GitHub issues, ensuring that project requirements, ADRs, and milestones are consistently tracked and linked.

Core Features & Use Cases

  • Automated Issue Generation: Parses structured Markdown plans to create batches of GitHub issues with appropriate labels and milestones.
  • Project Board Integration: Automatically creates and populates GitHub Project boards to visualize the delivery flow.
  • Use Case: After finalizing an MVP design document, use this skill to instantly generate a full backlog of issues, assign them to the correct project phases, and set up a tracking board for the team.

Quick Start

Run the issue-planner skill to parse your design documents and create the corresponding GitHub issues and project board.

Frequently Asked Questions about issue-planner

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

FAQPage Schema
How do I turn a Markdown project plan into a GitHub backlog automatically?

To turn a Markdown project plan into a GitHub backlog, you can use a skill that parses design and build-out plan Markdown files to generate a structured batch of GitHub issues. This process requires an authenticated GitHub CLI environment with project scope permissions to execute API-driven issue creation.

Can I automatically create a GitHub project board from my design documents?

Yes, you can automatically create a GitHub project board from design documents. The parsing process generates GitHub issues and simultaneously creates and populates a corresponding project board to visualize the delivery flow.

How does parsing ADRs help with creating GitHub issues and milestones?

Parsing ADRs ensures traceability between architecture decisions and work items. The parsing mechanism extracts requirements from Markdown plans to create GitHub issues with appropriate labels and milestones, linking project requirements consistently.

Do I need GitHub CLI permissions to generate issues from a project plan?

Yes, you need an authenticated GitHub CLI environment with project scope permissions to generate issues from a project plan. This authenticated setup is required to execute the API-driven issue and project board creation successfully.

What is the best way to structure a Markdown plan for automated GitHub issue generation?

The best way to structure a Markdown plan for automated GitHub issue generation is to organize it by project phases, requirements, and milestones. The parsing tool targets software and research projects requiring disciplined delivery flows, translating structured Markdown into appropriately labeled issues.

Why are my GitHub issues not linking to the correct project phases during backlog generation?

GitHub issues may not link to the correct project phases if the Markdown plan lacks structured formatting for milestones or if the GitHub CLI environment lacks sufficient project scope permissions. Consistent Markdown structuring ensures requirements are accurately translated into tracked work items.