using-skills について
using-skills は、タスクをドメインルーターや個別スキルに振り分けるエージェントスキルの一覧です。開発、デザイン、検証、委任、調査、執筆を扱い、使用前に最新のスキル資料を確認するよう定めています。
主な機能
- 01タスクをドメインスキルへ振り分け
- 02デザインルーター経由でビジュアル作業を処理
- 03開発と検証のスキルを掲載
- 04委任、調査、執筆を網羅
- 05ルーティング階層と最新性の確認
活用シーン
- 01コーディング作業に合うスキルの確認
- 02ビジュアル作業をデザイン工程へ振り分け
- 03検証や調査に使うスキルの選定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ ohyeh/ agent-scripts --skill using-skillsインストール後、Claude Code で/using-skillsを入力して読み込まれたか確認します。
詳細
using-skills
意図に応じて振り分けます。以下の名前はすべて skills-lock.json に登録されたインストール済みのスキルなので、ここにある名前は必ずこのマシンで解決できます。
~/.claude/CLAUDE.md のカーネル振り分けインデックスが最優先です。カーネルがトリガー(委任、完了/行き詰まりの主張、受け入れ条件の不明確さ、再試行、ループ状の作業、コード変更、出力形式)を示した場合、そのルートを優先します。これらのスキルの一部は、すべてのロック名を一か所で解決できるよう、以下にも記載しています。この行は参照用であり、別の判断を示すものではありません。
最大2ホップです:using-skills → ドメインルーター → メンバー。ドメインルーターの中から、ここへ戻るルートをたどってはいけません。行動する前に、最新の SKILL.md を読んでください。古い登録内容の記憶を頼りに行動してはいけません。
Mode 列:Skill() = モデルから呼び出し可能 · manual = SKILL.md をインラインで読むか、スラッシュコマンドを使う · via-router = 指定されたルーターを経由する
ホップ1:ドメインルーター
| ルーター | 使う場面 | モード |
|---|---|---|
using-design-skills | Webページ、アプリ画面、HTML成果物、チャート、アーティファクト、モーションに加え、モジュールやAPIのインターフェース設計など、視覚に関するあらゆる作業 | Skill() |
using-workflows | 監査、合意形成、トリアージ、計画→構築、ライフサイクル、調査ラウンドなど、ループ状の作業。~/.claude/workflows/ のレシピを管理します。このファイルにはレシピを記載していません | Skill() |
using-tmux-agent-tools | tmuxワーカーとしてCLIを実行する場合、またはインラインで行うかワーカーを使うか判断する場合 | Skill() |
フロー:状況 → 引き継ぎ → 成果物 → ループ
条件付きの引き継ぎであり、パイプラインではありません。タスクに必要な段階だけを、ユーザーが許可した範囲内で使います。パイプラインを管理するドメインルーターは、そのパイプラインを維持します。ループ状の作業や名前付きレシピは using-workflows に渡し、そこで採用するか迂回するかを決めます。新しいレビュー担当者を追加するだけでは、レシピを使う理由にはなりません。すべてのスキルがリンクとは限りません。ツール、ジェネレーター、制約セットはマップから取得します。
| 状況 | 引き継ぎ | 各ステップの成果物 | ループを閉じる条件 |
|---|---|---|---|
| 新機能、受け入れ条件が不明確 | (トリガーに該当する場合は)unknowns-discovery → 設計上の疑問なら prototype、1セッションで大きすぎる場合は wayfinder → 実装(ユーザーがテストファーストを希望する場合は tdd)→ 完了を主張する前に、チェックを実行して出力を引用する(カーネルの Done ルール)→ リスクがある場合、またはユーザーが求めた場合は defect-first-review | 明示されたデフォルト → 設計上の回答または意思決定チケット → 差分とテスト → 引用したチェック出力 → 指摘事項 | 指摘事項を修正して再検証する。同じ指摘が繰り返された場合は、ゲートにするか、ファイル名を明記したバックログ行を作成する |
| バグまたはリグレッション | diagnosing-bugs(競合する仮説が多い場合は、代わりに using-workflows に入る)→ 元のシナリオを再実行 → リスクがある場合は、修正差分を defect-first-review でレビュー | 再現手順と失敗の兆候 → 修正とリグレッションテスト → 元のシナリオの再実行 → 指摘事項 | リグレッションテストをリポジトリに残す |
| テスト計画 | ケースをインラインで記述 → 実行が許可された場合に限り、agent-browser(Web)または agent-device(アプリ)を使う → バグがあれば Bug 行に記録。トラッカーの課題は triage に渡す | ケース → 実行の証拠 → バグ報告 | 見落としたケースを計画に戻す |
| 一時停止または引き継ぎ | session-handoff。Codex向けの再利用可能な知識は shared-memory-intake(受信箱のみ)へ | 引き継ぎドキュメント → 受信箱のエントリ | 次のセッションをドキュメントから開始する |
担当者へのポインター(各担当者のチェーンはそのまま維持します):コードベース全体の掘り下げ →
improve-codebase-architecture;インターフェース、ドメイン、またはビジュアルの設計 →
using-design-skills;人向けの文章作成 → writing-artifacts;tmuxワーカー →
using-tmux-agent-tools;ループとレシピ → using-workflows;スキルの編集 →
skill-creator(ドラフト、評価)の後、インストールまたはデプロイの前にルール maintenance §1(正確な差分、承認)を適用します。
構築前にアイデアを形にする
| 必要なこと | スキル | モード |
|---|---|---|
| 異なる認知フレームで並行して発散する | adhd | Skill() |
| フロンティアラウンドで計画や判断を徹底的に検証する | grilling | Skill() |
| 状況が曖昧、または複数の領域にまたがる場合に進め方を選ぶ | ask-nova | manual |
| 不慣れな領域で、地図と実際の領域とのずれを明らかにする | unknowns-discovery | Skill() |
| 設計上の疑問に答えるための使い捨てプロトタイプを作る | prototype | Skill() |
| 1回のセッションでは大きすぎる作業を、判断チケットとして整理する | wayfinder | manual |
コードを書く・変更する
| 必要なこと | スキル | モード |
|---|---|---|
| コードベース全体から、より深く掘り下げられる機会を見つける | improve-codebase-architecture | manual |
| 深いモジュールのインターフェースを設計する | codebase-design | Skill() |
| ドメインモデル、CONTEXT.md、ADR を構築する・磨き上げる | domain-modeling | Skill() |
| テストファーストで機能を構築する | tdd | Skill() |
診断・検証する
| 必要なこと | スキル | モード |
|---|---|---|
| 難しいバグやパフォーマンスの劣化を、その場で診断する | diagnosing-bugs | Skill() |
| 差分を読み取り専用で、不具合を優先してすべてレビューする | defect-first-review | Skill() |
| Web Interface Guidelines に照らして UI コードをレビューする | web-design-guidelines | Skill() |
委任・オーケストレーションする
| 必要なこと | スキル | モード |
|---|---|---|
| ワーカー向けのブリーフ(GOAL/ACCEPTANCE/REPORT)を書く | delegation-templates | Skill() |
| tmux ワーカーを操作する:仕組みとラッパー | tmux-agent-tools | via-router |
| 明示的にオーケストレーションされたエージェントのワークフローを計画し、実行する | codex-dynamic-workflows | Skill() |
外部の情報を読む
| 必要なこと | スキル | モード |
|---|---|---|
| 貼り付けられた URL を読みやすい Markdown として読む | defuddle | Skill() |
| PDF を読み取る、記入する、結合する、または作成する | pdf | Skill() |
| 一次資料に基づいて質問を調査し、内容をまとめる | research | Skill() |
| ブラウザーを操作する:移動、フォーム入力、スクリーンショット撮影 | agent-browser | Skill() |
| iOS、Android、macOS、または TV アプリを操作する | agent-device | Skill() |
| Grok Bot の macOS アプリ(ボット、フォルダー、トランスクリプト)を読む、または操作する | using-grok-bot-app | Skill() |
人が読む文章を書く
| 必要なこと | スキル | モード |
|---|---|---|
| 曖昧なテーマを完成した成果物に仕上げる(エントリーポイント) | writing-artifacts | Skill() |
| リポジトリ内のソフトウェア文書(README、API、チュートリアル)を書く | documentation-writing | Skill() |
| 構成を決める前に、生の断片を掘り起こす | writing-fragments | manual |
| 生の素材を段落ごとに記事へと整える | writing-shape | manual |
| 素材を一連のビートで構成する | writing-beats | manual |
| あらゆる文章から AI らしい書き方のパターンを取り除く | stop-slop | Skill() |
ビジュアルおよび HTML 出力(すべて using-design-skills 経由)
名前を解決できるように一覧にしています。迂回経路ではありません。ルーターが担当スキルを選びます。
| スキル | 担当範囲 |
|---|---|
impeccable | ディレクションの権限:プロダクト UI、ランディングページとマーケティングページ、再設計、仕上げ、批評 |
apple-design | スプリング、ジェスチャー、中断可能なモーション |
hallmark | 既存の定型に頼らない新規ページ、監査、URL やスクリーンショットからのデザイン抽出 |
diagram-design | 統一スタイルの型付き図、mermaid と draw.io、PNG/SVG エクスポート |
data-report | CSV、Excel、または JSON をビジュアルレポートページに変換する |
セッションとフリートの保守
| 必要なこと | スキル | モード |
|---|---|---|
| 新しいセッションに引き継ぐ | session-handoff | Skill() |
| Codex の共有メモリを整理する、または調査結果を共有メモリに提出する | shared-memory-intake | Skill() |
| スキルを作成、編集、または評価する | skill-creator | Skill() |
| トリアージ担当の役割を通じて、イシューや外部 PR を処理する | triage | manual |
| 人間にしか実行できない手順のための bash ウィザードを生成する | wizard | Skill() |
フリートが依存するプラグインとバンドル済みスキル
skills-lock.json にはありません。プラグインが ~/.claude/settings.json で有効になっており、スキルが利用可能なスキル一覧に表示されている場合に限り記載します。無効なプラグインのスキルはここには含めません。モード plugin:<name> はそのプラグインのキャッシュ内にあることを示し、bundled は Claude Code に同梱されていることを示します。
| スキル | ソース | モード |
|---|---|---|
context-mode | context-mode | plugin:context-mode |
ctx-doctor | context-mode | plugin:context-mode |
ctx-index | context-mode | plugin:context-mode |
ctx-insight | context-mode | plugin:context-mode |
ctx-purge | context-mode | plugin:context-mode |
ctx-search | context-mode | plugin:context-mode |
ctx-stats | context-mode | plugin:context-mode |
ctx-upgrade | context-mode | plugin:context-mode |
ponytail | ponytail | plugin:ponytail |
ponytail-audit | ponytail | plugin:ponytail |
ponytail-debt | ponytail | plugin:ponytail |
ponytail-gain | ponytail | plugin:ponytail |
ponytail-help | ponytail | plugin:ponytail |
ponytail-review | ponytail | plugin:ponytail |
artifact-design | Claude Code | bundled |
artifact-capabilities | Claude Code | bundled |
artifact-diagramming | Claude Code | bundled |
workflow-authoring | Claude Code | bundled |
loop | Claude Code | bundled |
claude-api | Claude Code | bundled |
その他の有効なプラグイン(code-review、commit-commands、pr-review-toolkit、session-report、frontend-design、security-guidance)は、それぞれの説明とともに一覧に表示されます。ルールファイル(~/.agents/rules/*.md)はスキルではありません。カーネルがそれらを振り分けます。
サブエージェントの例外
割り当てられたタスクを実行するワーカーは、このルーターを通りません。ディスパッチャーがすでに振り分けているため、ワーカーはその指示に従います。
危険信号
名前を挙げながらそのまま進める場合は、理由を明示する必要があります。
- 「これは小さな問題なので、スキルは不要です」:分野が明白な場合は直接進めてもかまいませんが、重要な作業で振り分けを省略してはいけません。
- 「そのスキルの内容は覚えています」:メンバーは変わります。まず実際の
SKILL.mdを読んでください。 - 「先に終わらせて、あとで手順を適用します」:ループ型または視覚的な作業では、ルーターが先にプロセスを選びます。後から手順を当てはめると、未完成の作業が出荷されます。
最新性のセルフチェック
このマップは、最後に編集した時点の skills-lock.json と一致しています。ここにある名前が解決できない場合、または一覧にこのマップに記載されていないスキルが表示される場合は、信頼する前に確認してください。
diff <(rg -o '`[a-z][a-z0-9-]+`' ~/.agents/skills/using-skills/SKILL.md | tr -d '`' | sort -u) \
<(jq -r '.skills|keys[]' ~/.agents/.skill-lock.json | sort)
左の列にしかない名前は、プラグイン/バンドル済みセクションの名前、モード名、ルール名、または古い参照です。そのセクション以外にあるものを確認してください。右の列にしかない名前は、インストール済みで、まだこのマップに配置されていないスキルです。
適合するものがない場合
ループ型でも視覚的でもなく、上記の意図にも該当しない場合は、有効な利用可能スキル一覧を確認してから、インラインで作業してください。繰り返し発生する新しい意図は、スキルまたはレシピの提案としてユーザーに伝えます。ルーターをインラインで即興作成してはいけません。