mcpField
C
create-skill

create-skill

github.com/lwlee2608エージェントワークフロー1178 回インストール1 日前に更新
リポジトリ

create-skill について

create-skillは、品質基準を満たすSKILL.mdの作成を支援するエージェントスキルです。明確な起動条件、単一の役割、固定スクリプトではなく簡潔な指針を重視します。

主な機能

  1. 01単一目的のスキル設計
  2. 02命名と起動条件の指針
  3. 03SKILL.mdの構成ガイド
  4. 04簡潔なルール作成の原則
  5. 05検証と誤り記録の基準

活用シーン

  1. 01新しいエージェントスキルファイルの作成
  2. 02スキル名と起動条件の改善
  3. 03長い指示や重複した説明の整理

インストール

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

$npx skills add https://github.com/lwlee2608/agent-skills --skill create-skill

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

詳細

エージェントスキルの作成

品質基準を満たす SKILL.md ファイルの作成ガイドです。

ルール

  1. 1つのスキルにつき、1つの役割にします。 説明に「そして」が必要なら、分割してください。

  2. 適切な名前を付けます。 動名詞形（processing-pdfs など）を推奨します。名詞句（pdf-processing）や動詞形（process-pdfs）も問題ありません。utils や helpers など、曖昧な名前は避けてください。仕様上の制限：小文字、数字、ハイフンのみを使用し、最大64文字です。anthropic と claude は使用できません。

  3. 説明は、三人称でトリガーとして記述します。 説明によって、スキルをいつ有効にするかを判断します。「Use when...」で始め、具体的な条件を示してください。一人称の表現（「I can...」など）は見つけやすさを損ないます。最大1024文字です。

    • 悪い例：「図の作成を支援します。」
    • 良い例：「ASCII のボックス図を作成または修正するときに使い、適切な配置を確保します。」

  4. 次の構成を使用します。

    ---
name: <kebab-case-name>
description: <"Use when..." trigger description>
user-invocable: true
---

# <Short Title>

<1-2 sentences: what problem this solves.>

## Rules

<Numbered rules, each starting with a bolded imperative.>

## Verification procedure (if applicable)

<Numbered checks the agent runs on its own work.>

## Common mistakes to watch for (only if observed — see rule 9)

<Observed failure modes and how to avoid them.>

  5. 各ルールは、太字の命令形で始めます（「Use...」「Never...」など）。

  6. スクリプトではなく、ガイドラインを書きます。 目標、制約、理由を示し、手順はエージェントに選ばせてください。スクリプトは壊れやすく、トークンを消費し、モデルの進化とともに古くなります。エージェントが把握できないもの、つまりプロジェクト固有の形式、構造化出力、バグ回避策のように壊れやすい操作に限り、正確な構文や手順を示してください。あらゆる例外を網羅するのではなく、よくあるケースの推奨事項と代替策を示してください。

  7. 自明でないルールには、その理由を説明します。 そうすることで、エージェントは例外的なケースにも対応できます。

  8. エージェントが自らは行わない、具体的な確認に限って検証手順を追加します（配置の測定やバリデーターの実行など）。それ以外は省略してください。

  9. 実際に確認された間違いだけを記録します。 根拠、つまりユーザーからの報告、このセッションでの失敗、または文書化されたバグがある場合に限り、「よくある間違い」を追加してください。それ以外は省略します。推測はトークンを消費し、誤解を招きます。

  10. スキルは独立して動作するようにします。 他のスキルが読み込まれていることを前提にしないでください。

  11. 短くまとめます。 4KB 未満を目安にしてください。上限は500行です。詳細は、SKILL.md からリンクする関連ファイル（reference.md、examples.md）に移してください。入れ子のファイルは一部しか読み込まれない場合があるため、リンクは1階層までにしてください。

注意すべきよくある間違い

  • よくある間違いをでっち上げる。 各項目に根拠を示すか、省略してください（ルール9）。
  • 一般的な CLI コマンドを詳しく説明する。 エージェントは把握しており、新しいモデルほど詳しく知っています。プロジェクト固有の場合や、バグ回避策である場合に限り、コマンドを記載してください（ルール6）。
  • 長く、密度の高い文を書く。 ルールを増やさずにスキルを膨らませてしまいます。短く、平易な文を使ってください（ルール11）。
  • 同じ内容を繰り返す。 ルールを言い換えた検証リストや、内容が重複する複数のルールは避けてください。統合するか、該当するルールを参照してください（ルール11）。

コメント

Markdown 対応