Craft a single, high-quality GitHub issue from a developer's description of a bug, unexpected behavior, or desired enhancement. Walks through reproduction, codebase exploration, and structured drafting so the issue is actionable on arrival. Use when user wants to file an issue, report a bug, request a feature, or document a problem they've encountered.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Create Issue
Turn a developer's rough description of a problem or idea into a single, well-structured GitHub issue that is actionable the moment someone reads it.
This skill produces **one issue at a time**.
## Principles
### Actionable on arrival
A good issue lets someone start working without asking follow-up questions. Every issue must answer: what happened (or what should happen), how to see it, and how to know it's fixed.
### Behavioral, not procedural
Describe **what** the system does vs what it should do. Avoid file paths and line numbers — they go stale within hours. Name types, interfaces, and behavioral contracts instead.
### Honest about unknowns
If reproduction is intermittent, say so. If the root cause is unclear, say so. An honest "cause unknown, here's what I've ruled out" is more useful than a guess that sends someone down the wrong path.
## Process
### 1. Understand the problem
Work from whatever the developer tells you. Ask clarifying questions **one at a time** — don't dump a questionnaire. Focus on:
- **What happened** — the actual behavior they observed
- **What they expected** — the behavior they wanted
…
The line at the top of this page pins the label git:20260721.0a6edff, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (6946 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag
Source
GitHub
nateslabach/skills · 6 stars · license MIT · pushed 2026-09-29 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kqjomtnhxfy7atjt
GET https://markdownregistry.com/api/v1/resolve?ref=nateslabach/skills/create-issue
GET https://markdownregistry.com/api/v1/blob/e10e6fab7c6f3203e2355b964eeda652ae00a7d1ebf042dbd1e5812a49cae868
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
nateslabach/skills · skills/adhd/SKILL.md · Formats output for ADHD-friendly action — lead with the next step, number tasks, restate state, cut fluff. Use when…
nateslabach/skills · skills/ai-systems-review/SKILL.md · Hostile self-review of recently written AI workflow code that then applies fixes (agents, tools, chat context…
nateslabach/skills · skills/asd-ste100/SKILL.md · Writes in ASD-STE100 simplified technical English — short sentences, plain words, active voice. Use when the user wants…
nateslabach/skills · skills/code-review/SKILL.md · Structured 3-phase peer review of a diff or PR — intent, issues by severity, then pointed merge-readiness questions and…
nateslabach/skills · skills/css-reset/SKILL.md · Applies a modern CSS reset covering box-sizing, margin removal, text rendering, media defaults, and root stacking…
nateslabach/skills · skills/deep-research/SKILL.md · Produces thorough, multi-source cited research reports from web and news without paid APIs. Use when the user asks for…
nateslabach/skills · skills/depth-ui/SKILL.md · Applies depth-driven layered color and shadow principles to elevate average UI into polished, readable interfaces for…
nateslabach/skills · skills/engineering-judgment/SKILL.md · Applies Chesterton's Fence, Occam's Razor, the Peter Principle, and Dunning-Kruger to technical decisions. Use before…
nateslabach/skills · skills/human-writing/SKILL.md · Strips AI fingerprints from written text by enforcing banned vocabulary, forbidden sentence structures, and authentic…
qwenlm/qwen-code · .qwen/skills/create-issue/SKILL.md · Draft and submit a GitHub issue from a user idea or bug description, with bilingual body and correct labels.
tobihagemann/turbo · claude/skills/create-issue/SKILL.md · Create a GitHub issue with a drafted title and body. Use when the user asks to "create an issue", "file an issue"…
tobihagemann/turbo · codex/skills/create-issue/SKILL.md · Create a GitHub issue with a drafted title and body. Use when the user asks to "create an issue", "file an issue"…
tomzx/agents · skills/create-issue/SKILL.md · Create a GitHub issue with background, prioritized acceptance criteria (Must/Should), and a justified time budget.
phmatray/tagout · plugins/tagout/skills/create-issue/SKILL.md · Create a fully-seeded GitHub issue — not a bare `issue-create` call: template-compliant, carrying a brainstorm → spec →…
phmatray/tagout · skills/create-issue/SKILL.md · Create a fully-seeded GitHub issue — not a bare `issue-create` call: template-compliant, carrying a brainstorm → spec →…
phmatray/ai-migration-kit · plugins/tagout/skills/create-issue/SKILL.md · Create a fully-seeded GitHub issue — not a bare `issue-create` call: template-compliant, carrying a brainstorm → spec →…
