create-issue

Guide brainstorming and draft GitHub issues with acceptance criteria.

9|2|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/typemd/typemd --skill create-issue-typemd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-issue
Source: https://github.com/typemd/typemd/tree/main/.claude/skills/create-issue
Command: npx skills add https://github.com/typemd/typemd --skill create-issue-typemd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams turn vague ideas into well-scoped GitHub issues by guiding a structured brainstorming and drafting process, ensuring clear problem statements, scope, acceptance criteria, and contextual guidance before creation.

Core Features & Use Cases

  • Guided brainstorming to refine ideas into concrete issue bodies with scope, success criteria, and blockers.
  • Automatic draft generation and validation, including duplicate detection and appropriate labeling.
  • Stepwise collaboration and confirmation flow that requires explicit user approval before creating an issue.

Quick Start

Describe your idea and confirm the guided draft to create a GitHub issue.

Frequently Asked Questions about create-issue

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

FAQPage Schema
How do I turn a vague idea into a well-scoped GitHub issue?

To turn a vague idea into a well-scoped GitHub issue, you can use a guided brainstorming process to refine the problem statement, define clear scope, establish acceptance criteria, and identify blockers before drafting the final issue.

What is the best way to draft GitHub issues with clear acceptance criteria?

The best way to draft GitHub issues with clear acceptance criteria is through structured brainstorming that automatically deduces issue types, handles duplicate checks, applies appropriate labels, and requires explicit confirmation before creation.

Can I automatically check for duplicate GitHub issues before creating a new one?

Yes, you can automatically check for duplicate GitHub issues during the guided drafting process, which validates your input, handles duplicate detection, and suggests appropriate labeling before you explicitly approve the final issue creation.

How do I brainstorm and structure bug reports or feature requests for GitHub?

To brainstorm and structure bug reports or feature requests for GitHub, engage in a stepwise collaboration flow that deduces the issue type, maps release relationships, and generates a concrete issue body with defined scope and blockers.

Does this issue drafting process require manual approval before creating the GitHub issue?

Yes, this issue drafting process requires explicit user approval before creating the GitHub issue, ensuring a stepwise collaboration and confirmation flow that validates the generated draft, scope, and contextual guidance.

When should I use a structured brainstorming workflow for GitHub project management?

You should use a structured brainstorming workflow for GitHub project management when you need to transform generic tasks or vague ideas into well-scoped issues, ensuring proper labeling, release relationships, and clear problem statements before creation.