shimo4228
UserClaude Code skill: forces agents to research existing solutions before building — reduces reinvention
Categories
Indexed Skills (119)
search-first
Look outside before deciding: search the live web, registries and primary sources at decision time and bring back a report the caller picks from. Use for any question that may have an answer outside this repo — choosing a library or tool ("which one is mainstream now"), prior implementations of a design problem ("is there already a skill / repo that solved this problem"), whether a paper or post's claim applies here ("does this claim apply to us"), what an official spec or CLI does now ("what does the official source say"), the current state of practice ("where do things stand now"), or checking a claim against its primary source ("does the primary source really say that"). Also on 'search first', 'is there a package for', or /search-first. Other entry points: this repo or the local machine → Explore agent; a whole article's fact-check → the writing repo's fact-checker; bug fixes, refactors and config edits → implementation-chain.
context-sync
Audit and fix project documentation — detect role overlaps between context files (CLAUDE.md, ADR, README, graph.jsonld), migrate misplaced content, check freshness against code, and create missing docs. One command to keep all project context healthy.
agent-stocktake
Audit ~/.claude/agents/*.md (subagent definitions) for description-layer residency cost, body-layer quality, suppression instructions, staleness, and substrate absorption, assigning Keep/Improve/Update/Merge/Demote-to-skill/Dissolve/Retire verdicts. Use when the user says "audit my agents", "agent stocktake", "which agents should I retire or merge", "take stock of my agents", "review my agent definitions", or when the model generation changed and agent bodies written for the previous one may suppress or over-constrain the current one. NOT for — skill quality → skill-stocktake; rules → rules-stocktake; cross-checking against the runtime layer → generation-audit; whole-config GC → config-gc.
generation-audit
Single entry point for auditing the harness when a new Claude model takes one of its roles (judge tier / build tier / everyday session). Runs two checks in one pass — the runtime-layer cross-check (live system prompt + tool descriptions vs rules / CLAUDE.md / output style / skills / agents: conflict and redundancy) and the dated-pattern scan of every self-authored asset via `/claude-api prompt-audit` — then applies the line fixes under this harness's writing rules and hands asset-level verdicts to rules-stocktake / skill-stocktake / agent-stocktake. Invoke with /generation-audit when a new Claude model takes a harness role. NOT for — rewriting one skill (skill-creator); routine stocktakes (call them directly); rule compliance (skill-comply); whole-config GC (config-gc).
learn-eval
Extract a reusable pattern from the current session, judge it Save / Improve then Save / Absorb / Drop against a grounding checklist, and route every Save to a destination something actually reaches — absorbed into an existing skill / rule / doc section, or promoted to a real skill via skill-creator. Use when the user says "save what we learned this time", "run learn-eval" or /learn-eval. There is no notes parking lot: if nothing would route to it, the verdict is Drop. NOT for mining past sessions (session-judgment-mining), auditing skills (skill-stocktake), or distilling rules (rules-distill).
rules-distill
Scan installed skills to extract principles that belong in the always-loaded rules layer (environment-specific facts, wiring, and traps — not general principles the substrate already applies) and distill them into rules — append to, revise, or create rule files. Use when the user says "distill rules", "/rules-distill", "promote patterns to rules", "what principles should become rules", after installing new skills, or when a skill-stocktake surfaces recurring patterns. NOT for auditing skill quality (that is skill-stocktake) and NOT for editing a single skill (that is skill-creator).
rules-stocktake
Audit ~/.claude/rules (always-loaded behavioral rules) for residency cost, staleness, redundancy, broken skill pointers, and substrate absorption, assigning Keep/Improve/Update/Merge/Demote-to-skill/Dissolve/Retire verdicts. Use when the user says "audit my rules", "rules stocktake", "which rules should be demoted or dissolved", "my rules have bloated", "take stock of my rules", or when the model generation changed and over-constraints written for the previous one may now be net-negative ("I want to revisit my rules for the new model", "I want to rightsize them"). NOT for — a whole-harness audit on a model-generation change → generation-audit (it hands the rules slice here); skill quality → skill-stocktake; promoting skill patterns INTO rules → rules-distill (this is its inverse); runtime compliance → skill-comply; whole-config GC → config-gc.
search-first
Look outside before deciding: search the live web, registries and primary sources at decision time and bring back a report the caller picks from. Use for any question that may have an answer outside this repo — choosing a library or tool ("which one is mainstream now"), prior implementations of a design problem ("is there already a skill / repo that solved this problem"), whether a paper or post's claim applies here ("does this claim apply to us"), what an official spec or CLI does now ("what does the official source say"), the current state of practice ("where do things stand now"), or checking a claim against its primary source ("does the primary source really say that"). Also on 'search first', 'is there a package for', or /search-first. Other entry points: this repo or the local machine → Explore agent; a whole article's fact-check → the writing repo's fact-checker; bug fixes, refactors and config edits → implementation-chain.
skill-comply
Visualize whether skills, rules, and agent definitions are actually followed — auto-generates scenarios at 3 prompt strictness levels, runs agents, classifies behavioral sequences, and reports compliance rates with full tool call timelines. Use when a rule's or skill's real adherence is in question or right after adding one — "is this rule actually being followed?", "measure how often this skill fires", "/skill-comply". NOT for — static quality stocktakes (→ skill-stocktake / rules-stocktake), reference-integrity checks (→ skill-health), with/without ablation (→ skill-creator §5).
skill-health
Scan the skill library for structural technical debt — dangling references where a SKILL.md names a script, bash file, agent, or sibling skill that does not exist on disk ("missing artifacts" debt), plus external skills whose directory is a symlink out of the skills root, where a local fix would be overwritten by the owning package manager. Use when the user says "scan skills for debt", "check for dangling/broken references in my skills", "skill health check", "do referenced scripts/agents still exist", "which skills are not really mine to edit", or "/skill-health". NOT for holistic skill quality verdicts (that is skill-stocktake), NOT for config GC over hooks/permissions/MCP (that is config-gc), and NOT for security scanning (that is the /claude-security plugin).
skill-stocktake
Audit installed Claude skills for quality and surface Keep/Improve/Update/Retire/Merge verdicts. Use when the user says "audit my skills", "stocktake", "review my skills", "which skills should I retire or merge", "do a quality pass over my skills", or "/skill-stocktake". NOT for creating or improving a single skill (that is skill-creator) and NOT for whole-config GC across hooks/permissions/MCP (that is config-gc).
verify-bootstrap
repo に機械ゲート（format / lint / type check / security / dependency audit / test）を立てる、または既存のゲートが古びていないか棚卸しする。Use when starting a new project, when a repo has no automated quality gate, when the user says 「lint を入れて」「この repo にゲートを立てて」「型チェックを入れたい」「静的解析を整備して」「ツールが古い」「verify を棚卸しして」, "set up linting", "add a quality gate", "bootstrap the toolchain", or invokes /verify-bootstrap. ツール表を持たない設計なので、未知のスタックでも同じ手順で使える。NOT for — 既に立っているゲートを 1 回実行するだけ（それは repo の verify entrypoint を直接実行）、ハーネス自身の設定監査（→ config-gc）、コードの意味的レビュー（→ implementation-chain の Review 群）。
task-triage
Run one cycle of the task-triage loop over a repo's task ledger — judge every open task (verify its premise in code, check its start condition against the 照合先, decide whether it is still worth doing, look for a better solution), then dispatch the accepted ones to fresh implementation sessions and act as their independent judge until the branch is merged. Use when the user says 「残タスクを見て」「タスクを整理して」「台帳を回して」「dispatch して」「未マージある？」, invokes /task-triage, or when a task ledger has grown and nobody can say what is dispatchable. NOT for consolidating scattered task files into a ledger (task-stocktake), NOT for deciding a single build-or-not question (architect), and NOT for running a task yourself.
skill-creator
skill / agent 定義を新しく書く・大幅に改修するときの入口と草稿ゲート。著者が「skill 作って」「この手順を skill にして」「agent 定義を書いて」「この skill を書き直して」と言ったとき、learn-eval が Promote を決めたとき、hooks/skill-create-notice.sh が新規作成を検知したとき、/skill-creator で使う。intent を 1 packet に固定し、隣接 skill との境界を library 全体で引き、Fable 向けの書き方で書き、fresh-context の subagent に集計しない named verdict（Publishable / Fix / Drop）を出させ、著者通読で閉じる。NOT for — 既存 skill 群の棚卸し（→ skill-stocktake）、遵守率の測定（→ skill-comply）、参照切れ・所有権の検査（→ skill-health）、公開 repo への同期（→ harness-sync）、会話からの抽出と Save/Drop 判断（→ learn-eval）。
session-judgment-mining
過去の Claude Code セッション群（~/.claude/projects/<project>/*.jsonl）を遡及的に一括発掘し、ユーザーが繰り返し下した判断・価値観を抽出して skill / rule に正本化するワークフロー。人間発話の抽出、既存資産（skills / rules / ADR / memory）とのカバレッジ照合による重複回避、価値観リファレンス（why）と判断ゲート（when/what）の二層設計判断、既存スキルとの矛盾解消（免除条項）と memory への昇格マークまでを扱う。Use when — 「過去セッションから私の判断・価値観をスキルにして」「セッション履歴を紐解いて規約化して」、同じ指摘・修正がセッションを跨いで繰り返されていると気づいたとき、memory の feedback が溜まって確率的リコール頼みになっているとき。NOT for — 過去ログから記事の問いを発見 → session-theme-mining、現行セッションからの単発パターン抽出 → learn-eval、skill 品質の監査 → skill-stocktake、既存 skill 群からの rule 蒸留 → rules-distill、会話ログの要約・議事録作成。
wiki-harvest
研究 repo セッションから LLM wiki (Obsidian Vault wiki/concept/) を read-only で走査し、その repo の主担当 concept ページから「repo の次アクションを変えうる候補」だけを抽出して、一次出典付き・landing slot マップ付きのランク付き候補台帳 (ledger) を repo の .notes/ に生成する。Use when the user invokes /wiki-harvest, asks「wiki から repo に還元して」「wiki の有益分を AKC/AAP/CA/authorship に持ってきて」, or when closing the daily-research→wiki→repo loop. wiki への書き込みは行わない（それは vault セッションの /ingest）。chat 上の自由質問は wiki-query。
harness-boundary
A design lens for adding, changing, or reviewing a mechanism (rule / skill / hook / agent / workflow / runtime extension / prompt chain) in an agent environment: it asks which of 6 layers (model capability / skill = procedural memory / values & policy / eval / data & memory / runtime) the mechanism belongs to, why it cannot be left to the model itself, whether the next model generation will make it unnecessary, and whether it is worth keeping when the runtime is swapped (Claude Code → Pi → Codex), and returns Keep / Move / Simplify / Make temporary / Delete / Defer. Use when — "should this go in the harness?", "which layer does this belong in?", "can't the model handle this itself?", "will this survive a runtime change?", "the harness is bloated", "can I add this hook / rule / workflow?", when implementation-chain's Plan judges a task to change the harness itself (rules / skills / hooks / agents / settings in ~/.claude), or /harness-boundary. Delete / Simplify count as success. NOT for — a standalone build-or
author-calibrated-eval
How to build and run a loop that polishes LLM-written reading material (body text, summaries, explanatory prose) by treating the author's reading as ground truth. Fix the materials, build a hard-case set, run blind side-by-side reads by the author, measure the ceiling with a strong model's reference draft, and keep the LLM judge dedicated to a faithfulness cutoff. Invoke with /author-calibrated-eval. NOT for — designing the judge's prompt or verdict format (→ llm-as-judge), validity of measured values and thresholds (→ measurement-discipline), rewriting a README (→ readme-writer).
repo-asset-stocktake
Audit a project repo's non-code assets — tool configs, CI/GitHub workflows, runbooks, other docs — for assets whose consumer has vanished, and assign Keep/Update/Retire/Merge verdicts. Use when the user says "audit my repo assets", "which configs/workflows/runbooks are dead", "repo asset stocktake", "take stock of my non-code assets", "find the unused configs/workflows/runbooks". NOT for — dead code → refactor-clean; doc-role overlap across CLAUDE.md/graph.jsonld/ADR/README → context-sync; ~/.claude config GC → config-gc; skills or rules → skill-stocktake / rules-stocktake.
measurement-discipline
測定に基づく主張・閾値・ガード・実験結果・観察期間を設計または評価するときの規律。Use when the user says 「この実験結果で判断していい？」「閾値を決めたい」「ガード/検査を足したい」「1 回通ったから大丈夫」「観察期間はどれくらい」「いつゲートを開く」「shadow のまま何週待つ」「この RFC 塩漬けでは」「本番より良い」「本番と比べて」, when a design places a numeric threshold, a suspicion flag, or a wait-for-N-observations condition, when a candidate is compared against production, or when a claim rests on measured data. NOT for — 計器（read-only 分布・読み値）そのものの設計（CA repo の skill read-only-instruments が正本）、LLM 判定器の設計（llm-as-judge）、ループ構造の妥当性（loop-design-check）。
review-when-watch
launchd が毎朝 06:10（jev-research-pipeline の jrp run の後）に起動する job。jrp が vault の daily-research/ に書いた新しいノート 1 本ごとに、この harness の RFC（frontmatter の review-when:）と ADR（## Review-when 節）に書かれた見直し条件を TypeSafe Jev に 1 組ずつ聞き、条件を満たしたノートを Slack に送る。model からは呼ばない — この文書は運用手引き。
jsonld-knowledge-graph
Design and ship a companion JSON-LD knowledge graph (graph.jsonld) next to llms.txt for projects with stable concept-level structure. Encodes domain entities and relationships as schema.org triples for LLM citation. Use when project has matrix / hierarchy / phase-binding structure that prose alone leaves implicit, AND that structure is stable across releases. Defers llms.txt navigator wording to llms-txt-writer.
readme-writer
README やプロジェクトのトップページ（repo を開いた人が最初に見る入口）を書く・直す・判定するときに使う。こんな時に呼ぶ — README が長い／継ぎ足しで文脈が重くなり初見で分からない、開いて数十秒で「何のプロジェクトで自分向けか」が伝わる入口にしたい、冒頭に一目で仕組みが分かる図を置きたい、著者のほかの仕事への導線を付けたい、コードの変更に README を追従させたい、README を判定だけしてほしい、GitHub の About（description / topics / homepage）が README と食い違っている。CLI でも研究 repo でも、日本語でも英語でも対象。AI 専用ドキュメント（llms.txt 等）は → llms-txt-writer、記事・エッセイは → writing-ecosystem、release に伴う version・DOI・数値の同期は → release-doi、文書間の役割の重なりの整理は → context-sync、tagline だけ欲しいときは → headline-craft。
release-doi
DOI-registered research repo (Zenodo) のリリース手順。README 多言語 / CHANGELOG / CITATION.cff / pyproject.toml / llms.txt / glossary を整合させてから tag push、Zenodo 自動採番後に新 DOI を反映し、Software Heritage archive + SWHID 記録 (intrinsic identifier 層) まで行う 4 phase + post-release ワークフロー。post-release は Wayback snapshot / Zenodo community 収載 / DeepWiki onboarding と、release を待たずに published record の metadata だけを直す retrofit 経路を含む。AKC / AAP / contemplative-agent など shimo4228 系の研究 repo で再利用する。
jev-skill-router
A Claude Code UserPromptSubmit hook that asks TypeSafe Jev which installed skill (user, plugin or project) fits the prompt — two typed requests, at most one skill name back — and either records the decision (shadow) or injects a one-line pointer (inject). Not invoked by the model: it runs as a hook (plugin install, or one line in settings.json) and this file is its operating manual.
llm-as-judge
Design pattern for LLM-as-judge evaluators — binary checks as evidence, one named holistic verdict, no score aggregation. Use when designing or reviewing any LLM-based quality gate, evaluator, judge prompt, or verdict schema; when a judge's rubric scores fluctuate between runs; when you catch yourself asking an LLM for a 1-5 score, averaging check results, or thresholding a satisfaction ratio. NOT for choosing whether a task needs deterministic or semantic processing, and NOT for the architecture-level judge+enforce state-mutation split.
llms-txt-writer
AI 向けドキュメント（llms.txt / llms-full.txt、FAQ ページ、用語集等）を書くスキル。Answer.AI llms.txt 標準準拠と GEO/AEO 静的解析の両輪で、ChatGPT / Perplexity / Gemini に引用されやすい AI-facing コンテンツを生成する。audience が AI 専用の doc に使う（README 等の人間向けには使わない）。
llms-txt-writer
AI 向けドキュメント（llms.txt / llms-full.txt、FAQ ページ、用語集等）を書くスキル。Answer.AI llms.txt 標準準拠と GEO/AEO 静的解析の両輪で、ChatGPT / Perplexity / Gemini に引用されやすい AI-facing コンテンツを生成する。audience が AI 専用の doc に使う（README 等の人間向けには使わない）。
skill-stocktake
Audit installed Claude skills for quality and surface Keep/Improve/Update/Retire/Merge verdicts. Use when the user says "audit my skills", "stocktake", "review my skills", "which skills should I retire or merge", "do a quality pass over my skills", or "/skill-stocktake". NOT for creating or improving a single skill (that is skill-creator) and NOT for whole-config GC across hooks/permissions/MCP (that is config-gc).
jsonld-knowledge-graph
Design and ship a companion JSON-LD knowledge graph (graph.jsonld) next to llms.txt for projects with stable concept-level structure. Encodes domain entities and relationships as schema.org triples for LLM citation. Use when project has matrix / hierarchy / phase-binding structure that prose alone leaves implicit, AND that structure is stable across releases. Defers llms.txt navigator wording to llms-txt-writer.
paper-ecosystem
Academic paper / preprint / position paper の執筆・レビューエコシステムの orchestrator。SSRN / arXiv / Zenodo / journal venue 向けの **harness-neutral な学術コンテンツ** を書く / レビューするときに使う。paper-writing / paper-reviewer / source-fidelity-checker / vocabulary-consistency-checker / clarity-reviewer / citation-formatter の役割境界と使い分け、Source Fidelity Rules、Vocabulary Consistency Rules、Academic Voice Rules、Reader Clarity Rules、Citation Format Rules を正本として保持する。人間向け blog / essay には `writing-ecosystem`、AI 向け doc には `llms-txt-writer` を使う。
writing-ecosystem
人間向け記事・エッセイ・ブログポスト・ニュースレターの唯一の執筆 orchestrator。project の publication channel contract を読み、中心命題 1 つの editorial brief、因果線、証拠の選択と除外、構成、執筆、title-reviewer、review panel、quality-gate、著者 GO までを統括する。Use when — 「この記事を書いて」「このテーマでエッセイにして」「原稿の論点を一つに絞って構造改稿して」のような新規執筆・全体改稿・全文の別 channel 展開。NOT for — 一文や段落だけの翻訳（→ prose-translation）、title だけ（→ headline-craft / title-reviewer）、SNS 下書き（→ x-draft）、公開 thread 返信（→ public-comment）、AI 向け docs、README、paper、媒体固有の公開操作。
paper-writing
Academic paper / preprint / position paper の draft skill。Title + outline + section drafting + abstract + references の手順正本。Primary source への直接 access を強制し、claim と cite の 1:1 mapping を author に握らせる。SSRN / arXiv / Zenodo / journal venue 向けに使う。Voice 規約・Source Fidelity 規約・Citation 規約は orchestrator skill `paper-ecosystem` を参照する。
citation-sync
研究 repo の引用 3 層 (docs 実引用 → .zenodo.json references → graph.jsonld ExternalReference) を監査し、下層から順に同期する orchestrator。旧層 4 (Wikidata P2860) は 2026-07 の governance revocation により恒久 retire (authorship-strategy ADR-0021) — 同期対象にしない。Use when the user says 「参考文献が少ない/足りない」「引用がずれてる」「citation を同期して」「引用文献を graph に反映して」, when new external papers were cited in ADR/glossary/empirical docs, or before a release of a DOI-registered repo. 単層の実装は release-doi (.zenodo.json) / jsonld-knowledge-graph (graph) に defer し、本 skill は層間の divergence 検出・curation 基準・同期順序だけを持つ。NOT for: 論文 (paper item) 自体の reference list 整備 (paper-deposit が担当)、引用を含まない repo。
when-code-when-llm
Decision framework for choosing between deterministic code (regex, keyword match, AST parse, schema validation) and LLM-based processing (classification, semantic similarity, judge) for a single task. Use when you catch yourself writing a regex for a task that keeps producing false positives or negatives, or when you are about to call an LLM for something a three-line code check would handle. Covers the structural-vs-semantic axis, the false-positive test, worked examples of both directions, and the enumerate/decide split for tasks where detection is structural but resolution needs judgment.
repair-discipline
バグ修正・残課題・schema/storage 変更に着手するときの規律。Use when the user says 「このバグ直して」「残課題をやって」「この schema を変えたい」, when picking up a stale task file, or when a fix touches storage formats or shared gates. NOT for — chain の種別とレビュー条件の判定（implementation-chain）、TDD の手順（tdd）、台帳全体の棚卸し（task-stocktake — 本 skill は 1 件着手時の照合のみ）。
prompt-perturb
同じ手筋・いつもの skill ばかりで進む作業に、文脈を持たない検索者（prompt-forager agent）が外部の創造技法カタログ・プロンプト集から異角度プロンプトを取ってきて注入する多様性注入 skill。ブレインストーミングしたい、いつもと違う角度のアイデアが欲しい、発想がマンネリ・局所解に嵌っている、同じようなアプローチばかり出てくる、と感じたとき、または /prompt-perturb <目的の一行> で使う。正解・最適解の探索には使わない（それは search-first）、プロンプトの品質改善にも使わない（それは prompt-writer agent）。
authorship-strategy
著者戦略の具体案を評価するとき、または既存の判断枠組みの適用・説明を求められたときに使う。「この案を著者戦略の観点で評価して」「採用時の懸念を確認して」「この戦略を説明して」。NOT for — 自由な壁打ち、次のアイデア出し、日常のコーディング。
repo-asset-stocktake
Audit a project repo's non-code assets — tool configs, CI/GitHub workflows, runbooks, other docs — for assets whose consumer has vanished, and assign Keep/Update/Retire/Merge verdicts. Use when the user says "audit my repo assets", "which configs/workflows/runbooks are dead", "repo asset stocktake", "take stock of my non-code assets", "find the unused configs/workflows/runbooks". NOT for — dead code → refactor-clean; doc-role overlap across CLAUDE.md/graph.jsonld/ADR/README → context-sync; ~/.claude config GC → config-gc; skills or rules → skill-stocktake / rules-stocktake.
context-sync
Audit and fix project documentation — detect role overlaps between context files (CLAUDE.md, ADR, README, graph.jsonld), migrate misplaced content, check freshness against code, and create missing docs. One command to keep all project context healthy.
skill-comply
Visualize whether skills, rules, and agent definitions are actually followed — auto-generates scenarios at 3 prompt strictness levels, runs agents, classifies behavioral sequences, and reports compliance rates with full tool call timelines. Use when a rule's or skill's real adherence is in question or right after adding one — "is this rule actually being followed?", "measure how often this skill fires", "/skill-comply". NOT for — static quality stocktakes (→ skill-stocktake / rules-stocktake), reference-integrity checks (→ skill-health), with/without ablation (→ skill-creator §5).
skill-health
Scan the skill library for structural technical debt — dangling references where a SKILL.md names a script, bash file, agent, or sibling skill that does not exist on disk ("missing artifacts" debt), plus external skills whose directory is a symlink out of the skills root, where a local fix would be overwritten by the owning package manager. Use when the user says "scan skills for debt", "check for dangling/broken references in my skills", "skill health check", "do referenced scripts/agents still exist", "which skills are not really mine to edit", or "/skill-health". NOT for holistic skill quality verdicts (that is skill-stocktake), NOT for config GC over hooks/permissions/MCP (that is config-gc), and NOT for security scanning (that is the /claude-security plugin).
rules-distill
Scan installed skills to extract principles that belong in the always-loaded rules layer (environment-specific facts, wiring, and traps — not general principles the substrate already applies) and distill them into rules — append to, revise, or create rule files. Use when the user says "distill rules", "/rules-distill", "promote patterns to rules", "what principles should become rules", after installing new skills, or when a skill-stocktake surfaces recurring patterns. NOT for auditing skill quality (that is skill-stocktake) and NOT for editing a single skill (that is skill-creator).
learn-eval
Extract a reusable pattern from the current session, judge it Save / Improve then Save / Absorb / Drop against a grounding checklist, and route every Save to a destination something actually reaches — absorbed into an existing skill / rule / doc section, or promoted to a real skill via skill-creator. Use when the user says "save what we learned this time", "run learn-eval" or /learn-eval. There is no notes parking lot: if nothing would route to it, the verdict is Drop. NOT for mining past sessions (session-judgment-mining), auditing skills (skill-stocktake), or distilling rules (rules-distill).
rules-stocktake
Audit ~/.claude/rules (always-loaded behavioral rules) for residency cost, staleness, redundancy, broken skill pointers, and substrate absorption, assigning Keep/Improve/Update/Merge/Demote-to-skill/Dissolve/Retire verdicts. Use when the user says "audit my rules", "rules stocktake", "which rules should be demoted or dissolved", "my rules have bloated", "take stock of my rules", or when the model generation changed and over-constraints written for the previous one may now be net-negative ("I want to revisit my rules for the new model", "I want to rightsize them"). NOT for — a whole-harness audit on a model-generation change → generation-audit (it hands the rules slice here); skill quality → skill-stocktake; promoting skill patterns INTO rules → rules-distill (this is its inverse); runtime compliance → skill-comply; whole-config GC → config-gc.
readme-writer
README やプロジェクトのトップページ（repo を開いた人が最初に見る入口）を書く・直す・判定するときに使う。こんな時に呼ぶ — README が長い／継ぎ足しで文脈が重くなり初見で分からない、開いて数十秒で「何のプロジェクトで自分向けか」が伝わる入口にしたい、冒頭に一目で仕組みが分かる図を置きたい、著者のほかの仕事への導線を付けたい、コードの変更に README を追従させたい、README を判定だけしてほしい、GitHub の About（description / topics / homepage）が README と食い違っている。CLI でも研究 repo でも、日本語でも英語でも対象。AI 専用ドキュメント（llms.txt 等）は → llms-txt-writer、記事・エッセイは → writing-ecosystem、release に伴う version・DOI・数値の同期は → release-doi、文書間の役割の重なりの整理は → context-sync、tagline だけ欲しいときは → headline-craft。
release-doi
DOI-registered research repo (Zenodo) のリリース手順。README 多言語 / CHANGELOG / CITATION.cff / pyproject.toml / llms.txt / glossary を整合させてから tag push、Zenodo 自動採番後に新 DOI を反映し、Software Heritage archive + SWHID 記録 (intrinsic identifier 層) まで行う 4 phase + post-release ワークフロー。post-release は Wayback snapshot / Zenodo community 収載 / DeepWiki onboarding と、release を待たずに published record の metadata だけを直す retrofit 経路を含む。AKC / AAP / contemplative-agent など shimo4228 系の研究 repo で再利用する。
context-sync
Audit and fix project documentation — detect role overlaps between context files (CLAUDE.md, CODEMAPS, ADR, README), migrate misplaced content, check freshness against code, and create missing docs. One command to keep all project context healthy.
learn-eval
Extract a reusable pattern from the current session, judge it Save / Improve then Save / Absorb / Drop against a grounding checklist, and route every Save to a destination something actually reaches — absorbed into an existing skill / rule / doc section, or promoted to a real skill via skill-creator. Use when the user says 「今回の学びを残して」「learn-eval して」 or /learn-eval. There is no notes parking lot: if nothing would route to it, the verdict is Drop. NOT for mining past sessions (session-judgment-mining), auditing skills (skill-stocktake), or distilling rules (rules-distill).
repo-asset-stocktake
Audit a project repo's non-code assets — tool configs, CI/GitHub workflows, runbooks, other docs — for assets whose consumer has vanished, and assign Keep/Update/Retire/Merge verdicts. Use when the user says "audit my repo assets", "which configs/workflows/runbooks are dead", "repo asset stocktake", 「非コード資産を棚卸しして」「使われてない設定/workflow/runbook を洗い出して」. NOT for — dead code → refactor-clean; doc-role overlap across CLAUDE.md/CODEMAPS/ADR/README → context-sync; ~/.claude config GC → config-gc; skills or rules → skill-stocktake / rules-stocktake.
rules-distill
Scan installed skills to extract principles that belong in the always-loaded rules layer (environment-specific facts, wiring, and traps — not general principles the substrate already applies) and distill them into rules — append to, revise, or create rule files. Use when the user says "distill rules", "/rules-distill", "promote patterns to rules", "what principles should become rules", after installing new skills, or when a skill-stocktake surfaces recurring patterns. NOT for auditing skill quality (that is skill-stocktake) and NOT for editing a single skill (that is skill-creator).
rules-stocktake
Audit ~/.claude/rules (always-loaded behavioral rules) for residency cost, staleness, redundancy, broken See-skill pointers, and substrate absorption, assigning Keep/Improve/Update/Merge/Demote-to-skill/Dissolve/Retire verdicts. Use when the user says "audit my rules", "rules stocktake", "which rules should be demoted or dissolved", 「rules が肥大化してきた」「ルールを棚卸しして」, or when the model generation changed and over-constraints written for the previous one may now be net-negative (「新しいモデルに合わせて rules を見直したい」「rightsize したい」). NOT for — skill quality → skill-stocktake; promoting skill patterns INTO rules → rules-distill (this is its inverse); runtime compliance → skill-comply; whole-config GC → config-gc.
search-first
Search npm / PyPI / MCP / GitHub / existing skills before writing code for any new feature, integration, library selection, or utility. Use whenever the user says 'add X functionality', 'implement Y', 'set up Z', 'integrate W', asks 'what library should I use for...', 'is there a package/client/MCP for...', proposes a specific tool while open to alternatives, or hits the planning.md wiring that routes dependency additions and self-built utilities here first. Especially when the task adds a dependency, picks between tools, or builds a utility that likely already exists (parser, checker, converter, linter, CI step, E2E framework, payment / auth / API client). DO NOT use for bug fixes, refactoring, config value edits, file summarization, or throwaway scripts whose approach the user already fully specified.
skill-comply
Visualize whether skills, rules, and agent definitions are actually followed — auto-generates scenarios at 3 prompt strictness levels, runs agents, classifies behavioral sequences, and reports compliance rates with full tool call timelines
skill-health
Scan the skill library for structural technical debt — dangling references where a SKILL.md names a script, bash file, agent, or sibling skill that does not exist on disk ("missing artifacts" debt), plus external skills whose directory is a symlink out of the skills root, where a local fix would be overwritten by the owning package manager. Use when the user says "scan skills for debt", "check for dangling/broken references in my skills", "skill health check", "do referenced scripts/agents still exist", "which skills are not really mine to edit", or "/skill-health". NOT for holistic skill quality verdicts (that is skill-stocktake), NOT for config GC over hooks/permissions/MCP (that is config-gc), and NOT for security scanning (that is the /claude-security plugin).
skill-stocktake
Audit installed Claude skills for quality and surface Keep/Improve/Update/Retire/Merge verdicts. Use when the user says "audit my skills", "stocktake", "review my skills", "which skills should I retire or merge", "do a quality pass over my skills", or "/skill-stocktake". NOT for creating or improving a single skill (that is skill-creator) and NOT for whole-config GC across hooks/permissions/MCP (that is config-gc).
paper-ecosystem
Academic paper / preprint / position paper の執筆・レビューエコシステムの orchestrator。SSRN / arXiv / Zenodo / journal venue 向けの **harness-neutral な学術コンテンツ** を書く / レビューするときに使う。paper-writing / paper-reviewer / source-fidelity-checker / vocabulary-consistency-checker / clarity-reviewer / citation-formatter の役割境界と使い分け、Source Fidelity Rules、Vocabulary Consistency Rules、Academic Voice Rules、Reader Clarity Rules、Citation Format Rules を正本として保持する。人間向け blog / essay には `writing-ecosystem`、AI 向け doc には `llms-txt-writer` を使う。
paper-writing
Academic paper / preprint / position paper の draft skill。Title + outline + section drafting + abstract + references の手順正本。Primary source への直接 access を強制し、claim と cite の 1:1 mapping を author に握らせる。SSRN / arXiv / Zenodo / journal venue 向けに使う。Voice 規約・Source Fidelity 規約・Citation 規約は orchestrator skill `paper-ecosystem` を参照する。
when-code-when-llm
Decision framework for choosing between deterministic code (regex, keyword match, AST parse, schema validation) and LLM-based processing (classification, semantic similarity, judge) for a single task. Use when you catch yourself writing a regex for a task that keeps producing false positives or negatives, or when you are about to call an LLM for something a three-line code check would handle. Covers the structural-vs-semantic axis, the false-positive test, worked examples of both directions, and the enumerate/decide split for tasks where detection is structural but resolution needs judgment.
citation-sync
研究 repo ��引用 3 層 (docs 実引用 → .zenodo.json references → graph.jsonld ExternalReference) を監査し、下層から順に同期する orchestrator。旧層 4 (Wikidata P2860) は 2026-07 の governance revocation により恒久 retire (authorship-strategy ADR-0021) — 同期対象にしない。Use when the user says 「参考文献が少ない/足りない」「引用がずれてる」「citation を同期して」「引用文献を graph に反映して」, when new external papers were cited in ADR/glossary/empirical docs, or before a release of a DOI-registered repo. 単層の実装は release-doi (.zenodo.json) / jsonld-knowledge-graph (graph) に defer し、本 skill は層間の divergence 検出・curation 基準・同期順序だけを持つ。NOT for: 論文 (paper item) 自体の reference list 整備 (paper-deposit が担当)、引用を含まない repo。
implementation-chain
実装に着手する前に task 種別（feat / fix / refactor / chore / prototype / writing）を判定し、その種別に対応する agent chain（Plan → Phase 0 → TDD → Review 群 → Doc Sync → Verify）を plan に front-load するための判断表。Use when starting to implement a feature, fix a bug, refactor, or write a document and you need to decide which reviewers and gates apply — 「これから実装する」「chain を組む」「どのレビューを回すべきか」。writing 種別の orchestrator skill へのルーティング表と早期停止条件もここが正本。NOT for — chain 内の各ステップの実装詳細（それは search-first / tdd / codex-review / writing-ecosystem 等の各 skill）、既に chain が確定した後の実行。
adr-writer
Record a design decision as an Architecture Decision Record (ADR) in the project's `docs/adr/` directory. Use this skill whenever the user says "let's ADR this", "record this decision", "write an ADR for X", or when context-sync Phase 3 needs to extract a buried decision. The skill resolves the target ADR directory from cwd, picks the next sequence number with no collision, writes the 7-section body (incl. `Review-when` expiry conditions) in the main loop, runs the mechanical evidence and the adr-reviewer, and updates the ADR index. Also the canonical place for the filing bar — an ADR is written only for a mechanism / gate / threshold / agent-tier change that other artifacts cite, or for superseding / annotating a prior ADR; everything else goes into the commit body. Works across any repo — auto-detects or creates `docs/adr/` from the repo root.
harness-sync
ローカル harness (~/.claude) の origin-filtered コンポーネントを公開 repo (claude-harness 集約 repo + 単独 skill repo 群) へ一方向同期する。Use when the user says 「ハーネスを公開 repo に同期して」「claude-harness を更新して」「スキルを公開して」「skill repo を同期して」 or invokes /harness-sync. NOT for: 公開 repo から ~/.claude への逆方向取り込み、ECC 等外部 origin の公開判断、汎用化 fork を持つ curated skill repo (script 同期は汎用化を壊すため手動 curation)。
headline-craft
「開かせる一行」を作る候補生成スキル。記事タイトル・README tagline・subtitle・SNS告知文を、具体性・ベネフィット・誠実な好奇心ギャップ・検索/フィードの技法から生成する。Use when the user asks for タイトル案・キャッチコピー・タグライン・見出し候補、or a frozen draft needs title candidates. NOT for — 公開記事候補の点検（→ title-reviewer）、煽り・クリックベイト、topics / emoji、platform文字数の定義。
hf-sync
Hugging Face Datasets mirror sync for graph.jsonld-bearing research repos. `<Owner/dataset>` を引数に取り、cwd の graph.jsonld を flatten して graph.jsonl と一緒に HF dataset へ upload する。`release-doi` Phase 4 末尾の `gh release create` 後、または ad-hoc resync で起動する（tag push は webhook を発火させないので契機にしない）。Local の `hf auth login` token を使うので GitHub Actions / CI auth は不要。
task-stocktake
Consolidate a repo's pending-task tracking into its single task ledger (default .notes/TASKS.md) — bootstrap it if missing, sweep handoff / audit / remaining-issues files and auto-memory for stray task lines, verify pending entries against git log and actual code, archive detail files of completed tasks. Use when the user says 「残タスクを棚卸しして」「タスク台帳を作って/整理して」「残っているタスクは？」, "task stocktake", when task lines are scattered across notes files, or when a repo's ledger may be stale. Also the 正本 for two questions the library routes here: 状態語をどれにするか（draft / accepted / in_progress / blocked と終端 5 語、`blocked` の入場条件）と、レビュー指摘を起票すべきか（起票規律の足切りと producer 引用）— 「この状態でいい？」「blocked にしていい？」「このレビュー指摘は起票する？」. NOT for — skills → skill-stocktake; rules → rules-stocktake; repo non-code assets → repo-asset-stocktake; in-session todos → harness task tools.
rfc-writer
公開 rfcs/ 台帳へ 1 エントリを起票する手順と規約の唯一の正本（足切り → 採番 → 様式 → 公開規約 → spawn 接続 → index 行）。Use when the user says 「これ起票して」「RFC にしておいて」「提案を台帳に載せて」, when harness-boundary の Defer や task-triage の起票提案が承認されたとき, or /rfc-writer. 各 repo の rfcs/README.md は薄いポインタ + index のみで、規約本文はここ以外に書かない。NOT for — 状態語彙の定義と台帳の棚卸し（→ task-stocktake が正本）、起票するかの足切り判定のうち review 指摘の loop-breaking + producer 規律（→ task-stocktake「レビュー指摘の起票規律」）、open タスクの判定・dispatch・検収（→ task-triage）、決定の記録（→ adr-writer。rfcs は提案・未決、ADR は決定）、単一表 .notes/TASKS.md への 1 行起票（→ rule task-tracking の形のまま）。
growth-fable
Fable — `.growth/NORTH_STAR.md` に到達できるように施策を考え、worker に出し、結果を `.growth/EXPERIMENTS.md` に記録する役。Use when — 「growth cycle 回して」「施策を考えて」「実験の結果を見て」、/growth-fable。NOT for — 北極星の設定・修正（→ growth-astra）。
jev-judgment-design
How to hand over judgments and decide accept/reject when moving closed judgments an LLM used to make (is this source relevant, is it new, how strong is the evidence) to TypeSafe's Jev. Putting what the judgment is made against into state, the bottom tier of a Score, Jev answers and code decides, the unit of judgment, sources that must pass (canary), calling from Pydantic AI. Use when — "I want to replace the LLM's judgment with Jev", "build a relevance judgment with Jev", "Jev's judgment lets everything through", or before designing Jev into screening / triage / rerank. NOT for — Jev's API, docs, or general guidance on choosing primitives (→ plugin skill `typesafe:typesafe-ai`; read that first), the Claude Code skill-selection hook (→ `jev-skill-router`), designing an LLM as the judge (→ `llm-as-judge`).
x-draft
daily-research のリサーチレポートから X (Twitter) 投稿用の日本語長文下書きをオンデマンド生成する対話 skill。Use when the user says 「X に投稿したい」「X 用の下書き作って」「これポストしたい」「ツイートにして」, invokes /x-draft, or mentions turning a daily-research report into a social media post — even if they just say 「今朝の akc のやつ X に流したい」 like shorthand. pull 型: 通知もノルマもなく、ユーザーがレポートを読んで投稿したいと思ったときだけ呼ぶ。軽量事故ゲート (一次ソース再確認 + 3 日陳腐化チェック) と脱 AI-tell 改稿を通した、コピペ 1 回で投稿できる長文 1 ポストを出力する。NOT for: 記事・エッセイ執筆（→ writing-ecosystem）、公開スレッドへの返信（→ public-comment）、タイトル・一行コピーだけの生成（→ headline-craft）、X への自動投稿（本 skill は下書きまで — 投稿は人間が行う）。
prose-translation
日本語⇄英語の voice 保持翻訳スキル（**両方向**）。エッセイ・記事・README・ADR 等の人間向け prose を、出力先の publication channel contract が宣言する register と原文の確度を保って自然に訳す。逐語訳でも MT でもなく、term-lock + 2-pass（訳→自己添削）+ back-translation QA で品質を担保する。JA→EN は英語 AI-slop の自己添削、EN→JA は訳す-by-default の term policy と脱翻訳調 passを追加する。AI 向け doc は llms-txt-writer、学術 citation format は citation-formatter、shared craft は writing-ecosystemへ defer。
review-to-lint
A procedure for extracting the mechanically decidable items from an existing reviewer's (agent / review skill) checklist, or from past sessions' reviewer history, into a deterministic script, thinning the reviewer down to semantic checks only. Use via /review-to-lint when the author says "turn this reviewer into a lint", "absorb the review into a lint", "move the mechanical checks into a script", "find what in the history can be linted", or when a reviewer's findings show repeated mechanical items. NOT for — creating a new reviewer (→ skill-creator), changing the semantic criteria themselves (each reviewer owns them), designing a judge (→ llm-as-judge), re-extracting reviewers that already have an evidence script (done for readme-writer / adr-writer).
ai-native-preprint-submission
AI-native 出版プラットフォーム (aiXiv / AiraXiv 等、AI 審査・agent 読者を持つ preprint archive) へ、deposit 済み論文を投稿するワークフロー。経路は 2 つ — (A) Web UI + browser automation (初回投稿の default。Claude がフォーム入力を代行し、アカウント作成・ファイル選択・送信クリックは著者が行う人間ゲート分担)、(B) 著者発行の API key による MCP 投稿 (2 本目以降・著者が明示委任した場合)。Use when the user says 「aiXiv/AiraXiv に投稿して」「AI-native プラットフォームに論文を出して」「API キーで残りを投稿して」or invokes /ai-native-preprint-submission. NOT for: Zenodo/SSRN への正本 deposit (それは paper-deposit)、arXiv 投稿 (endorsement 制で別物)。
cited-source-mirror-verification
Verify a cited empirical/numeric claim against an open mirror (aiXiv, OpenAlex, Semantic Scholar, the author's own copy) before citing it. Use whenever you are about to cite a statistic, effect size, odds ratio, percentage, p-value, or empirical result you have NOT read in the primary — because the primary is access-blocked (SSRN / publisher 403, paywalled PDF), or because the claim arrived via an LLM research digest, daily-research note, or WebSearch summary (which routinely reframe a methodological artifact or a limitation as a headline finding). Especially before committing citations to a durable artifact — paper, knowledge graph, .zenodo.json, ADR, DOI repo.
collect-context
記事・エッセイを書く前の素材収集。セッション内外のコンテキストを集め、全項目ソース付きの証拠台帳（evidence dossier）— Claims Register・一次/⚠未検証の tier・セッションログ索引 — を生成する。Use when — 「素材を集めて」「証拠台帳を作って」「この作業の記事コンテキストをまとめて」、執筆に着手する前、fact-checker に渡す主張リストが要るとき。NOT for — 過去ログから記事の問いを発見（→ session-theme-mining）、テーマ・構成・タイトル等の編集判断（受け側 repo の責務。正本は受け側 repo の rules のチャンネル表、執筆 orchestrator は writing-ecosystem — zenn-content 常駐）、事実の検証そのもの（→ fact-checker agent）。収集者は推薦・提案・方向性メモを出力に書かない
en-to-ja-translation
英語→日本語の voice 保持翻訳スキル。エッセイ・研究ドキュメント・README・ADR 等の人間向け prose を、著者の声・register・発見調を保ったまま自然な日本語にする。逐語訳でも MT でもなく、term-lock（訳す-by-default／英語保持は明示例外）+ 脱翻訳調 pass +（EN→JA→EN の）back-translation QA で「英語のまま読みづらい」「専門用語が英語のまま」を潰す。英語記事を日本語にする EN→JA 翻訳タスクで使う。AI 向け doc は llms-txt-writer、学術 citation format は citation-formatter、日本語 AI-slop / Voice 規約は writing-ecosystem に defer。
ja-to-en-translation
日本語⇄英語の voice 保持翻訳スキル（**両方向**）。エッセイ・研究ドキュメント・README・ADR 等の人間向け prose を、著者の声・register・発見調を保ったまま自然な訳文にする。逐語訳でも MT でもなく、term-lock + 2-pass（訳→自己添削）+ back-translation QA で品質を担保する。JA→EN は英語 AI-slop の自己添削、EN→JA は訳す-by-default の term policy と脱翻訳調 pass（英語語順残存・冗長受動態・カタカナ乱用・「の」連鎖・直訳 idiom・接続の機械訳）を追加で適用する。日本語記事を英語にするとき、英語記事・EN 正本 README を日本語にするときに使う。AI 向け doc は llms-txt-writer、学術 citation format は citation-formatter、AI-slop / Voice / Title 規約と出典編入は writing-ecosystem、出力先の語尾はチャンネル表に defer。
paper-deposit
Deposit a finished, reviewed academic paper / position paper / preprint to a DOI registry (Zenodo) as a standalone record, optionally cross-post it to SSRN for extra reach, generate the PDF from Markdown, and cross-link the minted DOI back into a research-program repository (.zenodo.json / README / graph.jsonld / llms.txt). Use this whenever the user wants to "ship", "deposit", "publish", "register a DOI for", "put on Zenodo", or "submit to SSRN" a paper that is already written and review-passed — even if they only say "let's get this paper out". This runs AFTER paper-ecosystem review passes. It is NOT for releasing a whole repository (that is release-doi) and NOT for drafting or reviewing the paper (that is paper-writing / paper-ecosystem).
public-comment
公開の技術ピア議論への返信コメントを書く skill。GitHub discussions / issues / PR コメント・Hugging Face discussions・技術フォーラムなど、初対面の技術者が読む公開スレッドへの返信を作成・改稿・投稿するときに使う。Use when the user says 「GitHub のコメントに返信して」「discussion にコメント書いて」「issue に返信」「このスレッドに参加したい」 or asks to draft/revise/post a reply in a public technical thread. 2026 年の OSS は AI slop 危機下にあり、tell（em-dash・対比構文・triad 等）は「未レビューの生ダンプ」のシグナルとして読まれる — 本 skill は content ownership・スレッド接地・脱 tell 改稿・日本語訳併記の人間 gate までを扱う。NOT for: 記事・エッセイ（→ writing-ecosystem）、AI 向け doc（→ llms-txt-writer）、既知の相手との Slack/Discord 会話、コードの PR 本体。
wiki-query
Obsidian Vault の LLM wiki (wiki/concept/) に問い合わせ、[[ ]] 出典付きで合成回答する query。vault セッションだけでなく研究 repo (AKC / AAP / contemplative / authorship 等) のセッションからも呼べる。複数ページを横断して合成した良回答は書き戻しプロトコルで wiki/concept/ に filing する（Karpathy 原典 parity、read-write）。Use when the user invokes /wiki-query <問い>, asks 「wiki に聞いて」「wiki ではどうなってる？」, or when working in a research repo and a synthesized understanding of past daily-research notes would answer the question faster than grep. NOT for source の新規取り込み・wiki 全体の健全性チェック (それらは vault セッション専用の /ingest・/lint-wiki)。
spawn-session
新しい detached な Claude Code Remote Control セッションを Herdr 内に起動し、Claude モバイルアプリのセッション一覧に出す。生きている任意のセッションから（多くは iPhone の Remote Control 越しに）呼んで、別プロジェクトの新規セッションを Mac に触れず立ち上げる。Use when the user says 「新しいセッション立てて」「AAP のセッション開いて／立ち上げて」「contemplative のセッション作って」「spawn a (new) session」「launch a remote control session」「start a session for X」, or invokes `/spawn-session [project]`. NOT for: 既存会話の resume（`--continue`/`--resume`）、同一セッション内の文脈リセット（`/clear`）、現セッションの model 切替。
codex-review
Cross-model second opinion from the OpenAI Codex CLI (a different model family), read-only, in two seams — (1) code review of the current diff; (2) plan-stage premise challenge of a design packet (refute / missing / alternative, never a design). Opt-in only — use ONLY when the user explicitly asks with "codex review", "cross-model review", "second opinion on this diff", "別モデルでレビュー", "プランを Codex に反証させて", "前提を別モデルで叩いて", or invokes /codex-review or /codex-review --plan <file>. NOT a default step of the implementation chain (自発発火しない), NOT for letting Codex write code or design (read-only, divergence only), and NOT a replacement for the in-Claude reviewers.
herdr-delegate
Herdr の pane に別プロセスの CLI コーディングエージェント（Codex 等）を立てて、実装タスクを丸ごと委譲するワークフロー。Use when the user says 「Codex にやらせて」「E2E は Codex に委譲」「Herdr でセッション立ててタスク投げて」 or explicitly asks to delegate implementation work to another CLI agent. 前提ゲート: HERDR_ENV=1 かつユーザーの明示指示（agents.md の委譲ゲートと同一 — 有益そうというだけで自発起動しない）。herdr CLI の一般操作は skill: herdr が正本で、本 skill は委譲に特化した手順・監視レシピ・検収規律のみを持つ。NOT for — read-only の cross-model レビュー（→ codex-review）、Claude 内サブエージェントへの並列化（→ Agent tool）。
writing-ecosystem
人間向け記事・エッセイ・ブログポスト・ニュースレターの唯一の執筆 orchestrator。project の publication channel contract を読み、中心命題 1 つの editorial brief、因果線、証拠の選択と除外、構成、執筆、review panel、著者の内容 GO、title-reviewer、quality-gate までを統括する。Use when — 「この記事を書いて」「このテーマでエッセイにして」「原稿の論点を一つに絞って構造改稿して」のような新規執筆・全体改稿・全文の別 channel 展開。NOT for — 一文や段落だけの翻訳（→ prose-translation）、title だけ（→ headline-craft / title-reviewer）、SNS 下書き（→ x-draft）、公開 thread 返信（→ public-comment）、AI 向け docs、README、paper、媒体固有の公開操作。
session-theme-mining
過去の Claude Code / Codex セッションを横断し、記事になりうる未解決の問いを 0〜3 件の同格な候補カードとして発見する。Use when — 「過去セッションから記事テーマを探して」「まだ書いていない問いを発掘して」「セッション履歴から collect-context の入口を作って」。NOT for — 選択済みテーマの証拠収集（→ collect-context）、ユーザーの価値観を skill / rule に昇格（→ session-judgment-mining）、候補の採点・順位付け・タイトル作成。
session-theme-mining
過去の Claude Code / Codex セッションを横断し、記事になりうる未解決の問いを 0〜3 件の同格な候補カードとして発見する。Use when — 「過去セッションから記事テーマを探して」「まだ書いていない問いを発掘して」「セッション履歴から collect-context の入口を作って」。NOT for — 選択済みテーマの証拠収集（→ collect-context）、ユーザーの価値観を skill / rule に昇格（→ session-judgment-mining）、候補の採点・順位付け・タイトル作成。
substack-publishing
完成・レビュー済みの human essay を Substack に公開し、LLM 発見のために corpus へミラーするワークフロー。Substack が raw Markdown 非対応なための MD→HTML rich-text paste、Title/Subtitle/body のフィールド分け、タグ戦略（archive 用 ≠ 拡散用）、カバー画像プロンプトの作り方、Claude in Chrome によるエディタ自動操作（OS クリップボードへの HTML flavor 直接セット + cmd+V）、公開後の content repo `substack/` フォルダへのミラー + research repo からの cross-link、公開後の配信ファネル運用（Notes 3 型・organic recommendations・welcome email・ケイデンス）を扱う。Voice / AI-slop / Title / 出典は writing-ecosystem、翻訳は ja-to-en-translation に defer。essay を Substack に出すとき・Substack の配信運用を考えるときに使う。
authorship-strategy
著者戦略の具体案を評価するとき、または既存の判断枠組みの適用・説明を求められたときに使う。「この案を著者戦略の観点で評価して」「採用時の懸念を確認して」「この戦略を説明して」。NOT for — 自由な壁打ち、次のアイデア出し、日常のコーディング。
agent-stocktake
Audit ~/.claude/agents/*.md (subagent definitions) for description-layer residency cost, body-layer quality, suppression instructions, staleness, and substrate absorption, assigning Keep/Improve/Update/Merge/Demote-to-skill/Dissolve/Retire verdicts. Use when the user says "audit my agents", "agent stocktake", "which agents should I retire or merge", "take stock of my agents", "review my agent definitions", or when the model generation changed and agent bodies written for the previous one may suppress or over-constrain the current one. NOT for — skill quality → skill-stocktake; rules → rules-stocktake; cross-checking against the runtime layer → generation-audit; whole-config GC → config-gc.
generation-audit
Single entry point for auditing the harness when a new Claude model takes one of its roles (judge tier / build tier / everyday session). Runs two checks in one pass — the runtime-layer cross-check (live system prompt + tool descriptions vs rules / CLAUDE.md / output style / skills / agents: conflict and redundancy) and the dated-pattern scan of every self-authored asset via `/claude-api prompt-audit` — then applies the line fixes under this harness's writing rules and hands asset-level verdicts to rules-stocktake / skill-stocktake / agent-stocktake. Invoke with /generation-audit when a new Claude model takes a harness role. NOT for — rewriting one skill (skill-creator); routine stocktakes (call them directly); rule compliance (skill-comply); whole-config GC (config-gc).
jev-skill-router
A Claude Code UserPromptSubmit hook that asks TypeSafe Jev which installed skill (user, plugin or project) fits the prompt — two typed requests, at most one skill name back — and either records the decision (shadow) or injects a one-line pointer (inject). Not invoked by the model: it runs as a hook (plugin install, or one line in settings.json) and this file is its operating manual.
llm-as-judge
Design pattern for LLM-as-judge evaluators — binary checks as evidence, one named holistic verdict, no score aggregation. Use when designing or reviewing any LLM-based quality gate, evaluator, judge prompt, or verdict schema; when a judge's rubric scores fluctuate between runs; when you catch yourself asking an LLM for a 1-5 score, averaging check results, or thresholding a satisfaction ratio. NOT for choosing whether a task needs deterministic or semantic processing, and NOT for the architecture-level judge+enforce state-mutation split.
growth-astra
Astra — GitHub follower campaign の北極星（`.growth/NORTH_STAR.md`）を書く役。初回は新規設定、2 回目以降は状況に合わせて修正する。Use when — campaign 開始時の initial pass、growth-fable からの escalation、著者が「Astra を回して」「北極星を見直して」と言ったとき、/growth-astra。NOT for — 施策の立案と実行（→ growth-fable）。
git-workflow
この環境で git コマンドを Bash 実行するときの permission 摩擦回避作法。git add / commit / push / status 等を実行する前に参照する。git 同士の && 連結は通るが、cd を git と混ぜると双方許可済みでもプロンプトする（git -C を使う）。commit メッセージに $( ) を含めない。push は sandbox 無効化が必要。
write-prompt
Generate concise LLM prompts using the lightweight prompt-writer agent. Avoids main-model overthinking.
article-stocktake
公開済みZenn/Dev.to記事の実測メトリクスを収集し、内��品質ランクと実測tierの乖離をproject-localに報告する。Use when — 月次または記事2〜3本ごとの受信状況を確認するとき。NOT for — テーマ候補の生成・順位付け、本文改稿、媒体共通の執筆フロー。
publish-article
quality-gate PASS済みの対象稿1本について、Zennのfrontmatter・preview・予約またはDev.toのdry-run・予約、公開索引、push確認を扱うproject-local公開skill。Use when — 対象となるZenn稿またはEN稿自身のglobal quality-gate PASSと著者GOの後。NOT for — 翻訳生成、prose review、security/quality判定、note/Substack投稿。
zenn-format
Zenn記事のfrontmatter、emoji/topics、Zenn固有Markdown記法の正本。Use when — Zenn原稿を作成・検証するとき、本文凍結後にtopics/emoji候補を提示するとき。NOT for — 執筆構成・voice・タイトル判定・公開��否・Dev.to/note/Substack形式。
note-publishing
完成済み原稿をnoteへ原文を保って転載する。『noteに投稿して』『この記事をnoteへ転載して』『承認済み記事をnoteで公開して』で使用。NOT for — 執筆・改稿（writing-ecosystem）、Substack投稿（substack-publishing）、候補選定・配信時刻管理（docs/note-pipeline.md）。
schedule-publish
記事バッチの公開順序と日程を 4 軸スコアリングで決定し schedule.json に反映する。投稿タイミングの値は zenn-writing.md が正本。
Showing top 100 of 119 skills by quality score. Browse the full catalog at /browse.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.