My Skill Name

[Claudeに従わせる指示を書く]

以下のように続きを書きました。

スキルファイルを保存したら、Claude Codeを再起動して /my-skill-name とタイプすることで呼び出せるようになります。指示の書き方次第でコードレビュー・ドキュメント生成・デプロイ前チェックなど、チーム固有のワークフローを自動化できます。

指示を書くときのコツ

• 動詞で始める：「〜を確認せよ」「〜を生成せよ」のように命令形にするとClaudeが意図を解釈しやすくなります。
• スコープを明示する：「現在の作業ディレクトリ内のファイルのみを対象とする」のように範囲を限定すると、意図しない副作用を防げます。
• 出力フォーマットを指定する：「マークダウンの箇条書きで返せ」のように形式を固定すると、後続処理に組み込みやすくなります。

チームで共有する

スキルファイルはテキストファイルなので、Gitリポジトリに含めてチーム全員で共有できます。.claude/skills/ ディレクトリをリポジトリに追加するだけで、新メンバーもすぐに同じワークフローを利用できます。

まとめ

Claude Codeのスキル機能を使うと、繰り返し行う作業をスラッシュコマンド一つに集約できます。指示はシンプルなテキストで記述でき、Gitで管理・共有できるため、チーム全体の生産性向上に直結します。まずは小さなスキルを一つ作り、実際の開発フローに組み込んでみてください。

よくある質問（FAQ）

Q. スキルファイルの置き場所はどこですか？
A. プロジェクトルートの .claude/skills/ ディレクトリ、またはユーザーホームの ~/.claude/skills/ に置きます。前者はプロジェクト固有、後者は全プロジェクト共通で利用できます。

Q. 既存のスキルを上書きできますか？
A. 同名のファイルを配置すると上書きされます。ただしClaude Codeを再起動しないと変更が反映されない場合があるので注意してください。

Q. スキルからツール（Bash・Readなど）を呼び出せますか？
A. はい。スキルの指示内でツールの使用を明示すれば、Claudeは通常の会話と同様にツールを実行します。ユーザーの権限設定が適用される点は変わりません。

Q. スキルと hooks の違いは何ですか？
A. スキルはユーザーが明示的に呼び出すものです。一方 hooks はツール呼び出しやセッション終了などのイベントをトリガーに自動実行されます。「手動で実行したい処理」はスキル、「特定のイベントに連動させたい処理」は hooks が適しています。