git-issuelisted
Install: claude install-skill rdlugs/ai-skills
# git-issue
Turn a rough problem, request, or pile of notes into a clean issue that a maintainer can triage in seconds and act on without a follow-up round of questions. The output is **markdown text** the user pastes into their tracker — you are not running `gh`, `glab`, or any API.
## The mental model
A good issue answers three questions fast: *what's wrong or wanted*, *how do I reproduce or understand it*, and *how do I know when it's done*. Everything below serves that. A maintainer skimming twenty issues should grasp yours from the title alone and know the next step from the body. Padding, ceremony, and restating the obvious all work against that, so keep it tight.
## Workflow
1. **Classify the issue.** Read what the user gave you and pick the type — bug, feature/enhancement, task/chore, docs, or question. If it's genuinely ambiguous, make your best guess and note it rather than stalling to ask; the user can correct a draft faster than they can answer an interview.
2. **Pull out what you already have.** Error text, stack traces, versions, repro steps, file paths, PR/commit links, the desired behavior — harvest these from whatever the user pasted. Don't make the user re-supply things that are already on screen.
3. **Flag real gaps, don't invent.** If a bug is missing its reproduction steps or a feature is missing its motivation, leave a short `> _TODO: ..._` marker in that spot rather than fabricating plausible-sounding details. A fabricated repro step is worse than