Home / richkuo / rk-skills · skills/github-issue-format/SKILL.md · GitHub

github-issue-format skillA

github-issue-format is agent-read markdown (skill) from richkuo/rk-skills: 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. Load BEFORE creating or editing a GitHub issue..

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

## Body

- **Never create a placeholder, stub, or empty-bodied issue.** Every issue gets a complete body at creation, even in a batch. If a follow-up is not ready to spec, track it in the parent issue or notes until it is.
- **Section order:** complexity rationale line, `## Problem`, `## Goal`, `## Approach`, `## Acceptance criteria`, `## Plain simple English`, then any Execution block, then the attribution footer. An Execution block is machine metadata and keeps its place between the last prose section and the footer.
- **Complexity rationale line** (first line of the body): matches the title prefix and ends with an explicit fableplan signal:
…

Read the whole file at its exact version.

How to install

Latest version
mdr add richkuo/rk-skills/github-issue-format@git:20260923.d8bb824
Exact content
mdr add richkuo/rk-skills/github-issue-format@sha256:00a92927089ca05c

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_p3cnz6o7xq4d4ohz.svg)](https://markdownregistry.com/a/art_p3cnz6o7xq4d4ohz)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.d8bb824 latest2026-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. 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 (3054 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 · 49 stars · license MIT · pushed 2026-09-24 · 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/00a92927089ca05c5e9bc3652756ba751f241c5fa58737468029754e924ed1cd

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 richkuo/rk-skills

AGENTS.md agents
richkuo/rk-skills · AGENTS.md
git:20260817.faa195b · audit B · 49 stars
CLAUDE.md claude
richkuo/rk-skills · CLAUDE.md
git:20260924.1f0b4fa · audit B · 49 stars
app-prd 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:20260901.2e108d4 · audit A · 49 stars
cli-dispatch 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:20260923.d8bb824 · audit A · 49 stars
create-release 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:20260808.d2de7e3 · audit A · 49 stars
execution-plan-review skill
richkuo/rk-skills · skills/execution-plan-review/SKILL.md · Use when the user wants to review or revise the ordering/model/effort/fableplan/plan-effort assignments on a…
git:20260923.d8bb824 · audit A · 49 stars
fable-advisor 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:20260905.4d694c8 · audit A · 49 stars
fable-dispatch 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:20260924.1f0b4fa · audit A · 49 stars
fable-new-issue-loop 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:20260901.6c08e4b · audit A · 49 stars
fable-new-issue 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:20260901.6c08e4b · audit A · 49 stars
fable-orchestrate skill
richkuo/rk-skills · skills/fable-orchestrate/SKILL.md · Use when the user wants a task decomposed and driven by a Fable 5.1 orchestrator delegating implementation to Sonnet 5…
git:20260905.4d694c8 · audit A · 49 stars
fable-validate-fableplan-loop skill
richkuo/rk-skills · skills/fable-validate-fableplan-loop/SKILL.md · Use when the user asks to validate a GitHub issue with Fable 5.1, always plan it with Fable 5.1, and autonomously drive…
git:20260923.07468a2 · audit A · 49 stars

Every file in richkuo/rk-skills

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