mcpField
C
create-skill

create-skill

github.com/jasonharmongitエージェントワークフロー38 回インストール
リポジトリ

create-skill について

SKILL.md形式のエージェントスキル作成ガイドです。必須のフロントマター、ディレクトリ構成、簡潔な指示を書く原則を説明し、スキルの作成者を支援します。

主な機能

  1. 01YAMLフロントマター項目の定義
  2. 02スキルのファイルとフォルダー構成
  3. 03簡潔な執筆原則の適用

活用シーン

  1. 01新しいSKILL.mdファイルの作成
  2. 02参考資料や例示ファイルの構成
  3. 03エージェント向け指示の簡潔化

インストール

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

$npx skills add https://github.com/jasonharmongit/jh-skills --skill create-skill

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

詳細

スキルの作成

スキルの構成

フロントマター

すべての SKILL.md ファイルは、YAML フロントマターから始まります。

---
name: your-skill-name
description: Brief high-level description of what this skill does.
disable-model-invocation: true
---
  • name：スキルを識別するケバブケース形式の名前
  • description：スキルの機能を非常に大まかにまとめた1文です。スキルの仕組みや、呼び出すタイミング、トリガーとなる用語について具体的に記載しないでください。
  • disable-model-invocation：スキルが明示的に指定された場合にのみ読み込まれるよう、デフォルトで disable-model-invocation: true を含めてください。

スキルファイルの構造

ディレクトリ構成

スキルは、SKILL.md ファイルを含むディレクトリとして保存されます。

skill-name/
├── SKILL.md              # Required - main instructions
├── reference.md          # Optional - detailed documentation
├── examples.md           # Optional - usage examples
└── scripts/              # Optional - utility scripts
    ├── validate.py
    └── helper.sh

作成の基本原則

1. 簡潔さが重要

コンテキストウィンドウは、会話履歴、ほかのスキル、リクエストと共有されています。すべてのトークンが限られた容量を奪い合います。

前提：エージェントはすでに非常に賢いものとします。エージェントがすでに知っていることは、コンテキストに加えないでください。

情報の一つひとつを検討してください。

  • 「エージェントに本当にこの説明が必要ですか？」
  • 「エージェントが知っていると想定できませんか？」
  • 「この段落は、トークンを消費するだけの価値がありますか？」

コメント

Markdown 対応