tool-skill-creator-extension

Tool / Skill Creator Extension

SKILL はリポジトリ横断・環境横断で再利用される。ツールチェイン管理（mise / fvm / asdf 等）の prefix・wrapper は プロジェクト固有の実行規約 であり、SKILL 本文に焼き付けると他環境でノイズになる。 コマンド例は素のツール呼び出しだけを書き、実行時の wrapper は各プロジェクトのルール（AGENTS.md 等）に任せる。

共有アセット（テンプレート・雛形・パッケージ配下の .apm/assets/ 等）を参照する場合も、 インストール先の 1 パスを直書きせず、{assets}/ と ## アセットディレクトリ で解決できるようにする。

さらに SKILL 本文から他 package の SKILL / command / パスを参照する場合は、 編集対象 package の apm.yml が宣言する依存グラフに従う。ワークスペースに兄弟 package が並んで見えても、 未宣言の参照や逆依存を残すと、導入した第三者が混乱する。

本 SKILL は skill-creator の補足である。SKILL を新規作成・改訂するときは本ルールも適用する。

いつ使うか

• 新規 SKILL の SKILL.md / references/ にシェルコマンド例を書くとき
• 既存 SKILL から mise exec -- 等の project-local wrapper を除去・正規化するとき
• skill-creator のドラフト・レビューで「コマンドの書き方」を点検するとき
• SKILL 本文から共有アセット（テンプレート等）を参照するとき
• {assets}/ や ## アセットディレクトリ を追加・移行するとき
• SKILL 本文で他 SKILL / command 名を明示参照するとき
• 他 package パスを本文や例に書くとき
• apm.yml の依存と SKILL 参照の整合・未宣言依存・逆依存を点検・修正するとき

コアルール

frontmatter（license / metadata）

• name / description 以外の frontmatter は Optional
• license と metadata（metadata.author 含む）は、ユーザーが明示指定したときだけ書く
• 既定値（例: MIT License、author: "@eaglesakura"）で勝手に埋め込まない
• 指定が無い新規・改訂では、これらのキーを frontmatter に残さない（削除してよい）

SKILL に書くコマンド（portable）

• ツール本体の呼び出しだけを書く（dart / flutter / go / npm / npx など）
• プロジェクト固有のツールチェイン wrapper・prefix・suffix は 含めない
  • 例: mise exec -- / mise run / fvm / asdf exec / direnv exec / nix-shell --run

DO: ツール本体だけを書く

dart -h
flutter --version
go test ./...
npx markdownlint-cli2 --fix path/to/file.md

DO NOT: ツールチェイン wrapper を埋め込む

mise exec -- dart -h
fvm flutter --version
asdf exec go test ./...

実行時（runtime）の扱い

SKILL を 実際に実行する ときは、この限りではない。

• 作業対象リポジトリに mise / fvm 等の規定があれば、そのプロジェクトルールに従う
• 規定の所在は AGENTS.md・リポジトリ README・既存スクリプトを優先して確認する
• SKILL 本文を「実行用の最終コマンド」と同一視しない（本文は portable、実行は local policy）

必要なら SKILL 側に次のような一文を置いてよい（具体的な wrapper 名は書かない）。

コマンド実行時は、プロジェクト規定のツールチェイン（あれば）に従う。