github-plan

Converts rough ideas into GitHub issues with tasks and metadata via the hero CLI.

1|Updated Jan 22, 2022
One-click install
npx skills add https://github.com/gotomts/dotfiles --skill github-plan
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: github-plan
Source: https://github.com/gotomts/dotfiles/tree/main/claude/skills/github-plan
Command: npx skills add https://github.com/gotomts/dotfiles --skill github-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts vague ideas and feature requests into structured, actionable GitHub issues by guiding focused brainstorming, checking for duplicates, proposing approaches, and autonomously creating issues with design and implementation comments and optional project placement.

Core Features & Use Cases

  • Interactive brainstorming: Asks one question at a time to clarify purpose, scope, acceptance criteria, and impact.
  • Duplicate detection: Searches existing issues to surface potential duplicates before proceeding.
  • Approach proposals: Produces 2–3 implementation approaches with trade-offs and a recommended option.
  • Autonomous structure & creation: Generates an Issue body, design comment, and implementation plan, runs a self-review, creates parent and subtask issues via gh CLI, and optionally adds items to GitHub Projects with status assignment.
  • Use case: A product manager or developer can turn a rough feature request into a parent issue and PR-sized subtask issues ready for implementation and project planning.

Quick Start

Ask the skill to convert the idea "Add category management to organize items by category" into a reviewed GitHub issue with subtasks and project placement.

Frequently Asked Questions about github-plan

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

FAQPage Schema
How do I convert a vague feature idea into a structured GitHub issue?β–Ό

To convert a vague feature idea into a structured GitHub issue, guided brainstorming clarifies scope and acceptance criteria, checks existing issues for duplicates, proposes implementation approaches, and creates the issue with design and implementation comments via gh CLI.

Do I need gh CLI authenticated to automatically create GitHub issues from ideas?β–Ό

Yes, you need gh CLI authenticated within the repository context to automatically create parent and subtask GitHub issues, post design comments, run self-review validation, and optionally add items to GitHub Projects.

How can I check for duplicate GitHub issues before creating a new feature request?β–Ό

To check for duplicate GitHub issues before creating a feature request, the system searches existing repository issues using gh CLI to surface potential duplicates and propose alternative approaches before proceeding with issue creation.

What is the best way to break down a product feature request into PR-sized subtask issues?β–Ό

The best way to break down a product feature request into PR-sized subtask issues is to generate an implementation plan with a parent issue and subtasks, run a self-review validation, and create them autonomously using gh CLI.

Can I add newly created GitHub issues to a GitHub Project automatically?β–Ό

Yes, you can add newly created GitHub issues to a GitHub Project automatically with status assignment, using gh CLI after generating the issue body, design comment, and implementation plan through the guided brainstorming workflow.