create-skill

create-skill の概要

create-skill でできること

create-skill は、dotnet/skills スタイルの新しいエージェントスキル向けスキャフォールドを生成するためのツールです。妥当なスキルフォルダを作成し、フロントマター付きの SKILL.md を書き、Skill Scaffolding に期待される構成に沿って整えるのに役立ちます。

どんな人に向いているか

create-skill は、ゼロから新しいスキルを作り始めるとき、きれいな SKILL.md テンプレートが必要なとき、あるいはファイルを手作業で寄せ集める代わりに、新しいスキルディレクトリを再現性高くセットアップしたいときに向いています。

何が便利なのか

最大の価値は、セットアップ時のミスを減らせることです。たとえば、命名の不整合、フロントマターの抜け、フォルダ構成のばらつきといった問題を抑えられます。出力をリポジトリ規約とエージェントスキルの期待値に合わせたい場合、一般的なプロンプトより実用的です。

向いていないケース

既存のスキルをその場で編集したい場合や、.agents/skills パターン以外のカスタムエージェントを作りたい場合には、create-skill は使わないでください。そうしたケースでは直接編集のほうが速く、不要なスキャフォールドを持ち込むリスクも低くなります。

create-skill の使い方

create-skill をインストールする

スキル環境に create-skill を追加するには、次を実行します。
npx skills add dotnet/skills --skill create-skill

使っているスキルマネージャーが別でも、考え方は同じです。新しいスキルのスキャフォールドを依頼する前に、対象として create-skill を追加しておきます。

正しい入力を与える

create-skill は、想定している4つの入力、つまり skill name、description、purpose、workflow steps を渡すと最もよく機能します。良い入力例は次のようなものです。

• name: ci-triage
• description: “Triage failing CI jobs and suggest the most likely fix.”
• purpose: 望む成果を1段落で説明する
• workflow: 曖昧な目標ではなく、番号付きの手順にする

「debugging 用の skill を作って」といった弱い入力では、スキル側がスコープ、出力構造、文言を推測するしかなくなります。

まずソースファイルから確認する

最初に SKILL.md を読み、そのあと出力に影響するリポジトリ規約があればそれも確認してください。このリポジトリでは、実際の出発点は skill file そのものです。create-skill の使い方、検証、レイアウトに関する実ルールがそこに書かれているからです。

スキャフォールドを依頼するプロンプトにする

よい create-skill guide プロンプトでは、何を作りたいのか、どの制約が重要なのかを明確に伝えます。たとえば、「create-skill を使って doc-review という新しい skill をスキャフォールドし、SKILL.md の frontmatter を生成し、skills/ 配下の Markdown docs をレビューする workflow を含めてください」といった形です。

こうしておくと、単なる下書きではなく、インストール可能な形に近いものを出しやすくなります。

create-skill の FAQ

create-skill は新しいスキル専用ですか？

はい、主な用途はその通りです。リポジトリでは、既存のスキルを変更するときに create-skill を使わないよう明示しています。そうした場合は直接編集してください。

Agent Skills の仕様を全部先に覚える必要がありますか？

いいえ、それも create-skill を入れる理由の1つです。仕様を丸暗記しなくても、想定される構造や命名規則に沿ったスキャフォールドを作りやすくなります。

普通のプロンプトと何が違うのですか？

通常のプロンプトでもスキル案は作れますが、create-skill はリポジトリの規約に合った結果を出すことを重視しています。フォルダ構成、フロントマターの完全性、命名の検証を重視するなら、この違いは大きくなります。

create-skill は初心者向けですか？

はい。標準的なスキルを作りたくて、目的を明確に伝えられるなら扱いやすいです。すでに Skill Scaffolding のパターンに合わない独自構成を思い描いている場合は、あまり向いていません。

create-skill を改善する方法

skill 名と目的を具体的にする

品質を一番大きく引き上げるのは、具体的で有効な名前と、実際の成果を示す目的です。たとえば、「pull requests の release risk をレビューする」は、「PR を手伝う」よりずっと強い入力です。

実際の使い方に沿った workflow steps を与える

create-skill がスキャフォールドできるのは、あなたが記述した内容だけです。高品質な出力がほしいなら、探索、検証、ドラフト作成、最終レビューのように、実際の作業の流れに合った手順を入れてください。

生成された構成を自分の repo と照らし合わせる

最初の生成後は、そのスキャフォールドをリポジトリ規約と比較してください。repo に追加のフォルダ、命名規則、metadata fields があるなら、次のプロンプトにその制約を足すことで、skill をより適切に合わせ込めます。

よくある失敗パターンに注意する

最も多い問題は、説明が曖昧なこと、目的が広すぎること、そして workflow steps が一般的すぎて役に立たないことです。入力を絞り込み、もう一度 create-skill を実行して、具体性を上げ、手直しの手間を減らしてください。