mcpField
S
skill-creator

skill-creator

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

skill-creator について

skill-creator は、Agent Skills 仕様に沿った再利用可能なスキルを作成するためのエージェントスキルです。目的の定義から構成、説明の作成、検証までを案内します。

主な機能

  1. 01目的と起動条件の定義ガイド
  2. 02ディレクトリと frontmatter の要件
  3. 03指示文の作成手順
  4. 04任意のスクリプトと参照資料の説明
  5. 05skills-ref による検証

活用シーン

  1. 01機能向けの再利用可能なスキル作成
  2. 02知識やワークフローのエージェント向けパッケージ化
  3. 03仕様に沿ったスキルの確認

インストール

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

$npx skills add https://github.com/cylixlee/skills --skill skill-creator

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

同梱ファイル

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

references/
content.md
frontmatter.md
spec.md
references/examples/
comparison.md
overview.md
simple.md
with-resources.md
with-scripts.md
references/scripts/
bun.md
deno.md
overview.md
python.md
tool-runner.md

詳細

スキルクリエイター

このスキルでは、Agent Skills 仕様に準拠した新しい Agent Skills の作成方法を説明します。何らかの機能に対応する新しいスキルを作成する必要がある場合は、これらの手順に従ってください。

このスキルを使用するタイミング

  • ユーザーから新しいスキルの作成を依頼された場合
  • 特定の機能に対応するスキルの追加をユーザーが求めている場合
  • ユーザーがスキルの定義または構築を希望している場合
  • 知識やワークフローを再利用可能なスキルとしてパッケージ化する必要がある場合

Agent Skills の基本概念

スキルは、AI エージェントの機能を拡張する、移植可能で自己説明型のパッケージです。各スキルは、指示を記載した SKILL.md ファイルを含むディレクトリです。

仕様の詳細については、references/spec.md を参照してください。

段階的な開示アーキテクチャ

スキルでは、コンテキストを効率的に管理するため、3 段階の読み込み方式を採用しています。

段階読み込まれる内容タイミングトークンコスト
カタログ名前 + 説明セッション開始時約50～100トークン
指示SKILL.md の本文全体スキルの有効化時5000トークン未満を推奨
リソーススクリプト、リファレンス、アセット参照時変動します

新しいスキルの作成

次の6つの手順に従ってスキルを作成します。

手順1：スキルの目的を決める

ファイルを作成する前に、次の内容を明確に定義します。

  • このスキルはどのような機能を提供しますか？
  • エージェントはどのような場合にこのスキルを使用すべきですか？
  • このスキルを呼び出すキーワードは何ですか？
手順2：ディレクトリ構造を作成する
skill-name/
├── SKILL.md          # Required
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
└── assets/           # Optional: templates, resources

ディレクトリ名はスキル名と一致している必要があります。

手順3：フロントマターを記述する

SKILL.md ファイルは、必須フィールドを含む YAML フロントマターで始める必要があります。

必須フィールド：

  • name：スキルの識別子（1～64文字、小文字の英字とハイフンのみ）
  • description：スキルの機能と使用するタイミング（1～1024文字）

任意のフィールド：

  • license：ライセンス名またはファイル
  • compatibility：環境要件
  • metadata：追加のキーと値のペア
  • allowed-tools：事前承認済みのツール（実験的）

フィールドの詳しい仕様については、references/frontmatter.md を参照してください。

手順4：指示の内容を記述する

フロントマターの後に続く Markdown 本文に、スキルの指示を記載します。形式の制限はありませんが、次の内容を含めてください。

  • このスキルを使用するタイミング
  • 手順ごとの指示
  • 入力と出力の例
  • よくある例外ケース

記述のガイドラインについては、references/content.md を参照してください。

手順5：任意のリソースを追加する

スキルにスクリプト、リファレンス、またはアセットが必要な場合は、適切なサブディレクトリに追加します。

  • scripts/：スキルの指示から呼び出す実行可能コード
  • references/：補足ドキュメント
  • assets/：テンプレート、データファイル、その他のリソース

スクリプトのサポートについて詳しくは、references/scripts/overview.md を参照してください。

手順6：検証する

スキルが仕様に準拠していることを確認します。

npx skills-ref validate ./skill-name

検証の詳細については、references/spec.md を参照してください。

クイックリファレンス

有効な名前のパターン
Valid:   pdf-processing, data-analysis, code-review
Invalid: PDF-Processing (uppercase), -pdf (starts with hyphen), pdf--processing (consecutive hyphens)
説明の良い例
description: Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction.

追加リソース

コメント

Markdown 対応