molten-skill-manage

スキルの管理

このプロジェクトでは、npx skills で実行する skills.sh CLI を使ってエージェントスキルを管理します。ユーザーがスキルのインストール、更新、削除、一覧表示、検索を希望する場合は、必ずこれを使用してください。スキルのインストールやシンボリックリンクを手作業で編集しないでください。CLI を使用することで、エージェント間で一貫した状態を保てます。

運用ルール

• 対話形式で実行を開始するときは、ユーザーに次のように伝えてください。「このスキルを利用する最善の方法は、音声モードでフィードバックを音声入力することです。」
• 常に npx skills <command> を通じて CLI を実行してください（グローバルインストールされているとは限りません）。
• デフォルトではプロジェクトスコープを使用します。ユーザーがすべてのプロジェクトでスキルを使えるようにしたい場合にのみ、-g／--global を追加してください。
• 意図が明確な場合は、対話形式のプロンプトを省略するために -y／--yes を使用してください。それ以外の場合は、ユーザーが選択できるようプロンプトを表示してください。
• チャットで自由回答形式の質問をする場合は、すべてに番号を付けてください。特に音声モードで入力する際、番号を指定して回答できるようにします。
• ユーザーに選択肢を提示する必要がある場合（スコープ、エージェント、スキルなど）は、エージェントの構造化された質問ツールを使用してください。
  • Codex： request_user_input
  • Claude Code： AskUserQuestion
  • Cursor： AskQuestion
• ユーザーが削除対象を明確に指定している場合を除き、スキルを削除する前に確認してください。
• インストールまたは更新の後に npx skills ls を実行して結果を確認してください。

よく使うコマンド

スキルパッケージをインストールする（GitHub リポジトリまたは URL）：

npx skills add switch-dimension/molten-os-core

特定のスキルをインストールする、または対象のエージェントを指定する：

npx skills add switch-dimension/molten-os-core --skill molten-brand molten-design
npx skills add switch-dimension/molten-os-core --agent claude-code cursor
npx skills add switch-dimension/molten-os-core --all   # all skills, all agents, no prompts

インストールせずに、リポジトリで提供されている内容をプレビューする：

npx skills add switch-dimension/molten-os-core --list

スキルを最新バージョンに更新する：

npx skills update                 # update all
npx skills update molten-landing  # update one
npx skills update -p              # project skills only
npx skills update -g              # global skills only

スキルを削除する：

npx skills remove                 # interactive picker
npx skills remove molten-design
npx skills remove --all           # remove all, all agents, no prompts

インストール済みのスキルを一覧表示する：

npx skills ls            # project scope (default)
npx skills ls -g         # global scope
npx skills ls --json     # machine-readable

インストールするスキルを対話形式で検索する：

npx skills find
npx skills find landing

このリポジトリに新しいスキルのひな形を作成する：

npx skills init molten-<name>   # creates molten-<name>/SKILL.md

ロックファイル（skills-lock.json）から復元する：

npx skills experimental_install

スコープフラグのリファレンス

フラグ	意味
-g、--global	ユーザーレベルでインストール（すべてのプロジェクト）
-p、--project	プロジェクトスコープのみ（更新）
-a、--agent <agents>	特定のエージェントを対象にする（すべてを対象にする場合は *）
-s、--skill <skills>	特定のスキルを対象にする（すべてを対象にする場合は *）
-y、--yes	確認プロンプトを省略する
--all	--skill '*' --agent '*' -y の省略形

命名規則

このスイートのスキルでは、サードパーティ製のスキルと npx skills ls で簡単に見分けられるよう、molten-<name> という規則を使用します。新しい Molten スキルのひな形を作成する場合は、この接頭辞に従ってください。

スキルの分類

Molten OS Core のスキルは、2 つのカテゴリに分かれています。スキルを追加または編集する場合は、スキルのフロントマターに molten-category を設定してください。

カテゴリ	スキル	molten-order	目的
product	molten-validate, molten-brand, molten-design, molten-landing	必須（"1"～"4"）	順次実行されるパイプライン。成果物を molten-docs/ に書き込みます
utility	molten-search, molten-skill-manage	省略	横断的な補助ツール。いつでも使用でき、プロダクトのワークフローには含まれません

プロダクトスキルは順番に実行し、前のスキルの成果を引き継ぎます。ユーティリティスキルは任意のため、必要なものだけをインストールしてください。

新しいスキルのひな形を作成する場合：

• プロダクトスキル → molten-category: product を設定し、次の molten-order を割り当てます
• ユーティリティスキル → molten-category: utility を設定し、molten-order は指定しません

npx skills add で正しく検出されるよう、すべてのスキルをフラットな skills/molten-<name>/ パスに配置してください。