new-issue

new-issue is a skill for Claude Code from richkuo/rk-skills. It costs 94 tokens per session (1,277 once invoked), scanned A, original, MIT.

A process for turning a bug, idea, or discussion into a complete GitHub issue that another developer or coding agent can implement without prior conversation context. It verifies the problem, designs an approach, sets acceptance criteria, and estimates complexity.

In plain words
What is it for?
Use it to file a new issue from a description or from the current conversation. It creates a problem statement, goal, approach, acceptance criteria, plain-language summary, and complexity score.
Why use it?
It removes vague placeholders and missing background from issue tracking. The resulting issue records what is wrong or wanted, how to approach it, and how to tell whether it is finished.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md.

Part of the rk-skills plugin — 37 skills, 1 command shipped together

Good fit Use it to file a new issue from a description or from the current conversation. It creates a problem statement, goal, approach, acceptance criteria, plain-language summary, and complexity score.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/richkuo/rk-skills/new-issue
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add richkuo/rk-skills --skill new-issue
Clone the repo
git clone --depth 1 https://github.com/richkuo/rk-skills

Made for: Claude Code.

Or install rk-skills, the plugin that ships this one along with the rest of its 37 skills, 1 command.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for new-issue

README.md
[![agentmods](https://agentmods.dev/badge/skills/richkuo/rk-skills/new-issue/github.svg)](https://agentmods.dev/skills/richkuo/rk-skills/new-issue)
Your own site
<a href="https://agentmods.dev/skills/richkuo/rk-skills/new-issue"><img src="https://agentmods.dev/badge/skills/richkuo/rk-skills/new-issue/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for new-issue

Your own site · 80×15
<a href="https://agentmods.dev/skills/richkuo/rk-skills/new-issue"><img src="https://agentmods.dev/badge/skills/richkuo/rk-skills/new-issue.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 94 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,277 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00094 $0.01277
Opus 5 $0.00047 $0.00639
Sonnet 5 $0.00019 $0.00255
Haiku 4.5 $0.00009 $0.00128

Measured 4d ago against content hash 3d0caa0ce132, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

new-issue scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/new-issue/SKILL.md · 76 lines

How it starts

The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.

new-issue

File a GitHub issue that a human or agent can pick up cold and implement correctly: grounded problem, goal, approach, acceptance criteria, complexity score, plain-language summary, attribution footer. Never file a placeholder, stub, or thin body; if it is not ready to spec, say so and track it in notes or a parent issue instead.

Spec the best solution per the CLAUDE.md Engineering rules: cost, compute, time, token spend, code volume, and convenience never narrow the option space; only correctness, safety, and the explicit non-negotiables (worktree+PR workflow, verifying claims against code, destructive-action safety) override "best". When the cheap design and the correct design diverge, spec the correct one and let the score say so.

Input

  • A description of the bug, feature, or task; still ground it in code (step 2).
  • Nothing: derive the issue from the current conversation. When several candidates were discussed, file the one the discussion converged on; name the others and offer to file each fully specified. Never bundle.
  • Optionally owner/repo or a repo path when the issue belongs elsewhere (gh issue create -R owner/repo).

Steps

1. Repo and duplicate check

Confirm the repo (gh repo view --json nameWithOwner). Run gh issue list --state open --search "<keywords>" and gh pr list --state open --search "<keywords>". A genuine hit stops the run: surface it and offer to update or comment on it instead. A passing mention does not count.

2. Ground every claim

Each claim about current behavior is held to the validate-issue standard: trace the code path and keep the file:line. A claim you cannot trace is phrased as unverified ("appears to", "needs confirmation"). An issue derived from conversation is re-checked against the actual files; recollection goes stale. On a divergent or stale branch, trace against origin/<default> (git show "origin/$DEFAULT":<path>).

3. Design the approach

For anything beyond a localized bug fix, spec the approach so it passes the validate-issue architecture pass:

Read the full file on GitHub · 76 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago Changed · -38 lines 3d0caa0ce132
  2. 7d ago Changed c9150614b7f6
  3. 11d ago First seen · 114 lines · 94 tokens per session scan A 2867c16199d6

Subscribe to this mod's changes

new-issue is a skill published in the GitHub repository richkuo/rk-skills (49 stars, last pushed yesterday), licensed MIT. It adds 94 tokens to every session and 1,277 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

issue-fields-migration

Bulk-migrate metadata to GitHub issue fields from two sources: repo labels (e.g. priority labels to a Priority field) and Project V2 fields. Use when users say "migrate my labels to issue fields", "migrate project fields to issue fields", "convert labels to issue fields", "copy project field values to issue fields"…

boshi-xixixi/TraeSkill · 116 tokens

comet-github-idea-to-issue

A workflow for turning a local idea, bug observation, or improvement proposal into a focused GitHub Issue draft. GitHub Issues are shared records for bugs, features, questions, and maintenance work.

rpamis/comet · 68 tokens

codex-issue-coordinator

Coordinates a large batch of GitHub issues through separate Codex worker threads, tested pull requests, review loops, and gated merges. Use when the user asks one Codex thread to manage several coding sessions or complete a parent issue, milestone, or issue batch.

owainlewis/blueprint · 59 tokens

loop-it

An automated workflow that repeatedly fetches open GitHub issues, orders them by dependencies, implements them, reviews the changes, and ships them.

smallnest/goal-workflow · 93 tokens

to-issues

A planning aid that breaks a PRD or technical specification into small implementation issues, each covering a complete, demonstrable piece of work.

smallnest/goal-workflow · 96 tokens

ship-it

A GitHub workflow for finishing an implemented issue: commit the relevant changes, push a branch, create a pull request, merge it, and close the issue. GitHub is a service for hosting code and reviewing changes, and a pull request is a proposed change for review.

smallnest/goal-workflow · 96 tokens