mcpField
U
using-skills

using-skills

github.com/ohyehエージェントワークフロー0232 回インストール今日更新
リポジトリ

using-skills について

using-skills は、タスクをドメインルーターや個別スキルに振り分けるエージェントスキルの一覧です。開発、デザイン、検証、委任、調査、執筆を扱い、使用前に最新のスキル資料を確認するよう定めています。

主な機能

  1. 01タスクをドメインスキルへ振り分け
  2. 02デザインルーター経由でビジュアル作業を処理
  3. 03開発と検証のスキルを掲載
  4. 04委任、調査、執筆を網羅
  5. 05ルーティング階層と最新性の確認

活用シーン

  1. 01コーディング作業に合うスキルの確認
  2. 02ビジュアル作業をデザイン工程へ振り分け
  3. 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-skillsWebページ、アプリ画面、HTML成果物、チャート、アーティファクト、モーションに加え、モジュールやAPIのインターフェース設計など、視覚に関するあらゆる作業Skill()
using-workflows監査、合意形成、トリアージ、計画→構築、ライフサイクル、調査ラウンドなど、ループ状の作業。~/.claude/workflows/ のレシピを管理します。このファイルにはレシピを記載していませんSkill()
using-tmux-agent-toolstmuxワーカーとして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(正確な差分、承認)を適用します。

構築前にアイデアを形にする

必要なことスキルモード
異なる認知フレームで並行して発散するadhdSkill()
フロンティアラウンドで計画や判断を徹底的に検証するgrillingSkill()
状況が曖昧、または複数の領域にまたがる場合に進め方を選ぶask-novamanual
不慣れな領域で、地図と実際の領域とのずれを明らかにするunknowns-discoverySkill()
設計上の疑問に答えるための使い捨てプロトタイプを作るprototypeSkill()
1回のセッションでは大きすぎる作業を、判断チケットとして整理するwayfindermanual

コードを書く・変更する

必要なことスキルモード
コードベース全体から、より深く掘り下げられる機会を見つけるimprove-codebase-architecturemanual
深いモジュールのインターフェースを設計するcodebase-designSkill()
ドメインモデル、CONTEXT.md、ADR を構築する・磨き上げるdomain-modelingSkill()
テストファーストで機能を構築するtddSkill()

診断・検証する

必要なことスキルモード
難しいバグやパフォーマンスの劣化を、その場で診断するdiagnosing-bugsSkill()
差分を読み取り専用で、不具合を優先してすべてレビューするdefect-first-reviewSkill()
Web Interface Guidelines に照らして UI コードをレビューするweb-design-guidelinesSkill()

委任・オーケストレーションする

必要なことスキルモード
ワーカー向けのブリーフ(GOAL/ACCEPTANCE/REPORT)を書くdelegation-templatesSkill()
tmux ワーカーを操作する:仕組みとラッパーtmux-agent-toolsvia-router
明示的にオーケストレーションされたエージェントのワークフローを計画し、実行するcodex-dynamic-workflowsSkill()

外部の情報を読む

必要なことスキルモード
貼り付けられた URL を読みやすい Markdown として読むdefuddleSkill()
PDF を読み取る、記入する、結合する、または作成するpdfSkill()
一次資料に基づいて質問を調査し、内容をまとめるresearchSkill()
ブラウザーを操作する:移動、フォーム入力、スクリーンショット撮影agent-browserSkill()
iOS、Android、macOS、または TV アプリを操作するagent-deviceSkill()
Grok Bot の macOS アプリ(ボット、フォルダー、トランスクリプト)を読む、または操作するusing-grok-bot-appSkill()

人が読む文章を書く

必要なことスキルモード
曖昧なテーマを完成した成果物に仕上げる(エントリーポイント)writing-artifactsSkill()
リポジトリ内のソフトウェア文書(README、API、チュートリアル)を書くdocumentation-writingSkill()
構成を決める前に、生の断片を掘り起こすwriting-fragmentsmanual
生の素材を段落ごとに記事へと整えるwriting-shapemanual
素材を一連のビートで構成するwriting-beatsmanual
あらゆる文章から AI らしい書き方のパターンを取り除くstop-slopSkill()

ビジュアルおよび HTML 出力(すべて using-design-skills 経由)

名前を解決できるように一覧にしています。迂回経路ではありません。ルーターが担当スキルを選びます。

スキル担当範囲
impeccableディレクションの権限:プロダクト UI、ランディングページとマーケティングページ、再設計、仕上げ、批評
apple-designスプリング、ジェスチャー、中断可能なモーション
hallmark既存の定型に頼らない新規ページ、監査、URL やスクリーンショットからのデザイン抽出
diagram-design統一スタイルの型付き図、mermaid と draw.io、PNG/SVG エクスポート
data-reportCSV、Excel、または JSON をビジュアルレポートページに変換する

セッションとフリートの保守

必要なことスキルモード
新しいセッションに引き継ぐsession-handoffSkill()
Codex の共有メモリを整理する、または調査結果を共有メモリに提出するshared-memory-intakeSkill()
スキルを作成、編集、または評価するskill-creatorSkill()
トリアージ担当の役割を通じて、イシューや外部 PR を処理するtriagemanual
人間にしか実行できない手順のための bash ウィザードを生成するwizardSkill()

フリートが依存するプラグインとバンドル済みスキル

skills-lock.json にはありません。プラグインが ~/.claude/settings.json で有効になっており、スキルが利用可能なスキル一覧に表示されている場合に限り記載します。無効なプラグインのスキルはここには含めません。モード plugin:<name> はそのプラグインのキャッシュ内にあることを示し、bundled は Claude Code に同梱されていることを示します。

スキルソースモード
context-modecontext-modeplugin:context-mode
ctx-doctorcontext-modeplugin:context-mode
ctx-indexcontext-modeplugin:context-mode
ctx-insightcontext-modeplugin:context-mode
ctx-purgecontext-modeplugin:context-mode
ctx-searchcontext-modeplugin:context-mode
ctx-statscontext-modeplugin:context-mode
ctx-upgradecontext-modeplugin:context-mode
ponytailponytailplugin:ponytail
ponytail-auditponytailplugin:ponytail
ponytail-debtponytailplugin:ponytail
ponytail-gainponytailplugin:ponytail
ponytail-helpponytailplugin:ponytail
ponytail-reviewponytailplugin:ponytail
artifact-designClaude Codebundled
artifact-capabilitiesClaude Codebundled
artifact-diagrammingClaude Codebundled
workflow-authoringClaude Codebundled
loopClaude Codebundled
claude-apiClaude Codebundled

その他の有効なプラグイン(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)

左の列にしかない名前は、プラグイン/バンドル済みセクションの名前、モード名、ルール名、または古い参照です。そのセクション以外にあるものを確認してください。右の列にしかない名前は、インストール済みで、まだこのマップに配置されていないスキルです。

適合するものがない場合

ループ型でも視覚的でもなく、上記の意図にも該当しない場合は、有効な利用可能スキル一覧を確認してから、インラインで作業してください。繰り返し発生する新しい意図は、スキルまたはレシピの提案としてユーザーに伝えます。ルーターをインラインで即興作成してはいけません。

コメント