issue
Installation
SKILL.md
Issue
File a GitHub issue with the create_issue tool.
Write it for a stranger who will read it in 30 seconds and then has to fix it. They have no context, no memory of the conversation, and no patience.
Rules
- Title: one line, under 10 words, names the actual problem - not a vague symptom.
- Body: under 150 words. Plain language. Spell out anything an outsider would not know.
- Open with the problem in one sentence. No preamble, no restating the title.
- Use only these sections: What happens, Steps to reproduce, Expected. Add Cause or Suggested fix only if you have evidence for it, one sentence each.
- Steps to reproduce: numbered, one action per line, no commentary.
- Include only load-bearing evidence - the single number, error, or log line that proves the problem. Cut anything that merely reinforces it.
- No hedging unless you are genuinely unsure; then name the uncertainty in one clause.
- No background, no alternatives considered, no impact speculation, no summary at the end.