mcpField
G
Getting Started with Skills

Getting Started with Skills

github.com/obraエージェントワークフロー4260 回インストール55 週間前に更新
リポジトリ

Getting Started with Skills について

Claude skills を技法、パターン、ツールの個人ライブラリとして活用するためのガイドです。スキルを必要なときに検索・読み込み、会話履歴を調べ、各スキルの手順に従う方法を説明します。

主な機能

  1. 01タスク開始前にスキルを検索
  2. 02必要なときだけスキルファイルを読み込み
  3. 03サブエージェントで過去の会話を検索
  4. 04スキルの使用を明示
  5. 05TodoWrite でチェック項目を管理

活用シーン

  1. 01実装前に関連スキルを探す
  2. 02既知の問題で過去の作業を参照
  3. 03チェックリスト付きスキルの手順を守る

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/obra/clank --skill getting-started-with-skills

インストール後、Claude Code で/getting-started-with-skillsを入力して読み込まれたか確認します。

同梱ファイルskills-search

詳細

スキルを使い始める

~/.claude/skills/ にある、実証済みの手法、パターン、ツールをまとめた個人用 Wiki です。

スキルの参照方法

@ リンクは使用しないでください。ファイル全体が強制的に読み込まれ、コンテキストを一瞬で 200k 以上消費します。

代わりに、スキルのパスを参照してください。

  • 形式：skills/category/skill-name（@ 接頭辞なし、/SKILL.md 接尾辞なし）
  • 例：skills/collaboration/brainstorming または skills/testing/test-driven-development
  • 必要なときだけ Read ツールで読み込みます

ドキュメントでスキルの参照を見つけた場合：

  • skills/path/name → Read ツールを使って ~/.claude/skills/path/name/SKILL.md を読み込みます
  • 実装時にのみ、補足ファイルを読み込みます

必須ワークフロー 1：あらゆるタスクの前に

1. スキルを検索します。

~/.claude/skills/getting-started/skills-search PATTERN

2. 会話を検索します。 関連する過去の作業がないか確認するよう、サブエージェントに指示します（ワークフロー 2 を参照）。

スキルが見つかった場合：

  1. スキルを読みます：~/.claude/skills/path/skill-name/SKILL.md
  2. 使用を宣言します：「[スキル名]スキルを使用します」
  3. スキルに従います（厳格な要件が定められているものも多数あります）

「これはタスクに当たらない」というのは正当化にすぎません。 スキルや会話があるのに検索しなかった、または活用しなかった場合、そのタスクは失敗です。

必須ワークフロー 2：過去の経緯を検索する

実施する場合： 人間のパートナーが過去の作業に言及したとき、課題に見覚えがあるとき、慣れた分野のタスクを始めるとき、行き詰まったとき、既存のものを一から作り直す前

実施しない場合： 現在の会話に情報があるとき、コードベースの状態に関する質問のとき、初めて取り組むとき、パートナーが新しい視点を求めているとき

方法（コンテキストを 50～100 倍節約するため、サブエージェントを使用します）：

  1. テンプレート ~/.claude/skills/collaboration/remembering-conversations/tool/prompts/search-agent.md を使って、サブエージェントに指示します
  2. 要約（200～1000 語）と出典へのポインターを受け取ります
  3. 得られた知見を活用します（生の .jsonl ファイルは読み込みません）

例：

Partner: "How did we handle auth errors in React Router?"
You: Searching past conversations...
[Dispatch subagent → 350-word synthesis]
[Apply without loading 50k tokens]

危険信号： .jsonl ファイルを直接読む、抜粋を貼り付ける、「どの会話ですか？」と尋ねる、アーカイブを閲覧する

パターン： 検索 → サブエージェントが要約 → 活用。迅速で、焦点が絞られ、コンテキスト効率に優れています。

スキルの使用を宣言する

スキルの使用を始めるたびに、必ず宣言してください。

「[スキル名]スキルを使用して、[作業内容]を行います。」

例：

  • 「ブレインストーミングスキルを使用して、アイデアを洗練させ、設計にまとめます。」
  • 「テスト駆動開発スキルを使用して、この機能を実装します。」
  • 「体系的デバッグスキルを使用して、根本原因を特定します。」
  • 「安全なリファクタリングスキルを使用して、これらのメソッドを抽出します。」

理由： プロセスを明確にすることで、人間のパートナーが作業内容を把握し、早い段階で誤りを見つけられます。

チェックリストを含むスキル

スキルにチェックリストが含まれている場合、チェックリストの各項目について TodoWrite の ToDo を必ず作成してください。

次のことはしないでください。

  • チェックリストを頭の中だけで進める
  • 「時間の節約」のために ToDo の作成を省略する
  • 複数の項目をひとつの ToDo にまとめる
  • 実行していない項目を完了扱いにする

理由： TodoWrite で追跡しないチェックリストでは、手順が抜け落ちます。例外はありません。

例： TDD（テストを書く、失敗を確認する、実装する、検証する）、体系的デバッグ（4 つのフェーズ）、スキルの作成（RED-GREEN-REFACTOR）

ナビゲーション

まずはスキル検索を試してください。

カテゴリ： skills/INDEX.md → testing、debugging、coding、architecture、collaboration、meta 個別のスキル： カテゴリの INDEX から読み込みます

スキルの読み方

  1. フロントマター - when_to_use は状況に合っていますか？
  2. 概要 - 関連する基本原則は何ですか？
  3. クイックリファレンス - 該当するパターンをざっと確認します
  4. 実装 - 詳細をすべて確認します
  5. 補足ファイル - 実装時にのみ読み込みます

多くのスキルには厳格なルール（TDD、デバッグ、検証）が含まれています。 規律を崩さず、そのとおりに従ってください。

柔軟なパターン（アーキテクチャ、命名）もあります。 基本原則を状況に合わせて適用してください。

どちらのタイプかは、スキル自体に記載されています。

ドキュメントでスキルを参照する

ほかのスキルを参照するドキュメントを書く場合：

@ プレフィックスや /SKILL.md サフィックスを付けずにパスを記述します：

  • ✅ 良い例：skills/testing/test-driven-development
  • ✅ 良い例：skills/debugging/systematic-debugging
  • ❌ 悪い例：@skills/testing/test-driven-development/SKILL.md（強制的に読み込まれ、コンテキストを消費します）

@ 付きリンクを使わない理由： @ 構文を使うとファイルがただちに強制読み込みされ、必要になる前に 200k 以上のコンテキストを消費します。

スキルの参照先を読むには： Read ツールを使って ~/.claude/skills/category/skill-name/SKILL.md を読みます。

スキルの作成

価値のあるものを見つけましたか？skills/meta/creating-skills をご覧ください。

存在しないスキルが必要ですか？skills/REQUESTS.md（~/.claude/skills/REQUESTS.md にあります）を編集してください。

まとめ

会話を始める場合は？ これを読んだばかりです。よくできました。

タスクを始める場合は？ まず skills-search を実行し、使用することを伝えて、見つかった内容に従ってください。

スキルにチェックリストがある場合は？ 各項目に TodoWrite を使ってください。

スキルは、存在する場合は必須であり、任意ではありません。

最後に

このガイドを読んだ後の最初の応答では、getting started guide を読んだことを必ずユーザーに伝えてください。

コメント

Markdown 対応