github-issue-format SKILL.md skillA

github-issue-format from richkuo/rk-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add richkuo/rk-skills/github-issue-format@git:20261022.bc1e35d

Pins git:20261022.bc1e35d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
richkuo/rk-skills
Path
skills/github-issue-format/SKILL.md
Versions recorded
12
Latest version
git:20261022.bc1e35d, committed Oct 22, 2026
First version recorded
Sep 1, 2026
Size
3,940 bytes
Repository stars
50
License
MIT

Required format for creating or editing any GitHub issue — [C<score>] title convention, complexity rationale line, complete-body rule, mandatory Plain simple English section, attribution footer, milestone title rule. Load BEFORE creating or editing a GitHub issue or milestone.

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

# GitHub issue format

## Title

- `[C<score>] <title>`: a plain-simple-English sentence in ASD-STE100, precise about component and behavior, e.g. `[C95] Orders can be filled twice when two fills arrive at the same moment`.
- The **complexity score (0–100)** is a model and effort routing signal. `validate-issue` step 6 owns the formula, axes, and routing table; never restate or approximate them here.

## Milestone

- Every milestone title you create or rename is one hyphenated token with no spaces (`MCP-Read-foundations`, `Backtest-live-parity`). This holds for every path that creates one: a batch from `prd-to-issues`, a split of one issue into follow-ups, or a manual request.
- Before you assign an issue to a milestone that has spaces in its title, rename that milestone to the hyphenated form (`gh api -X PATCH repos/<owner>/<repo>/milestones/<number> -f title=<new-title>`). The rename keeps every issue on the milestone. Quote a title that still has spaces in every `gh` call.

## Body
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add richkuo/rk-skills/github-issue-format@sha256:22d0799c5f0f2dca

The line at the top of this page pins the label git:20261022.bc1e35d, 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.

Badge

mdr badge

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

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 12 versions of this file, between Sep 1, 2026 and Oct 22, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261022.bc1e35d latest2026-10-22 bc1e35d 3,940 BA view · diff
git:20261007.9d947822026-10-07 9d94782 3,854 BA view · diff
git:20261006.4c6da762026-10-06 4c6da76 3,232 BA view · diff
git:20261005.e9b5f922026-10-05 e9b5f92 3,447 BA view · diff
git:20261004.47b4d962026-10-04 47b4d96 3,169 BA view · diff
git:20261002.51ca0842026-10-02 51ca084 3,112 BA view · diff
git:20260927.55c22802026-09-27 55c2280 3,114 BA view · diff
git:20260923.d8bb8242026-09-23 d8bb824 3,054 BA view · diff
git:20260905.cd7c29b2026-09-05 cd7c29b 3,050 BA view · diff
git:20260903.6fdbab12026-09-03 6fdbab1 3,018 BA view · diff
git:20260901.c877bb02026-09-01 c877bb0 2,868 BA view · diff
git:20260901.6c08e4b2026-09-01 6c08e4b 3,332 BA view

Audit of the latest version

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 (3940 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

richkuo/rk-skills · 50 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_p3cnz6o7xq4d4ohz
GET https://markdownregistry.com/api/v1/resolve?ref=richkuo/rk-skills/github-issue-format
GET https://markdownregistry.com/api/v1/blob/22d0799c5f0f2dca1a0f543930fc34cac0283ba00b7b4a58716872761157abc4

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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from richkuo/rk-skills

AGENTS.md AGENTS.md file
richkuo/rk-skills · AGENTS.md
git:20260817.faa195b · audit B · 50 stars
CLAUDE.md CLAUDE.md file
richkuo/rk-skills · CLAUDE.md
git:20261031.cef71f0 · audit B · 50 stars
app-prd SKILL.md skill
richkuo/rk-skills · skills/app-prd/SKILL.md · Use when the user wants an app idea turned into a Product Requirements Document (PRD) committed to a repo — "create a…
git:20261006.4c6da76 · audit A · 50 stars
cli-dispatch SKILL.md skill
richkuo/rk-skills · skills/cli-dispatch/SKILL.md · Required dispatch procedure for running a build, fix pass, or validate pass on an external coding CLI — the Codex CLI…
git:20261007.71d313a · audit A · 50 stars
codex-validate-plan-work-on-issue SKILL.md skill
richkuo/rk-skills · skills/codex-validate-plan-work-on-issue/SKILL.md · Use when the user wants one or more GitHub issues run in parallel through a Codex CLI validate pass, a separate Codex…
git:20261011.cbb2a8b · audit A · 50 stars
create-release SKILL.md skill
richkuo/rk-skills · skills/create-release/SKILL.md · Use when the user asks to "create a release", "cut a release", "tag a version", "publish release notes", or ship a new…
git:20261006.4c6da76 · audit A · 50 stars
execution-plan-review SKILL.md skill
richkuo/rk-skills · skills/execution-plan-review/SKILL.md · Use when the user wants to review or revise the ordering/model/effort/plan/plan-effort assignments on a milestone's…
git:20261022.bc1e35d · audit A · 50 stars
expo-app-initialize SKILL.md skill
richkuo/rk-skills · skills/expo-app-initialize/SKILL.md · Scaffolds a new Expo React Native app with the tabs template, expo-router, react-native-mmkv, expo-dev-client, and…
git:20261007.e110522 · audit A · 50 stars
fable-advisor SKILL.md skill
richkuo/rk-skills · skills/fable-advisor/SKILL.md · Use when the user wants a task executed by the current session model with a persistent Fable 5.1 advisor overseeing it…
git:20261006.4c6da76 · audit A · 50 stars
fable-dispatch SKILL.md skill
richkuo/rk-skills · skills/fable-dispatch/SKILL.md · Required dispatch procedure for running a subagent on Fable 5.1: positive harness detection, the Claude Code CLI shim…
git:20261006.4c6da76 · audit A · 50 stars
fable-new-issue-loop SKILL.md skill
richkuo/rk-skills · skills/fable-new-issue-loop/SKILL.md · Use when the user asks to have a Fable 5.1 subagent draft and file a GitHub issue, then autonomously drive it all the…
git:20261006.4c6da76 · audit A · 50 stars
fable-new-issue SKILL.md skill
richkuo/rk-skills · skills/fable-new-issue/SKILL.md · Use when the user wants a GitHub issue created by a Fable 5.1 subagent. Spins up a read-only subagent running on Fable…
git:20261006.4c6da76 · audit A · 50 stars

Every file in richkuo/rk-skills

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