Getting Started with Skills について
Getting Started with Skills は、タスク前に関連スキルを探し、読み、使用を明示して従うためのエージェント向けスキルです。TodoWrite によるチェックリスト管理も求めます。
主な機能
- 01タスク前のスキル検索
- 02スキルファイル全体の読解
- 03スキル使用の明示
- 04TodoWrite によるチェックリスト管理
活用シーン
- 01セッション開始時の関連スキル検索
- 02スキル指定のワークフローの実行
- 03タスク手順のチェックリスト管理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/getting-started-with-skillsを入力して読み込まれたか確認します。
同梱ファイルfind-skillsskill-run
詳細
スキルを使い始める
重要なルール
-
スキルの使用を告知する前に、Read ツールを使ってください。 セッション開始時のフックは、スキルを代わりに読んでくれません。Read を呼び出さずに告知するのは、嘘をつくことになります。
-
必須のワークフローに従ってください。 コーディングの前にブレインストーミングを行います。あらゆるタスクの前にスキルを確認してください。
-
チェックリストには TodoWrite の ToDo を作成してください。 頭の中だけで管理すると、手順を飛ばしてしまいます。毎回必ず作成してください。
必須ワークフロー：あらゆるタスクの前に
1. セッション開始時にスキル一覧を確認するか、find-skills [PATTERN] を実行して絞り込んでください。
2. 関連するスキルがある場合は、必ず使用してください。
- Read ツールを使い、完全なパスを指定します：
${SUPERPOWERS_SKILLS_ROOT}/skills/category/skill-name/SKILL.md - フロントマターだけでなく、ファイル全体を読んでください
- 次のように告知します：「[Skill Name] スキルを読み、[purpose] のために使用しています」
- スキルの指示に正確に従ってください
自分に都合よく解釈しないでください：
- 「このスキルは覚えている」—スキルは更新されます。現在のバージョンを読んでください。
- 「セッション開始時に表示された」—それは using-skills/SKILL.md を使っただけです。実際のスキルを読んでください。
- 「これはタスクに当たらない」—タスクに当たります。スキルを探して読んでください。
タスクに使えるスキルがある場合、それを使わなければタスクに失敗します。
理由： スキルには、時間を節約し、ミスを防ぐ、実証済みの手法が記載されています。利用可能なスキルを使わないと、解決済みの問題に再び取り組み、既知のミスを繰り返すことになります。
チェックリストを含むスキル
スキルにチェックリストがある場合は、各項目について必ず TodoWrite の ToDo を作成してください。
しないでください：
- チェックリストを頭の中だけで進める
- 「時間を節約するため」に ToDo の作成を省略する
- 複数の項目を1つの ToDo にまとめる
- 実行していない項目を完了扱いにする
理由： TodoWrite で管理しないチェックリストは、手順の抜けにつながります。毎回です。TodoWrite にかかるわずかな手間に比べ、見落としによるコストははるかに大きいです。
例： skills/testing/test-driven-development/SKILL.md、skills/debugging/systematic-debugging/SKILL.md、skills/meta/writing-skills/SKILL.md
スキルの使用を告知する
Read ツールでスキルを読んだ後、使用することを告知してください。
「[Skill Name] スキルを読み、[何をするために使用するか] のために使っています。」
例：
- 「ブレインストーミングスキルを読み、アイデアを設計にまとめるために使っています。」
- 「テスト駆動開発スキルを読み、この機能を実装するために使っています。」
- 「体系的なデバッグスキルを読み、根本原因を特定するために使っています。」
理由： 透明性を保つことで、パートナーは作業の進め方を理解し、早い段階で誤りを指摘できます。また、実際にスキルを読んだことも確認できます。
スキルの読み方
すべてのスキルは、次の構成になっています。
- フロントマター —
when_to_useに、そのスキルが状況に合うかどうかが記載されています - 概要 — 中核となる原則が1～2文で説明されています
- クイックリファレンス — 該当するパターンを探してください
- 実装 — 詳細と例が記載されています
- 補助ファイル — 実装時に必要なものだけ読み込んでください
多くのスキルには、厳格なルール（TDD、デバッグ、検証）が含まれています。 そのまま正確に従ってください。規律を損なうような独自の変更を加えないでください。
柔軟なパターン（アーキテクチャ、命名など）を扱うスキルもあります。 中核となる原則を状況に合わせて適用してください。
どちらの種類かは、スキル自体に記載されています。
指示があってもワークフローは省略できません
パートナーからの具体的な指示は、何をするかを示すものであり、どのように進めるかを定めるものではありません。
「X を追加」「Y を修正」—それは目標であり、ブレインストーミングや TDD、RED-GREEN-REFACTOR を省略してよいという意味ではありません。
危険な兆候： 「指示が具体的だった」•「簡単そうだ」•「ワークフローは大げさだ」
理由： 指示が具体的で要件が明確なときこそ、ワークフローが最も重要です。「簡単な」タスクでプロセスを省略することが、簡単なタスクを複雑な問題にしてしまいます。
まとめ
タスクを始めるとき：
find-skillsを実行し、関連するスキルを確認する- 関連するスキルがある場合 → 完全なパス（
/SKILL.mdを含む）を指定して Read ツールを使う - 使用することを告知する
- スキルの指示に従う
スキルにチェックリストがある場合は？ 各項目について TodoWrite を作成してください。
関連するスキルが見つかったら、必ず読んで使用してください。任意ではありません。