mcpField
S
skill-creation-guide

skill-creation-guide

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

skill-creation-guide について

Agent スキル作成のガイドです。SKILL.md の構成、執筆方法、トークン効率、各プラットフォームのパスを説明し、形式と品質確認の指針を求める作成者を対象としています。

主な機能

  1. 01SKILL.md の構成とフロントマター
  2. 02執筆と段階的な情報開示の指針
  3. 03トークン効率の概要
  4. 04プラットフォーム別スキルパス
  5. 05品質チェックリスト

活用シーン

  1. 01Agent スキルの新規作成
  2. 02SKILL.md の必須メタデータ確認
  3. 03プラットフォーム別の導入先選択
  4. 04執筆基準に沿ったスキルの確認

インストール

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

$npx skills add https://github.com/gmh5225/awesome-skills --skill skill-creation-guide

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

詳細

スキル作成ガイド

対象範囲

次の場合にこのスキルを使用します。

  • 新しいエージェントスキルを作成する
  • SKILL.md の形式と規約を理解する
  • スキル作成のベストプラクティスを学ぶ

スキルの構成

skill-name/
├── SKILL.md          # Required: Instructions and metadata
├── scripts/          # Optional: Helper scripts
├── templates/        # Optional: Document templates
└── resources/        # Optional: Reference files

SKILL.md の形式

必須のフロントマター
---
name: my-skill-name
description: A clear description of what this skill does and when to use it.
---
本文の構成
# Skill Name

Detailed description of the skill's purpose.

## When to Use This Skill

- Use case 1
- Use case 2

## Instructions

[Detailed instructions for the agent]

## Examples

[Real-world examples]

ベストプラクティス

  1. 説明を網羅的にする：フロントマターの説明は、エージェントがスキルをいつ起動するか判断するのに役立ちます。
  2. 実行に重点を置く：本文には、明確で実行可能な手順を記載します。
  3. 段階的な情報開示を活用する：詳細なリファレンスは references/ フォルダーに配置します。
  4. 自動化用のスクリプトを含める：決定論的な操作にはヘルパースクリプトを使用します。
  5. SKILL.md を500行未満に保つ：最適なパフォーマンスを得るためです。
  6. 複数のプラットフォームでテストする：スキルが Claude Code、Codex などで動作することを確認します。

トークン効率

スキルでは、段階的な情報開示のアーキテクチャを採用しています。

  1. メタデータの読み込み（約100トークン）：エージェントが利用可能なスキルを確認します
  2. すべての指示（5kトークン未満）：スキルが有効化されたときに読み込みます
  3. 同梱リソース：必要に応じてのみ読み込みます

プラットフォーム固有のパス

プラットフォームプロジェクトパスグローバルパス
Claude Code.claude/skills/~/.claude/skills/
Codex.codex/skills/~/.codex/skills/
Cursor.cursor/skills/~/.cursor/skills/
Gemini CLI.gemini/skills/~/.gemini/skills/
GitHub Copilot.github/skills/~/.copilot/skills/

品質チェックリスト

  • 明確で実行可能な指示がある
  • 実例が含まれている
  • エンドユーザーではなく、AI エージェント向けに書かれている
  • 前提条件と依存関係が記載されている
  • エラー処理のガイダンスが含まれている
  • 対象のプラットフォームでテストされている

リソース一覧

スキル作成に関するより詳しいリソース、リンクの完全な一覧、または最新情報を確認するには、WebFetch を使用して完全な README.md を取得します。

https://raw.githubusercontent.com/gmh5225/awesome-skills/refs/heads/main/README.md

README.md には、すべてのリンクを含む、カテゴリ別に整理された完全なリソース一覧が記載されています。

コメント

Markdown 対応