create-plugin-scaffold

プラグインのひな形を作成する

トリガー

Cursor プラグインを一から作成し、ローカルでの使用またはマーケットプレイスへの申請ができる状態にする必要があります。

必須入力

• プラグイン名（小文字のケバブケース）
• プラグインの目的と対象ユーザー
• 含めるコンポーネントのセット（rules、skills、agents、commands、hooks、mcpServers）
• リポジトリの形式（single-plugin または multi-plugin marketplace）

出力先

デフォルトでは、ユーザーのローカルプラグインディレクトリ内にプラグインを作成します。

~/.cursor/plugins/local/<plugin-name>/

このパスに作成すると、インストール手順なしですぐに Cursor でプラグインを利用できます。既存のリポジトリ内や特定のディレクトリなど、別の場所への作成をユーザーが明示的に指定した場合は、その指定に従ってください。

ワークフロー

1. プラグイン名の形式を検証します。小文字のケバブケースで、英数字で始まり、英数字で終わる必要があります。
2. 対象ディレクトリを決定します。
   • デフォルト：~/.cursor/plugins/local/<plugin-name>/
   • 上書き：ユーザーがパスを指定した場合は、そのパスを使用します。
   • ディレクトリが存在しない場合は、ディレクトリ（および親ディレクトリ）を作成します。
3. 対象ディレクトリ内に基本ファイルを作成します。
   • .cursor-plugin/plugin.json
   • README.md
   • LICENSE
   • 任意の CHANGELOG.md
4. plugin.json に内容を設定します。
   • 必須：name
   • 推奨：version、description、author、license、keywords
   • デフォルト以外の検出方法が必要な場合に限り、コンポーネントのパスを明示的に追加します。
5. 有効なフロントマターを含むコンポーネントファイルを作成します。
   • ルール：description、alwaysApply、任意の globs を含む .mdc
   • スキル：name、description を含む skills/<skill-name>/SKILL.md
   • エージェント：name、description を含む agents/*.md
   • コマンド：name、description を含む commands/*.(md|txt)
6. リポジトリで .cursor-plugin/marketplace.json を使用している場合は、プラグインのエントリーを追加します。
   • name
   • source
   • 任意のメタデータ（description、keywords、category、tags）
7. すべてのマニフェストパスが相対パスで有効であり、絶対パスや親ディレクトリへの移動を使用していないことを確認します。

ガードレール

• プラグインの用途は一つに絞ってください。
• 長い文章よりも、簡潔で実行しやすいスキルやルールの記述を優先してください。
• 存在しないファイルを参照しないでください。
• カスタムパスが必要な場合を除き、フォルダー検出のデフォルト設定を使用してください。
• ユーザーが別のパスを指定しない限り、必ず ~/.cursor/plugins/local/<plugin-name>/ に保存してください。

出力

• プラグインの作成ファイルツリー（出力ディレクトリの完全なパスを含む）
• 最終的な plugin.json
• マーケットプレイスのエントリー（該当する場合）
• 必須フィールドとコンポーネントのメタデータに関する簡潔な検証レポート
• プラグインが ~/.cursor/plugins/local/ に保存され、すぐに使用できる状態であることの確認