型・関数シグネチャ・モジュール構成を設計し、独立した複数案を比較してから実装する。/architect や、構造の判断を伴う実装に使う。
同じ課題に独立した複数候補を作り、評価して基準案に優れた部分を統合する。/arena や、設計・実装案の比較に使う。
Ask which skill or flow fits your situation. A router over the skills in this repo.
Use the ax CLI instead of curl + throwaway parsing scripts whenever you fetch a URL, explore an unknown web page, or extract structured data from HTML. Trigger whenever you are about to write an inline script (python3 heredoc, node -e, regex over HTML) or a bare curl for one-off web fetching, scraping, or page exploration.
変更が差分の外に及ぼす影響を調べ、成立条件を実コードの実行で確認する。影響範囲や小さな差分の安全性をレビューするときに使う。
直前の説明を専門用語に頼らない平易な言葉で言い直す。/bro や、説明をわかりやすくしてほしいという依頼に使う。
Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/spec asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
Build or adapt a local harness to drive, inspect, and profile an interactive CLI or TUI without external services. Use for CLI UX checks, startup regressions, memory leaks, hangs, prompt flows, or terminal demos.
Build or adapt a local browser/CDP harness to drive and inspect a web, IDE, or Electron UI. Use for local UI verification, screenshots, accessibility snapshots, perf profiles, visual diffs, or reproducing UI bugs.
アプリを利用者と同じ経路で検証するプロジェクト用スキルと機能マップを作る。/create-verification-skill や、検証手順をスキルにしたい依頼に使う。
Draw a software architecture, system, data-model or call-flow diagram as D2 text laid out by TALA (D2's whiteboard-style engine, open source since D2 0.9), look at it in the terminal before anyone opens an image, and check that the picture says what it claims — d2 --layout=tala x.d2 x.txt renders the layout as Unicode box drawing, --ascii-mode standard as plain ASCII for a README, and assets/d2-facts.mjs reads the drawn boxes and arrows back out of the render and holds them to a fact sheet. Loop: write .d2 → d2 fmt --check / validate → facts → terminal render → PNG → fix the text. Use when asked for a D2 diagram, an architecture diagram kept as editable text in the repo, a TALA layout, a diagram that shows in a terminal or a code block, or when the repo already has .d2 files. Not for animations or figures with a moving walk (explanatory-animation, explain-with-anim).
Build a slide deck whose source is text and whose figures are laid out by TALA — one Markdown file with a ``d2 fence per figure, compiled to a self-contained HTML deck (keyboard nav, overview grid, print-to-PDF), each figure as its own SVG, and a copy manifest. The deck is a page, so vlmkit's own gates read it: check integrity for a slide that breaks or clips, check copy --manifest for text the frame cut off, check a11y contrast for a projector. Loop: write deck.md → build → gates → fix. Use when asked for slides, a deck, a talk, a presentation, a review walkthrough, or a figure-heavy explainer that has to be presented rather than read. Not for one diagram (d2-diagram) or a moving figure (explanatory-animation`).
Remove AI-generated code slop and clean up code style
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.
Answer "how does this work / how is this structured / what does this change" with a drawn figure and a narration that follows it — a module map from the code's own imports, a walked request, a state machine, an algorithm step by step, the change map of a branch — produced with vlmkit-anim, checked against the facts it draws, and delivered as an SVG / GIF next to the prose. Use whenever the user asks to explain, walk through, show the structure of, or illustrate code, a repository, a flow, a protocol, a PR, or a bug, and a picture with four or more things and their relations would carry the answer better than a paragraph. The explanation is the deliverable; the picture is its evidence. Scene mechanics are in explanatory-animation.
特定の読み手に向けて、概念・PR・設計を「冗長にならない水準」の速習資料として説明し、図と主張を道具で検証する。読み手のペルソナ（既に知っていること・知らないこと・読み方）を質問と公開情報から作り、その差分だけを書く。図は vlmkit-anim で事実シートに照らして描き、本文に引用するコード・出力は再実行して照合し、HTML は vlmkit のゲートに通す。Use when the user says "explain this to me / to person", "速習資料", "解説ドキュメント", "この PR を理解したい", "わかるように説明して", "I can't keep up with what the agent wrote", "この PR を 人 が理解できるように説明して", or when a reviewer asks what a change does. Use it even for a small diff or a chat-only answer whenever a named reader (a reviewer, an on-call engineer, a teammate) is given. Also when the user wrote an explanation themselves and lost confidence in it.
1 本の速習資料では収まらない、章立ての学習資料（topic-book/01-quickstart.md, 02-….md …）を、読み手のペルソナに合わせて設計・執筆・検証する。章ごとの学習目標と理解度チェックの対応、概念を導入より前に使わない順序、章の読了時間の予算、「未完成なら落ち、答えなら通る」演習、book.json から生成する章の依存図を、verify-book.mjs で検査し、各章の出力・図・HTML は explainer の verify-doc.mjs で検査する。Use when the user asks for a book, a tutorial series, a course, "学習資料", "チュートリアル", "ハンズオン", "本にまとめて", "章立てで", "01-quickstart から", or when an explainer crash course would exceed ~20 minutes or needs exercises.
Explain an algorithm, protocol, data structure, state machine, or architecture as a checked animation or still figure with vlmkit-anim — one JSON scene (a kind plus intent, never coordinates) compiled to SVG + Web Animations, a GIF, or a cropped figure, and checked against what it claims (semantic checks, layout geometry, a fact sheet with --expect, why for the layout's own reasons). Also draws a module map from a directory's import graph, a repository's architecture, the change map of a branch, the diff of two maps, and imports mermaid the repo already has. Use when asked to animate, illustrate, diagram, draw a dependency / module / architecture map, explain how something works step by step, or embed such a figure in docs. Not a VRT gate — vlmkit-anim is its own binary (@mizchi/vlmkit-anim).
既存の手順で扱いきれない大きな変更について、検証できる単位と仮説検証の手順を組み立てる。/figure-it-out や、大規模な移行の設計・実装に使う。
Beta readers for any draft, run by simulating how a real reader experiences it, moment by moment. A skim gate, a no-lookahead timed read producing an attention transcript with quit points, a recall test of what a reader remembers the next day, and a trust ledger of the implied author. Use when the user asks for a beta read, beta readers, test readers, human review, reader review, to read something like a human, to be a first reader, whether a piece holds attention or will actually get read, for a quick read of whether a busy skimmer would even open a post, what readers will remember or take away tomorrow, where readers stop reading or bounce, or why a draft still feels off or hollow after anti-slop or humanizer edits. Final gate before publishing; reports where the reading broke; never rewrites.
A relentless interview to sharpen a plan or design.
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
Compact the current conversation into a handoff document for another agent to pick up.
実コードから仕組み・処理の流れ・配置先・責務を説明する。どう動くか、どの層に置くか、変更前の構造理解を求める依頼に使う。設計意図の履歴調査は why を使う。
Implement a piece of work based on a spec or set of tickets.
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
独立した複数の Claude レビュアーで同じ対象を批判的に検証し、盲点や反証をまとめる。/interrogate や、設計・コードを厳しくレビューする依頼に使う。
既存の検証スキルと機能マップを実装・実動作と照合し、確認できた不整合を直す。/maintain-verification-skill や、検証手順の棚卸しに使う。
Comment Sicko にコメントの妥当性を調べさせ、採用した指摘を反映する。/no-comments や、コメントで補っている設計を見直す依頼に使う。
pstack の設計原則と作業手順を使い、調査・設計・実装・検証を進める。/poteto-mode、poteto の流儀で作業してほしいという依頼に使う。
検証やエラー処理を CLI・設定・ネットワークなどの境界へ集め、内部の型と純粋な処理を活かす。境界の設計時に使う。
繰り返せるツール・スクリプトで変更や検証を実行する。手作業の反復が発生する編集・移行・分析に使う。
繰り返す注意事項を lint・型・メタデータ・実行時検査に落とし込む。同じ修正や指示が再発したときに使う。
前例のない UI・設計判断で複数の試作を比べる。単一案に決める前に設計空間を探索するときに使う。
機能の範囲や UX の判断を利用者の体験から決める。実装都合と体験の品質が競合するときに使う。
症状を再現して原因までたどり、根本を直す。不具合調査・修正で使う。
ロジックを書く前に型・データ構造・共有状態を決める。実装の土台や作業順を設計するときに使う。
大量の出力やファイルを扱う作業で、主会話に残す要点と分担する調査を整理する。コンテキストの消費が大きいときに使う。
削除と必要最小限の変更で問題を解く。リファクタリングや抽象化・層の追加を判断するときに使う。
中断や再試行の後も同じ状態へ収束する処理を設計する。コマンド・初期化・処理ループを作るときに使う。
新しい内部 API へ呼び出し側を移し、旧 API を同じ作業で取り除く。内部 API の移行に使う。
処理を読むために追う層と覚える状態を減らす。追跡しにくいコードの設計・レビューに使う。
分岐や状態の前提をデータ構造・状態機械・型で表現する。状態を持つ処理や重複した条件を設計するときに使う。
可逆的な作業を進めて具体的な結果を示す。作業を進めるか確認するかの判断に使い、ユーザーの依頼範囲に従う。
移行の最終形へ収束する作業順を組み立てる。段階的な書き換えや移行で中間実装の要否を判断するときに使う。
実物・実値・実行結果を確認して作業の完了を示す。完了報告前の検証に使う。
新しい要件を最初から前提にした構造を考える。既存設計へ要件を統合するときに使う。
並列処理の共有書き込みを分離し、共有が本当に必要な部分だけ直列化する。同じファイル・ブランチ・状態への競合を設計するときに使う。
各段階で結果を確かめられる単位に分割して順に進める。多段階の変更や移行を計画するときに使う。
不要なコードや参照を除去してから変更を加える。追加・リファクタリング・書き換えの作業順を決めるときに使う。
不正な状態を表しにくい型、境界のパース、網羅的な分岐を設計する。型付き言語の実装・シグネチャのレビューに使う。
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
Use when you need to resolve an in-progress git merge/rebase conflict.
判断・理由・根拠・結果を追跡できる TSV の意思決定ログを残す。/show-me-your-work や、長い作業の判断を後からレビューしたい場合に使う。
複数の Claude ワーカーで調査範囲を分担、または同じ課題を独立して試し、結果を集約する。/swarm や、並列調査・候補比較に使う。
失敗するテストから修正を進める。TDD・失敗テスト・回帰テストを明示的に依頼された場合、または不具合に安価で明確なローカルテストがある場合に使う。
how と why の調査をつなぎ、変更や仕組みを理解できる説明にまとめる。/teach や、変更・サブシステムをきちんと理解したい依頼に使う。
技術文書の構造と文章を整える。文書、RFC、README、PR 説明、コミットメッセージの作成・レビューに使う。
Invoke whenever writing, changing, reviewing, or sweeping tests. Authoring gate for new tests plus audit workflow for low-value, implementation-coupled, or duplicative tests and the test-only production seams they demand.
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.
Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, published to the configured tracker (edges as text in one file per ticket locally, or native blocking links on a real tracker).
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
型の設計と TypeScript コードの品質を確認する。.ts・.tsx ファイルを読む、書く、レビューするときに使う。
抽象的で冗長な AI らしい言い回しを削り、具体的で読みやすい文章にする。説明・文書・返信などの文章を書くときに使う。
Stop. That last message did not land: re-pitch it.
Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.
Git の履歴と利用可能な外部情報から設計判断の理由を調べ、根拠付きで説明する。なぜこの構造・選択になったかという依頼に使う。実行時の仕組みの説明は how を使う。
Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.