Home / ymd38 / dev-skills · skills/gh-issue-drafter/SKILL.md · GitHub

gh-issue-drafter skillA

gh-issue-drafter is agent-read markdown (skill) from ymd38/dev-skills: Turn a rough, hand-written intent into a well-scoped GitHub Issue before planning starts. Takes a loose 'what I want' from the user, proposes the missing structure (Done definition, Out of scope, Design constraints), gets the user's approval, and creates the Issue via the gh CLI with a scoped-issue marker so gh-issue-planner can pick it up. This is the human-authored counterpart to report-to-issues (which registers machine-generated findings). Use when the user wants to file a new Issue from a r.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# GitHub Issue Drafter

## Overview

The quality of everything downstream — the plan, the reviews, the implementation, the
CI verification — is capped by the quality of the Issue that starts it. A rough,
one-line Issue forces every later step to guess at the author's intent.

This skill takes the user's rough intent (the *What*) and, without slowing them down,
proposes the three things a hand-written Issue almost always omits: a machine-checkable
**Done definition**, an explicit **Out of scope**, and optional **Design constraints**.
The user approves or edits the proposal, then the skill creates a structured GitHub
Issue tagged with a marker that `gh-issue-planner` recognizes.

**Scope boundary:** this skill only drafts and files the Issue. It does not investigate
code, propose a response plan, or implement anything. Hand off to `gh-issue-planner`
once the Issue exists.

## When NOT to expand

If the user's input already contains a clear Done definition and scope (e.g. they pasted
a fully-formed Issue, or a `report-to-issues` output), do not re-interrogate them — just
confirm and file. The goal is to fill gaps, not to add ceremony to Issues that are
already well-formed.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add ymd38/dev-skills/gh-issue-drafter@git:20260919.20d77cb
Exact content
mdr add ymd38/dev-skills/gh-issue-drafter@sha256:a9cbea6bcf2537ac

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_d4wvo3762kbluvks.svg)](https://markdownregistry.com/a/art_d4wvo3762kbluvks)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260919.20d77cb latest2026-09-19 20d77cb 7,662 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (7662 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

ymd38/dev-skills · 4 stars · license MIT · pushed 2026-09-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_d4wvo3762kbluvks
GET https://markdownregistry.com/api/v1/resolve?ref=ymd38/dev-skills/gh-issue-drafter
GET https://markdownregistry.com/api/v1/blob/a9cbea6bcf2537ac7e3b586efb1285878d7c99a81ec4d4eafb957a9a25df30da

Your agent 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.

More from ymd38/dev-skills

data-validation skill
ymd38/dev-skills · skills/data-validation/SKILL.md · Inspect a project's data for correctness and produce a read-only validation report — record counts, NULL rates, value…
git:20260919.20d77cb · audit A · 4 stars
gh-batch-runner skill
ymd38/dev-skills · skills/gh-batch-runner/SKILL.md · Run several planned GitHub Issues as one unit: collect them under an Epic Issue with sub-issues, implement each on a…
git:20260919.2a16c51 · audit A · 4 stars
gh-issue-planner skill
ymd38/dev-skills · skills/gh-issue-planner/SKILL.md · Fetch a GitHub Issue by ID using the gh CLI, investigate related code, propose a structured response plan (policy…
git:20260919.2a16c51 · audit A · 4 stars
gh-issue-resolver skill
ymd38/dev-skills · skills/gh-issue-resolver/SKILL.md · Implement and verify a fix for a GitHub Issue whose response plan has already been posted as a comment by…
git:20260919.20d77cb · audit A · 4 stars
progress-dashboard skill
ymd38/dev-skills · skills/progress-dashboard/SKILL.md · Generate an interactive HTML dashboard that visualizes improvement progress from software-evaluation and…
git:20260919.20d77cb · audit A · 4 stars
report-to-issues skill
ymd38/dev-skills · skills/report-to-issues/SKILL.md · Parses reports generated by the software-evaluation or vulnerability-scan skills and interactively registers selected…
git:20260919.20d77cb · audit A · 4 stars
setup skill
ymd38/dev-skills · skills/setup/SKILL.md · Install the full maruda harness into the current project through a short interview: CLAUDE.md, hooks…
git:20260919.a2588a5 · audit A · 4 stars
software-evaluation skill
ymd38/dev-skills · skills/software-evaluation/SKILL.md · Evaluate code quality across five pillars (Architecture, Reliability, Observability, Security, DX) and produce a 1-10…
git:20260919.20d77cb · audit A · 4 stars
spec-doc skill
ymd38/dev-skills · skills/spec-doc/SKILL.md · Generate or sync a "Living Specification" (docs/spec.md) from source code to eliminate doc-code drift. Use when…
git:20260919.20d77cb · audit A · 4 stars
vulnerability-scan skill
ymd38/dev-skills · skills/vulnerability-scan/SKILL.md · Run an offensive security audit (OWASP-based) using Semgrep and produce a read-only vulnerability report. Use before…
git:20260919.20d77cb · audit A · 4 stars

Every file in ymd38/dev-skills

Other files named gh-issue-drafter

gh-issue-drafter skill
northraystudio/maruda · skills/gh-issue-drafter/SKILL.md · Turn a rough, hand-written intent into a well-scoped GitHub Issue before planning starts. Takes a loose 'what I want'…
git:20260919.20d77cb · audit A · 4 stars

Browse by kind, by grade A, or by owner.