skills.rest
yamcodes
yamcodesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

write-issue

Creates GitHub issues via gh CLI after interactive requirement clarification and triage labeling.

1|Updated Aug 24, 2026
Search Tags:#github#gh cli#triage#labeling#issue creation#requirements clarification#agent brief
One-click install
npx skills add https://github.com/yamcodes/the-hat --skill write-issue-yamcodes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-issue
Source: https://github.com/yamcodes/the-hat/tree/main/skills/write-issue
Command: npx skills add https://github.com/yamcodes/the-hat --skill write-issue-yamcodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Vague or incomplete issue reports waste engineering time and lead to miscommunication. This Skill turns a rough idea into a well-structured GitHub issue by interviewing the user, drafting a complete specification, creating the issue with the GitHub CLI, and applying triage labels automatically. ## Core Features & Use Cases - Interactive Requirement Grilling: Asks one question at a time to clarify scope, edge cases, and acceptance criteria before writing anything. - Codebase-Aware Context Gathering: Explores the repository, domain glossary, ADRs, and prior rejections to ground the issue in real technical context. - Automated Issue Creation and Triage: Creates the issue via gh issue create, applies canonical category and state labels, and posts an agent brief for issues ready to be worked on. - Use Case: You notice a caching bug but only have a rough description. Invoke the Skill, answer its clarifying questions, and it files a complete, labeled issue with testable acceptance criteria on GitHub. ## Quick Start Ask the assistant to write a new GitHub issue describing the problem you want to report, then answer its clarifying questions.

Frequently Asked Questions about write-issue

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

FAQPage Schema
How do I create a GitHub issue from the command line?▼

Use the GitHub CLI with gh issue create --title and --body flags to file an issue directly from your terminal. This Skill automates that command after drafting a complete issue body with acceptance criteria.

How to write a good bug report or feature request on GitHub?▼

A good issue includes a clear problem statement, current behavior, desired behavior, testable acceptance criteria, and explicit out-of-scope items. This Skill interviews you one question at a time to extract all of these before filing.

Does this Skill require the GitHub CLI to be installed?▼

Yes, it relies on the gh CLI for creating issues, editing labels, and posting comments. You must have gh installed and authenticated against the target repository for the workflow to complete.

Can it apply labels and triage new issues automatically?▼

Yes, after creating the issue it follows the triage skill workflow to apply canonical category labels like bug or enhancement and state labels like ready-for-agent or needs-info using gh issue edit.

When should I not use an interactive issue-writing workflow?▼

Skip it for trivial, fully understood tasks where a one-line issue suffices, since the grilling session adds overhead. It is best suited for ambiguous bugs or features where requirements need clarification.

Related Skills

Explore More Software Engineering Skills→
jwh3timesjwh3times
1

to-spec

Synthesizes conversation context into a structured spec published to the project issue tracker.

Community
Intermediate
triage-softwaretriage-software

ot-followup-issue-from-pr

Creates tracker issues from PR comments and design documents.

Official
Advanced
catu-aicatu-ai
12

issue-triage

Classify and label GitHub issues for the easyharness repository.

Official
Intermediate
posit-devposit-dev
4.2k

positron-issue-creator

Drafts complete GitHub issue drafts for the Positron repository with duplicate checking.

Official
Basic