issues

Create GitHub issues and milestones from Markdown planning documents.

9|2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/0xrafasec/ai-workflow --skill issues-0xrafasec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issues
Source: https://github.com/0xrafasec/ai-workflow/tree/main/skills/issues
Command: npx skills add https://github.com/0xrafasec/ai-workflow --skill issues-0xrafasec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mcp__github__*, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of creating GitHub issues and milestones directly from your planning documents, reducing manual effort and ensuring consistency.

Core Features & Use Cases

  • Automated Issue Creation: Automatically generate issues for tasks and slices from roadmap and specification documents.
  • Milestone Setting: Create milestones for each phase based on the document structure.
  • Use Case: If you have a roadmap or specification document, use this Skill to create corresponding GitHub issues and milestones, streamlining your project management process.

Quick Start

Run the 'issues' skill with the path to your roadmap document, e.g., 'issues docs/roadmap/README.md'.

Frequently Asked Questions about issues

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

FAQPage Schema
How do I automate GitHub issue creation from a markdown roadmap document?

Automating GitHub issue creation from a markdown roadmap requires parsing the document structure to generate tasks and slices. This Skill uses Markdown parsing and GitHub API integration to automatically create corresponding issues directly from your planning documents.

Can I set GitHub milestones automatically based on specification document phases?

Setting GitHub milestones automatically from specification documents is possible by mapping document phases to milestones. This Skill parses the structural phases in your planning documents and generates corresponding GitHub milestones via the GitHub API.

Do I need GitHub API access to generate issues and milestones from planning documents?

Yes, GitHub API access is required to generate issues and milestones from planning documents. This Skill relies on the GitHub API integration to authenticate and push the parsed markdown structures directly into your project repository.

What is the best way to convert a specification markdown file into GitHub issues?

The best way to convert a specification markdown file into GitHub issues is by parsing the document structure to identify tasks and slices. This Skill automates that conversion process, streamlining project management workflows by ensuring consistent issue generation.

How does markdown parsing map roadmap phases to GitHub milestones?

Markdown parsing maps roadmap phases to GitHub milestones by identifying structural headings and sections within the planning document. This Skill analyzes the document structure to create corresponding milestones for each identified phase using the GitHub API.

Are there limitations when automating issue creation from specification documents?

Limitations when automating issue creation from specification documents include strict reliance on the markdown document structure for parsing tasks and phases. If the planning document lacks clear structural formatting, the automated generation of GitHub issues and milestones may not work as intended.