create-skill

スキルの作成

.agents/skills/README.md で定義されているワークフローに従い、.agents/skills/<skill-name>/ に新しいスキルを作成します。

ワークフロー

ステップ 1: 意図の確認

何かを作成する前に、ユーザーに確認します:

1. スキル名: スキルの名前は何にしますか？（小文字、数字、ハイフンのみ。例: gh-create-pr、prepare-release）
2. 説明: このスキルは何をしますか？具体的なトリガーとなる状況を含めてください（例: 「ユーザーが PR の作成を依頼したときに使用する」）
3. これは公開スキルですか？: 共有利用のために .claude/skills/ に同期すべきですか？（デフォルト: いいえ、プライベートのみ）
4. テストケース（任意）: このスキルに eval を設定しますか？

ユーザーが部分的な情報（名前だけなど）しか提供しない場合は、妥当なデフォルト値で進め、確認を求めます。

ステップ 2: ガイドラインの確認

新しいスキルを作成する前に、現在のワークフローに準拠していることを確実にするため、必ず .agents/skills/README.md を読んでください。

ステップ 3: スキル構造の作成

次のディレクトリ構造を作成します:

.agents/skills/<skill-name>/
└── SKILL.md

SKILL.md テンプレート:

---
name: <skill-name>
description: <description>
---

# <Skill Name>

[Instructions for the skill]

Frontmatter のフィールド:

• name: スキルの識別子（小文字、数字、ハイフン）
• description: いつトリガーするか（スキルが行うこと + 具体的な状況）

ステップ 4: 同期（公開の場合）

ユーザーが公開スキルを希望する場合は、検証の前に:

1. .agents/skills/public-skills.txt にスキル名を追加します（1 行に 1 つ、インラインコメントなし）
2. 同期を実行します:

   pnpm skills:sync
   

これにより、.agents/skills/<skill-name>/ を指すシンボリックリンクが .claude/skills/<skill-name>/ に作成されます。

注意: pnpm skills:check は主に公開スキル（public-skills.txt にあるもの）を検証し、関連するガバナンスファイルも確認するため、検証の前に必ず先に同期する必要があります。

ステップ 5: 検証

検証コマンドを実行します:

pnpm skills:check

問題がある場合は修正し、再実行してください。

ステップ 6: まとめ

ユーザーに次を提示します:

• 作成されたファイル
• 検証結果
• 次のステップ（スキルの使用方法）

命名規則

• 小文字、数字、ハイフンのみを使用してください
• 短く、動作を表す名前を推奨します（例: gh-create-pr）

公開スキルとプライベートスキル

種類	場所	同期	必要なこと
プライベート	.agents/skills/	いいえ	フォルダを作成するだけ
公開	両方	はい	public-skills.txt に追加 + pnpm skills:sync を実行

コマンドリファレンス

# Validate skill structure
pnpm skills:check

# Sync public skills to Claude
pnpm skills:sync

制約

• .agents/skills/<skill-name>/ 以外にスキルを作成しないでください
• 完了する前に必ず pnpm skills:check を実行してください
• 公開スキルには、public-skills.txt への追加と pnpm skills:sync の実行の両方が必要です
• skill-creator スキルが利用可能な場合は、高度なスキル開発（eval、イテレーション）にそれを使用してもかまいませんが、このスキルは基本的な作成ワークフローを扱います。