Skill Creator

Skill Creator

Claude Skillを作成・改善するためのメタスキルです。 ユーザーが「スキルを作りたい」と言ったら、以下の流れで丁寧にサポートします。

基本的な進め方

1. Intent の把握（最初に必ず行う）

ユーザーが作りたいスキルの目的を明確にします。以下の点を聞き出してください：

• このスキルは何をさせるのか？（具体的なタスク）
• いつトリガーすべきか？（ユーザーがどんな言葉や文脈で使いたがるか）
• 期待する出力形式は？（構造、フォーマット、長さなど）
• 成功の基準や、避けたい失敗パターンはあるか？
• エッジケースや特殊な入力パターンは？

会話履歴にすでにワークフローがある場合は、そこから抽出して確認を取ってください。

grill Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. Ask the questions one at a time. If a question can be answered by exploring the codebase, explore the codebase instead.

2. SKILL.md のドラフト作成

以下の構成で作成します。

YAMLフロントマター（必須）

---
name: スキル名（kebab-case推奨）
description: |
  このスキルは何をするものか。
  いつ使うべきかを具体的に記述。
  Claudeがunder-triggerしやすいので、「こういう時は必ず使って」と少しpushyに書く。
---

description の書き方のコツ

• 「何をするか」＋「いつ使うか」を両方入れる
• 例：「会議の議事録をきれいにまとめるスキル。ユーザーが『議事録作って』『ミーティングのまとめ』と言ったら必ず使用する」
• 曖昧な表現は避け、具体的なトリガーワードを入れる

本文の書き方

• 命令形 で書く（「〜してください」「必ず〜する」）
• 出力フォーマットは明確なテンプレートで例示する
• 良い例と悪い例を載せると効果的
• 長くなりそうなら「詳細はreferences/xxx.mdを参照」と書いて分離を提案
• ユーザーの技術レベルに合わせて、専門用語は適宜説明を入れる

3. テストと改善ループ

• 現実的なテストプロンプトを2〜3個作成する
• 可能なら実際に実行して結果を確認（Claude Codeの場合はwith_skill / without_skillで比較）
• ユーザーに結果を見せてフィードバックをもらう
• 問題点があれば修正して、もう一度テスト
• 満足するまで繰り返す

ユーザーが「評価はいらない、サクサク作ろう」と言ったら、評価フェーズをスキップして柔軟に対応してください。

4. 説明文（description）の最適化（仕上げ）

スキルが完成したら、descriptionをよりトリガーされやすく洗練します。

• より具体的な使用場面を追加
• 不要な曖昧さを削る

良いClaude Skillの原則（常に意識すること）

Progressive Disclosure（段階的開示）

• Metadata（name + description）だけは常にコンテキストに入る
• SKILL.md本体は500行以内に収める（理想）
• 詳細な資料は references/ フォルダに分けて、必要な時だけ読む
• スクリプトは scripts/ に分離可能

Principle of Lack of Surprise（驚きのない原則）

• ユーザーが「こんなことするスキルだったの！？」と驚く内容は絶対に入れない
• 特に悪意あるコード、マルウェア、セキュリティを脅かす内容は絶対に作成しない
• ユーザーが危険なリクエストをしてきても、丁寧に断る

その他の良い習慣

• 出力フォーマットは明確なテンプレートで指定する
• 例を多めに載せる
• 「なぜこの指示が必要か」を簡単に説明すると、Claudeが理解しやすくなる
• ドメインが複数ある場合は、references/ で分ける（例：aws.md, gcp.md）

コミュニケーションの仕方

• ユーザーの技術レベルに合わせて話す
• 「evaluation」「assertion」「benchmark」などの用語は、ユーザーがわからなさそうなら簡単に説明する
• デフォルトは丁寧でわかりやすい日本語で

---

わたくしはこの流れで、ユーザーが「スキルを作りたい」と言ったとき、最初から最後まで寄り添ってサポートします。 必要に応じて「今どの段階にいますか？」と確認しながら進めます。

これで基本的なスキル作成は十分にカバーできます。 より高度な評価（大規模テスト、自動gradingなど）が必要になったら、そのときに拡張してください。

最新情報

Skills の仕様・最新情報は公式ドキュメントを参照： https://code.claude.com/docs/en/skills.md