mcpField
S
skill-creation

skill-creation

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

skill-creation について

エージェントスキルの作成者向けガイドです。単一ファイル型と複数トピックを扱うルーティング型を区別し、構成、メタデータ、記述上の制約を示します。

主な機能

  1. 01単一ファイル型とルーティング型
  2. 02構成の選択ルール
  3. 03SKILL.md テンプレート
  4. 04フロントマターの要件
  5. 05本文の記述上の制約

活用シーン

  1. 01新しいスキルの構成選択
  2. 02トピック別の指示整理
  3. 03スキルのメタデータと本文の確認

インストール

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

$npx skills add https://github.com/naykel76/skills-and-guidelines --skill skill-creation

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

詳細

2 つのパターン — どちらか 1 つを選択

スキルは スタンドアロンスキル または ルーティングスキル のいずれかです。両者は相互に排他的です。決して混在させないでください。

判断基準： このスキルは、それぞれに独自の指示ファイルが必要な、複数の異なるサブトピックを扱いますか？ はい → ルーティングスキル。いいえ → スタンドアロンスキル。

迷った場合は、スタンドアロンスキルから始めてください。

パターン 1：スタンドアロンスキル

単一の SKILL.md ファイルです。rules/ ディレクトリはありません。

スキルが 1 つのまとまったトピックを扱い、単一のファイルに収まる場合に使用します。

構成
skill-name/
└── SKILL.md
テンプレート
---
name: skill-name
description: >-
  Use this skill whenever [condition]. Do not wait for an explicit
  request — if [condition], this skill applies.
---

## Rules

- Directive one
- Directive two

## Workflow

1. Step one
2. Step two

パターン 2：ルーティングスキル

ルーターとして機能する SKILL.md と、サブトピックごとに 1 つのファイルを格納した rules/ ディレクトリで構成されます。

スキルが単一のファイルに収めると肥大化する複数の異なるサブトピックを扱い、すべてのサブトピックで同じトリガー条件を共有する場合に使用します。

構成
skill-name/
├── SKILL.md
└── rules/
    ├── topic-one.md
    └── topic-two.md
rules/ ディレクトリのルール
  • 各ファイルで、1 つのまとまったサブトピックを扱う
  • サブトピックに合わせて、ファイル名はケバブケースにする（例：file-uploads.md）
  • すべてのルールファイルをデフォルトで読み込まないこと。エージェントは現在のタスクに応じて、該当するファイルのみを読む
  • ルールファイルは、存在するまで参照しないこと。もしくは、同じ変更で作成すること
テンプレート
---
name: skill-name
description: >-
  Use this skill whenever [condition]. Do not wait for an explicit
  request — if [condition], this skill applies.
---

# Skill Title

One-line context for what this skill governs.

## Non-Negotiable Constraint

State the single most important rule here — the one that must be followed
regardless of which rule file is read. Omit this section if no such rule exists.

## Rule Files

Read the relevant rule file before proceeding. Summaries below are for
navigation only — the rule files take precedence.

### Topic One → `rules/topic-one.md`

- Key directive
- Key directive

### Topic Two → `rules/topic-two.md`

- Key directive
- Key directive

フロントマター（どちらのパターンも対象）

  • name — ケバブケースにし、フォルダー名と一致させる
  • description — 要約ではなく、トリガーの仕組みを記述する
    • 常に YAML ブロックスカラー（>-）を使う。インライン文字列として記述しない
    • 「Use this skill whenever [condition]...」の形式で記述する
    • スキルが明示的にトリガーされた場合にのみ有効となる場合を除き、「Do not wait for an explicit request — if [condition], this skill applies.」で終える
    • 実装上の注意や手順のガイダンスは記載せず、トリガー条件のみを記述する

本文（どちらのパターンも対象）

  • タスクを確実に進めるために必要な指示だけを記載する。推測に基づく例外ケースを追加したり、継承されたガイダンスですでに説明されているルールを繰り返したりしない

  • 更新時は、セクションや手順を追加する前に、既存の表現を修正する

  • 保存前に、エージェントの行動に影響しない内容を削除する

  • 説明ではなく指示を記述する。スキルの内容を説明するのではなく、エージェントがすべきことを指示する

  • トリガー条件と必須制約は SKILL.md に記載する

  • 外部ドキュメントを参照する場合は、パスを明記する

コメント

Markdown 対応