draft-issue

Convert rough ideas into structured GitHub issues with labels and approval.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns rough product ideas and casual suggestions into fully structured, implementation-ready GitHub issues that follow the repository's gold-standard template and align with project vision and existing code.

Core Features & Use Cases

  • Clarify and scope ideas: ask 1-2 targeted clarifying questions when the input is ambiguous to produce a scopiable backlog item.
  • Context-aware drafting: read forge.toml, key docs (VISION.md, STATUS.md, CLAUDE.md), and search open issues to detect duplicates and ensure alignment.
  • Template-driven output: produce a complete issue body with summary, features/scope, architecture/design notes, integration points, acceptance criteria, and documentation tasks.
  • Safe creation workflow: suggest labels and a gh issue create command but always require explicit user approval before creating the issue and report back with the issue number and URL.

Quick Start

Run /draft-issue followed by a short description of your idea, for example: add a command to manage docker containers.

Frequently Asked Questions about draft-issue

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

FAQPage Schema
How do I convert rough product ideas into structured GitHub issues?

To convert rough ideas into structured GitHub issues, this Skill asks 1-2 clarifying questions, reads repository docs like VISION.md for alignment, detects duplicates, and generates a template-driven issue body ready for the backlog.

How to create implementation-ready backlog items from conversation notes?

Creating implementation-ready backlog items from conversation notes involves scoping the input, searching open issues for duplicates, and producing an issue body with acceptance criteria, architecture notes, and integration points.

Can I automatically generate GitHub issue labels from feature suggestions?

Yes, you can generate GitHub issue labels from feature suggestions. The workflow suggests appropriate labels and prepares a gh issue create command, but always requires your explicit approval before actually creating the issue.

Does the GitHub issue drafting process check for duplicate backlog items?

Yes, the GitHub issue drafting process checks for duplicate backlog items by searching existing open issues and reading key repository documents to ensure the new feature suggestion aligns with the project vision.

What is included in a template-driven GitHub issue body for product management?

A template-driven GitHub issue body for product management includes a summary, features and scope, architecture or design notes, integration points, acceptance criteria, and documentation tasks to ensure implementation readiness.