skill-creator

スキル作成ツール

「小さなシニアエンジニア」のように振る舞うスキルを作成します。適切に起動し、決定論的に動作し、再開可能な成果物をディスクに残します。

優れたスキルとは（Ship Faster の基準）

• SKILL.md：短く、適切に起動できる内容にします（ルーティング＋安全性＋入出力＋出力仕様）。長いチュートリアルはここに書かないでください。
• references/：必要なときだけ読み込む詳細ドキュメントです（段階的な開示）。SKILL.md から直接リンクしてください。
• scripts/：繰り返しの多い作業や壊れやすい作業に使う、決定論的なヘルパーです（チャットでコードを書き直すより、こちらを優先してください）。
• assets/：コピーして使うテンプレートやファイルです（コンテキストへの読み込みを想定していません）。

詳細なガイダンス：

• 段階的な開示と作成の原則：references/skill-design-principles.md
• ワークフロー構成のパターン：workflows.md
• 出力テンプレートとパターン：output-patterns.md

作成の流れ（推奨）

1. 起動例を収集する（スキルを起動すべき実際のユーザーの言い回し）。
2. 入出力仕様を定義する（パスのみ）＋必要な成果物：
   • スキルが読み込むファイルは何ですか？
   • スキルが書き出す必要のあるファイル（計画、根拠、要約）は何ですか？
3. 再利用可能なリソースを先に実装する：
   • 決定論的な処理には scripts/ を追加します
   • 大規模なドキュメントには references/ を追加します
   • テンプレートやひな形には assets/ を追加します
4. 最後に SKILL.md を作成する：
   • フロントマターの description に起動フレーズを含めます
   • 本文は短くし、上記のリソースにリンクします
5. 検証してパッケージ化する（任意）。以下のスクリプトを使用します。

スクリプト

すべてのスクリプトは、このスキルフォルダー内の scripts/ にあります。

新しいスキルフォルダーを初期化する

python scripts/init_skill.py <skill-name> --path <output-directory>

スキルを検証する（フロントマター＋基本的な規約）

python scripts/quick_validate.py /path/to/<skill-name>

カタログ／アセットを同期する（マニフェスト、skills-map、ドキュメントカタログ）

python scripts/sync_catalog.py

スキルをリントする（互換性＋品質ゲート）

python scripts/skill_lint.py --check-generated

スキルを配布可能な .skill zip にパッケージ化する（任意）

python scripts/package_skill.py /path/to/<skill-name> [output-directory]

Ship Faster のコントリビューター向けの注意事項

• 接頭辞を付けた命名を優先してください：workflow-、tool-、review-、mcp-、skill-、publish-。
• 副作用を伴う操作にはゲートを設けてください。まず計画を書き、明示的な確認を求めてから実行し、その後に検証します。
• スキルを追加／削除する場合は、カタログを更新してください：skills/manifest.json。

Claude Code：スラッシュコマンドをスキルに統合

Claude Code では、カスタムスラッシュコマンドとスキルは同じ概念として扱われるようになりました。

• .claude/commands/<name>.md と .claude/skills/<name>/SKILL.md は、どちらも /<name> を作成します
• 既存の .claude/commands/ ファイルは引き続き動作します（移行は不要です）
• 今後は スキル の作成を優先してください。references/ や scripts/ をまとめられ、サブエージェントも使用できます

便利なフロントマター設定項目（Claude Code）：

• disable-model-invocation: true - ユーザーのみが起動できます（副作用を伴うワークフローに適しています）
• user-invocable: false - ユーザーには表示されず、Claude のみが使うバックグラウンド知識になります
• context: fork + agent: Explore|Plan|... - スキルをサブエージェントで実行します（調査に適しています）
• allowed-tools - このスキルが有効な間に使えるツールを制限します

旧版の詳細ガイド

以前の長いバージョンのこのスキルは、次の場所に保存されています。

• references/legacy-skill-creator.md