mcpField
C
create-skill

create-skill

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

create-skill について

create-skillは、リポジトリ内に完全なスキルフォルダーを作る開発者やエージェント向けのスキルです。構成、ドキュメント、アートワーク、検出経路への登録、検証を所定の手順で案内します。

主な機能

  1. 01リポジトリ規約の確認
  2. 02スキルの範囲とメタデータ定義
  3. 03スキルファイルとアートワークの作成
  4. 04検出経路の更新
  5. 05検証と差分チェック

活用シーン

  1. 01リポジトリへの新規スキル追加
  2. 02スキルのメタデータとアートワーク準備
  3. 03引き渡し前のスキルパッケージ確認

インストール

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

$npx skills add https://github.com/tamdogood/builder-essential-skills --skill create-skill

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
agents/
openai.yaml
references/
artwork.md

詳細

スキルの作成

スキルのアイデアを、完成度が高く、見つけやすく、リリース可能なスキルフォルダーに仕上げます。スキルの指示、メタデータ、アートワーク、README への組み込み、検証を、ひとつの成果物として扱ってください。

ワークフロー

  1. リポジトリの状況を把握します。 AGENTS.md、ルートの README.md、目的が似ている既存スキルのうち最も近いもの、ローカルのレッスンファイルを読みます。編集前に、package.json、skills.sh.json、インストーラー、既存の assets/skill-cards/ と assets/skill-banners/ の規約を確認します。

  2. 要件を定義します。 依頼からスキルのスラッグ、目的、対象者、トリガーフレーズ、入力、出力、受け入れチェックを抽出します。スラッグは小文字のハイフン区切りに統一します。ユーザーの用語はそのまま使いつつ、フロントマターの説明では、スキルの機能と、どのような状況で起動すべきかを明確にします。

  3. 必要最小限の構成を選びます。 スキルに必要なリソースだけを作成します。

    • skills/<slug>/SKILL.md：コアワークフローと振り分けルール。
    • skills/<slug>/agents/openai.yaml：表示用メタデータと、明示的な $<slug> のデフォルトプロンプト。
    • skills/<slug>/references/：段階的に読み込む詳細な分野別ガイダンス。
    • skills/<slug>/scripts/：決定的で、繰り返し実行できる自動化に限ります。
    • skills/<slug>/assets/：スキルが出力で再利用するファイルに限ります。
    • skills/<slug>/README.md：このリポジトリでは公開するすべてのスキルを文書化します。

    SKILL.md は 500 行未満にします。詳細な仕様や長い例は、1 階層下の references に置き、スキルから直接リンクします。

  4. スキルを作成します。 命令形で指示を書きます。判断ポイント、必要なツール、ファイルパス、不変条件、失敗時の対応、他のエージェントが安全に推測できない検証コマンドを明記します。SKILL.md には簡潔なワークフローを記載し、専門的な作業には references/artwork.md などの条件付きリンクを使います。

  5. 必要なアートワークを作成します。 このリポジトリでは、新しいスキルごとに assets/skill-cards/<slug>.svg と、ルート README の Pick a skill テーブルへのリンク付き行が必要です。コレクションでシネマティックバナーを使用している場合は、assets/skill-banners/<slug>.webp も作成し、ルート README とスキル README でそのバナーを使います。いずれかのアセットを作成する前に、references/artwork.md を読みます。

  6. すべての見つけやすさにつながる場所に組み込みます。 スキルを明示的に列挙しているすべての場所を更新します。ルート README のカードテーブル、スキル README、skills.sh.json のグループ分け、状況把握の際に見つかったレジストリまたはインストーラーの許可リストが対象です。新しいレジストリファイルを作成してはいけません。package.json に skills/ と assets/ のツリーがすでに含まれていることを確認し、新しいファイルがパッケージから除外される場合に限り変更します。

  7. 引き渡し前に検証します。 スキルバリデーターを実行し、SVG を解析し、レンダリングされたカードとバナーを確認します。新しい README のリンクをすべて確認し、リポジトリのテストスイートを実行し、git diff --check を実行します。差分を確認し、古い名前、プレースホルダーテキスト、欠落したメタデータ、壊れた相対パス、未追跡の必須アセット、意図しない無関係な編集がないか確認します。

スキルの内容に関する要件

該当する場合は、次のセクションを含めます。

  • 対象範囲と起動条件： スキルが扱う内容と、扱わない内容。
  • 入力と出力： 想定されるファイル、リンク、ユーザーの判断、最終成果物。
  • ワークフロー： 明確な分岐点を含む、最小限かつ信頼できる手順。
  • リソース： 各 reference を読むタイミング、各スクリプトを実行するタイミング。
  • 検証： 具体的なコマンドと、視覚面または意味面での受け入れチェック。
  • 失敗時の対応： ツール、依存関係、reference、ユーザーの選択が不足している場合の対応。

公開するスキルに TODO マーカー、テンプレート文、推測したツール名、裏付けのない主張を残してはいけません。長い reference の内容を SKILL.md に重複して記載しないでください。

アートワークの作成

新しいラスター形式のバナーには、組み込みの画像生成ツールを使用します。既存のバナーを2つ以上と、ユーザーから提供された参考画像があれば確認します。参考画像はスタイルや構図の手がかりとして扱い、内容をコピーしないでください。ツールが正確なタイトル文字を安定して描画できる場合に限り、横長のシネマティックなシーンを生成します。結果を確認し、問題を一度に1つずつ絞って修正を繰り返してください。最終的なプロジェクトアセットは WebP 形式で保存し、SVG カードは決定論的でアクセシブルな状態に保ちます。

詳細なビジュアルシステム、プロンプトテンプレート、構図のルール、変換コマンド、レビュー用チェックリストについては、references/artwork.md をご覧ください。

検証コマンド

リポジトリのルートから、ローカルのツールチェーンに合わせて次のコマンドを調整します。

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" skills/<slug>
xmllint --noout assets/skill-cards/<slug>.svg
npm test
git diff --check

コマンドを利用できない場合は、リポジトリで文書化されている代替手段を使用し、その置き換え内容を報告してください。必須ファイルが未追跡のまま、または検証チェックが失敗している場合は、作業を完了としないでください。

コメント

Markdown 対応