help について
help は、インストール済みスキルをカテゴリ別に閲覧したり、ユーザーが呼び出せるスキルを一覧表示したりする OrchestKit のスキルです。実行時にスキルを検出するため、固定リストの陳腐化を避けられます。
主な機能
- 01インストール済みスキルの実行時検出
- 02カテゴリ別のスキル閲覧
- 03ユーザー呼び出し可能なスキル一覧
- 04スキル適用理由の表示
活用シーン
- 01BUILD や GIT のスキルを閲覧
- 02タスクに合うスキルを検索
- 03呼び出し可能なスキルを一覧
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ yonatangross/ orchestkit --skill helpインストール後、Claude Code で/helpを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
test-cases.jsonreferences/cc-keyboard-shortcuts.mdrules/_sections.mdskill-metadata-freshness.mdcategory-accuracy.md詳細
OrchestKit スキルディレクトリ
動的なスキル検出:実行時にインストール済みのプラグインを列挙するため、一覧が古くなることはありません。
CC 2.1.121+ のヒント: スキルをすばやく 1 つ見つけたいだけなら、標準の
/skillsコマンドに入力して絞り込む機能が追加されています。コマンドを開いてスキル名を入力してください。カテゴリ別に参照したい場合や、なぜスキルが適用されるのか知りたい場合は、helpを使ってください。
クイックスタート
help # Show all categories
help build # Show BUILD skills only
help git # Show GIT skills only
help all # List every user-invocable skill
引数の解決
CATEGORY = "$ARGUMENTS[0]" # Optional: build, git, plan, quality, memory, config, explore, design, ops, all
# If provided, skip AskUserQuestion and show that category directly.
# $ARGUMENTS is the full string (CC 2.1.59 indexed access)
STEP 0:動的なスキル検出
正確で最新のスキルデータを取得するため、必ず最初に実行してください。
# ${CLAUDE_PLUGIN_ROOT} is set by the plugin runtime and points at the INSTALLED
# plugin. That is the normal case: a marketplace user has no src/ directory.
SKILLS_ROOT = "${CLAUDE_PLUGIN_ROOT}/skills"
matches = Grep(pattern="user-invocable:\\s*true", path=SKILLS_ROOT, output_mode="files_with_matches")
# Dogfooding fallback: inside the OrchestKit repo itself the skills live in the
# source tree. Retry there if the env var was unset or the probe found nothing.
if not matches:
SKILLS_ROOT = "src/skills"
matches = Grep(pattern="user-invocable:\\s*true", path=SKILLS_ROOT, output_mode="files_with_matches")
両方の検索でファイルが 1 つも見つからない場合は、その旨を明確に伝え(「${CLAUDE_PLUGIN_ROOT}/skills と src/skills を確認しましたが、OrchestKit のスキルディレクトリが見つかりませんでした」)、処理を終了してください。記憶に基づくスキル名の一覧で代用してはいけません。そのような一覧は必然的に古くなっており、自信満々の誤答は、答えがないよりも悪い結果になります。
一致した各ファイルのフロントマターを読み取り、name、description、version、complexity、argument-hint、tags を取得します。
Read(file_path=f"{SKILLS_ROOT}/{skill_dir}/SKILL.md", limit=25)
後で出力する数値はすべて、このスキャンから導き出してください。数値を固定値として入力してはいけません。
TOTAL = len(matches) # user-invocable skill count
スキル一覧は動的に作成してください。件数やスキル名をハードコードしてはいけません。
STEP 1:カテゴリの選択
CATEGORY 引数が指定されている場合は、そのカテゴリを使って STEP 2 に進みます。
指定されていない場合は、カテゴリを対話形式で提示します。
AskUserQuestion(
questions=[{
"question": "What type of task are you working on?",
"header": "Category",
# 4-option cap (CC schema): every category from STEP 2 is grouped into one of
# 3 buckets + "Show all". STEP 2 renders the constituent categories for the
# picked bucket. Descriptions name intents, never skills, so they cannot drift.
"options": [
{"label": "Build & ship", "description": "Writing code, tests, git and PRs, UI and design work"},
{"label": "Plan & assess", "description": "Requirements, planning, quality assessment, review"},
{"label": "Explore & operate", "description": "Codebase exploration, memory, setup, diagnostics, CI"},
{"label": "Show all", "description": "List every user-invocable skill"}
],
"multiSelect": false
}]
)
STEP 2:カテゴリの表示
選択したカテゴリについて、STEP 0 で収集したデータからスキルの表を表示します。
カテゴリの定義
カテゴリはスキル名の一覧ではなく、タグの判定条件によって定義されます。そのため、新しく追加されたスキルもこのファイルを編集せずに適切なカテゴリに分類されます。検出した各スキルのフロントマターにある tags を、以下のセットと照合してください(大文字と小文字は区別せず、1 つでも一致すれば該当します)。
| カテゴリ | CLI 引数 | 次のタグのいずれかに一致 |
|---|---|---|
| BUILD | build | implementation, feature, testing, coverage, test-generation, verification, e2e |
| GIT | git | git, github, commit, pull-request, pr, issue, bug-fix |
| PLAN | plan | planning, ideation, prd, requirements, visualization |
| QUALITY | quality | quality, assessment, evaluation, code-review, validation, grading |
| MEMORY | memory | memory, decisions, graph-memory, consolidation |
| CONFIG | config | setup, configuration, onboarding, diagnostics, health-check, dev-loop |
| EXPLORE | explore | exploration, codebase, code-search, architecture, discovery |
| DESIGN | design | design, design-context, design-tokens, design-to-code, frontend, ui, components, stylecards |
| OPS | ops | ci, automation, telemetry, observability, release, migration |
| OTHER | (なし) | 上記の行に一致しなかったすべて |
1 つのスキルが 2 つのカテゴリに一致する場合は、両方に掲載します。これは想定された動作であり、バグではありません。合計数を一致させるために OTHER があります。STEP 0 で見つかったすべてのスキルは全件表示のどこかに掲載される必要があり、まだ分類されていないスキルも表示されます。
STEP 1 の選択肢には3 つのバケットだけを提示します(AskUserQuestion スキーマでは、質問の選択肢は最大 4 つに制限されています)。各バケットには、そのカテゴリの和集合を表示します。
| 選択バケット | 表示するカテゴリ |
|---|---|
| ビルドとリリース | BUILD + GIT + DESIGN |
| 計画と評価 | PLAN + QUALITY |
| 探索と運用 | MEMORY + CONFIG + EXPLORE + OPS + OTHER |
カテゴリ内の各スキルについて、次を表示します。
/ork:{name} v{version} {complexity}
{description}
Example: /ork:{name} {argument-hint example}
「すべて表示」— 全件表示
ユーザーが「すべて表示」を選択した場合は、STEP 0 のデータから、ユーザーが呼び出せるすべてのスキルをカテゴリ別にグループ化して表示し、最後に導出した合計を {TOTAL} 個のユーザー呼び出し可能なスキル の形式で示します。TOTAL には len(matches) の値を使ってください。直前に数えた値以外の数値を入力してはいけません。
CC 組み込みコマンド(2.1.72+)
OrchestKit のスキルではなく、Claude Code の組み込み機能です。
| コマンド | 説明 | バージョン |
|---|---|---|
/code-review | 選択した作業レベルに応じて、変更されたコードに正確性のバグがないかレビューします。--comment を指定すると、PR にインラインコメントを投稿します(2.1.146 で /simplify から名称変更。以前のクリーンアップと修正の動作は削除されました) | CC 2.1.146 |
/help | Claude Code の組み込みヘルプ | CC 2.1.0+ |
/config | Claude Code の設定 | CC 2.1.0+ |
/clear | 会話を消去します(バックグラウンドエージェントは保持されます) | CC 2.1.72 |
/fast | 高速モードを切り替えます(同じモデルで、出力を高速化) | CC 2.1.59+ |
/loop | 指定した間隔で繰り返します(例:/loop 5m /foo) | CC 2.1.71 |
/plan | プランモードに切り替えます(CC 2.1.222 で ultraplan 機能が削除されたため、/ultraplan と「Refine with Ultraplan」の引き継ぎは利用できなくなりました) | CC 2.1.72 |
/team-onboarding | チームメイト向けのオンボーディングガイドを生成します | CC 2.1.101 |
/recap | アイドル状態の後にセッションコンテキストを復元します | CC 2.1.108 |
/undo | /rewind のエイリアス | CC 2.1.108 |
/skills | ネイティブのスキル選択メニュー。入力して絞り込めます | CC 2.1.121 |
/effort | 推論の作業レベルを設定します。スキル用に $CLAUDE_EFFORT 環境変数を設定します | CC 2.1.72(環境変数は 2.1.120 以降) |
/cd | プロンプトキャッシュを損なわずに、セッションを新しい作業ディレクトリに移動します | CC 2.1.169 |
--safe-mode | すべてのカスタマイズを無効にして起動します(トラブルシューティング時の二分探索) | CC 2.1.169(フラグ/環境変数であり、スラッシュコマンドではありません) |
パフォーマンスのヒント
ENABLE_PROMPT_CACHING_1H=1— プロンプトキャッシュの TTL を 5 分から 1 時間に延長します。複数フェーズのスキル(ブレインストーミング、実装、網羅)を使う長時間のセッションで設定してください。API キー、Bedrock、Vertex、Foundry で利用できます。/recap— 離席後にセッションコンテキストを復元します。チェーン復旧用の OrchestKit のチェックポイント再開機能を補完します。
キーボードショートカット
| ショートカット | 操作 |
|---|---|
Ctrl+F | セッションの出力内を検索 |
Esc | キャンセル/閉じる |
Shift+Enter | 入力欄に改行を挿入 |
Ctrl+C | 操作をキャンセル |
プロのヒント
スキルを暗記する必要はありません。タスクを自然な言葉で説明するだけです。
"I need to implement user login" → implement
"Show me the payment architecture" → explore
"Review PR 123" → review-pr
"Is this code good?" → assess
"Plan out the billing redesign" → visualize-plan
関連スキル
/help— Claude Code の組み込みヘルプdoctor— OrchestKit のヘルスチェックsetup— オンボーディングウィザード一式