create-issue

A Japanese-language workflow for turning a short idea into a well-defined issue, or task record, for a software project.

In plain words
What is it for?
Use it when you want to refine a one-line request through questions and options, then create an issue that another automated worker can implement.
Why use it?
It reduces guesswork by clarifying the desired result, reasons, completion conditions, project context, and possible approaches before the issue is created.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/mh4gf/claude-code/create-issue
Any agent
npx skills add MH4GF/claude-code --skill create-issue
Clone the repo
git clone --depth 1 https://github.com/MH4GF/claude-code

Made for: Claude Code, Codex.

Per session 116 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,612 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00116 $0.03612
Opus 5 $0.00058 $0.01806
Sonnet 5 $0.00023 $0.00722
Haiku 4.5 $0.00012 $0.00361

Measured yesterday against content hash 28b647635dfb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

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

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.

user-scope/skills/create-issue/SKILL.md · 180 lines

How it starts

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

create-issue

ユーザーの一行の意図を、superpowers:brainstorming で固めてから issue として起票する skill。issue body は brainstorming の議論結果から直接組み立てる。起票先と書き込み手段は実行時に解決する (「起票先を解決する」節)。

Symphony 系の運用へ乗せる前提で、起票先は Symphony の 1 系統と 1 対 1 に対応する。Symphony が次の poll で拾うことを期待する。

なぜ brainstorming を必須にするか

brainstorming skill の哲学に従う。「simple な issue こそ未検証の前提が無駄な実装を生む」。issue の Outcome / Why / 完了条件を曖昧なまま起票すると、Symphony が拾った後の実装ワーカーは推測で動く羽目になる。brainstorming で意図を固めれば、その議論結果が issue body の素材になる。

手順

1. superpowers:brainstorming で意図を固める

Skill ツール経由で superpowers:brainstorming を起動し、ユーザー の一行の意図を渡す。brainstorming は次を実施する。

  • project context の探索 (関連ファイル / 先行事例 / 既存 issue)
  • clarifying questions (one at a time)
  • 2-3 approaches の提示と user 選択
  • design sections の提示と user 承認

注意点:

  • brainstorming skill の標準フローには「Write design doc → spec self-review → User reviews spec → Invoke writing-plans skill」がある
  • 本 skill 経由では design doc を別ファイルとして書かない。議論結果は直接 issue description へ統合する
  • 別ファイル書き出しと writing-plans 起動が起きそうになったら、ユーザー へ確認してスキップする
  • 確認文言: 「create-issue 経由なので design doc 書き出しと writing-plans をスキップし、議論結果から直接起票へ進む」

理由: bg session の作業 workspace は origin/main の depth=1 clone なので、scraps/open/ 等へ書いた新規ファイルを bg session 側から読めない。issue body だけが情報源になる前提で組む。

2. 起票先を解決する

起票先は Symphony の 1 系統 = 対象 repo。まず repo を決め、その repo の tracker を決める。

  1. 会話の文脈から対象 repo が自明 (例: 「skills/X への変更」「daily note の cron が…」「unslop の rule 追加」) ならそれを採る。決められないなら AskUserQuestion で確定する
  2. 対象 repo のローカル clone があれば WORKFLOW.md frontmatter の tracker.kind を読む。works repo のみ agents/ai-native/WORKFLOW.md、それ以外は repo root
  3. clone が無い、または読み取れない場合は linear として扱う

以降、kind ごとに「Tracker 別操作」の手段を使う。

3. 重複を検索する

brainstorming で出てきたキーワード (1〜2 語) で既存 issue を検索する。検索は終端状態 (Done / Canceled) 以外をすべて対象にする。実装中や Human Review の issue と重なることがあり、状態を絞ると取りこぼす。

近い既存 issue が出た場合、新規作成せず該当の identifier と URL をユーザー へ報告して止まる。

4. description を組み立てる

brainstorming の議論結果から、次の節構成へ落とす。

  • ## Outcome — 最終状態と価値を箇条書きで 2〜4 点。手順は書かない
  • ## Why — 起票の動機・前例との関係・設計の理由。bg session が edge case で判断するための背景情報
  • ## 参考 — 参照した関連ファイル、関連 issue (実在のみ)、外部 URL。意図にある外部参照を必ず含める
  • ## 完了条件 — 観測可能な状態 (コマンド出力、ファイル存在、tracker / GitHub の見え方) を箇条書き
  • ## スコープ外 — 含めない範囲を箇条書き

Read the full file on GitHub · 180 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. yesterday First seen · 180 lines · 116 tokens per session scan A 28b647635dfb

Subscribe to this mod's changes

create-issue is a skill published in the GitHub repository MH4GF/claude-code (2 stars, last pushed 2d ago), licensed MIT. It adds 116 tokens to every session and 3,612 once invoked, about $0.0006 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-31.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

babysit-pr

Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is merged/closed or user help is required. Diagnose failures, retry likely flaky failures up to 3 times, auto-fix/push branch-related issues when appropriate, and keep…

openai/codex · 114 tokens

imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output…

openai/codex · 113 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

next-cache-components-optimizer

Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…

vercel/next.js · 170 tokens