Skill Creator

• 新しいスキルをゼロから構築する — ドメイン、ワークフロー、またはツール統合を再利用可能なスキルとしてパッケージ化したい場合に、構造、コンテンツ、ベストプラクティスに関するガイダンスを必要としている。
• 既存のスキルを改善する — 確実にトリガーされない、コンテキストウィンドウを肥大化させている、または有用なバンドルリソースが不足しているスキルがあり、原則に基づいたレビューを希望している。
• スキルアーキテクチャを設計する — SKILL.md、scripts/、references/、assets/ 間でコンテンツをどのように分割するか不明確で、その判断のためのフレームワークを求めている。
• スキルをパッケージ化して配布する — スキルディレクトリを検証し、共有用の .skill ファイルにバンドルする準備ができている。

• 既存のスキルを使用したいだけの場合 — このスキルはスキルを作成するために特化したものであり、ドメインタスクで使用するためのものではありません。
• タスクが一度きりの場合 — Claudeに専門的なタスクを一度だけ実行させる必要があり、再利用する予定がない場合、完全なスキルパッケージを作成することは過剰です。

具体的な例を用いてスキルを理解し、再利用可能なコンテンツを計画し、ディレクトリを初期化し、SKILL.md とリソースを編集し、スキルをパッケージ化して反復するという繰り返し可能なプロセスを通じて Claude をガイドします。各ステップには明確な開始・終了基準があり、正当な理由なくスキップされることはありません。

スキルは3段階のローディングシステムを採用しています。メタデータ（約100語、常にコンテキストに含まれる）、SKILL.md本文（トリガー時に読み込まれ、500行未満に抑える）、そしてバンドルリソース（必要なときのみ読み込まれる）の3つです。このスキルでは、Skill Creator のスキルを無駄なくコンテキスト効率よく保つために、このデザイン原則をどのように適用するかを学びます。

Claudeに高い自由度（オープンなテキスト指示）、中程度の自由度（パラメータ付きの疑似コード）、または低い自由度（最小限のバリエーションを持つ具体的なスクリプト）をいつ与えるべきかを説明します。タスクの脆弱性に対して具体性を適切に合わせることが、効果的なSkill Creatorのスキルを作成する上で中心的な要素です。

3種類のリソースタイプを解説します。決定論的な実行可能コード用の scripts/、オンデマンドで読み込まれるドキュメント用の references/、テンプレートや画像などの出力ファイル用の assets/ です。各タイプが適切な場面について、具体的な例とガイダンスを提供します。

init_skill.py を使用して、適切なフロントマター、プレースホルダー指示、およびサンプルリソースフォルダーを含む新しいスキルディレクトリをスキャフォールドします。package_skill.py を使用して、構造を検証し、説明の品質をチェックし、配布可能な .skill zip ファイルを生成します。

description フィールドは主要なトリガーメカニズムです。このフィールドには、スキルが何をするのか、そしていつ使用するのかを明確に記述する必要があります。このスキルでは、適切なタイミングで適切なスキルを確実にトリガーする説明文を書くための具体的なガイダンスと例を提供します。

あるチームは、社内データベーススキーマ、API仕様、およびビジネスポリシーを使用してClaudeに質問に答えさせたいと考えています。Skill Creatorを使用して、ドメイン別に分割されたファイル（finance.md、sales.md）を含むreferences/ディレクトリを計画し、焦点を絞ったSKILL.mdを作成し、チームへの配布用にパッケージ化します。

あるユーザーは、PDFの回転、テキスト抽出、フォーム入力をClaudeに頻繁に依頼しています。Skill Creatorは、繰り返し使用されるコードを特定し、scripts/rotate_pdf.pyを作成して、Claudeがいつ・どのように使用するかを伝えるSKILL.mdを記述するよう、ユーザーを導きます。これにより、セッションごとに冗長なコードを生成する手間がなくなります。

開発者は、Claudeに新しいウェブアプリを常に一貫したReactボイラープレートから始めてほしいと考えています。Skill Creatorは、テンプレートをassets/hello-world/に保存し、毎回ゼロからボイラープレートを書くのではなく、それをコピーして適応させるようClaudeに指示する説明文を作成するよう、開発者を導きます。

既存のスキルが期待通りに呼び出されない状況があります。Skill Creator のフロントマターの説明に関するガイダンス — 特に「使用するタイミング」に関するコンテキストをすべて本文ではなく description フィールドに記載するという点 — が、トリガーの問題を診断して修正するのに役立ちます。