Multica Docs

スキル

よく使う指示、手順、資料をまとめ、複数のエージェントで再利用できるスキルにします。

スキルは、ワークスペースで再利用できる仕事の進め方のセットです。SKILL.md を主ファイルとし、スクリプト、テンプレート、参考資料を添付できます。

スキルをエージェントに追加すると、エージェントは関連する作業の実行時にその内容を使います。同じ手法を各エージェントの指示へ複製する必要がなくなり、修正も 1 か所で済みます。

スキルとエージェントの指示

エージェントの指示スキル
向いている内容このエージェントの長期的な職責、境界、成果物の要件ある種類の仕事で再利用できる手順、資料、ツール
適用範囲1 つのエージェントに属し、毎回の実行で提供される複数のエージェントに追加でき、個別に有効化・無効化できる
「フロントエンドコードのレビューだけを行い、直接修正しない」アクセシビリティのチェックリストと報告テンプレート

スキルの作成とインポート

ワークスペースの スキル ページで「新規スキル」を選ぶと、4 つの方法が使えます。

方法向いている場合
手動で作成空白の SKILL.md から書き始める。
ローカルからインポートSKILL.md を含むフォルダ、またはこのコンピュータ上の .skill / .zip アーカイブを選ぶ。
URL からインポートGitHub、ClawHub、Skills.sh で公開済みのスキルをインポートする。
ランタイムからコピー接続中のコンピュータにあるスキルをスキャンし、選んだものをワークスペースへコピーする。

ランタイムからのコピーは、その時点のファイルのスナップショットです。後からローカルファイルが変わっても、ワークスペース側のバージョンは自動更新されません。再インポートするか、Multica 上で編集してください。

同じアーカイブ形式は CLI からも使えます。

multica skill import --file ./review-helper.skill

インポート時にワークスペースへ同名のスキルがすでにある場合は、インポートの中止、既存内容の上書き、新しい名前での保存、スキップのいずれかを選べます。インポートによる上書きができるのは、そのスキルの作成者本人だけです。ワークスペースの admin は、アプリ内でスキルを編集できても、インポートで上書きすることはできません。すでにワークスペースにあるスキルへ新しいバージョンを取り込むには、代わりにインポート済みスキルの更新を使ってください。

インポート済みスキルの更新

GitHub・ClawHub・Skills.sh からインポートしたスキルは、そのソースへの参照を保持しています。最新バージョンを取り込むには、スキルページの更新ボタン(または一覧の行メニューの「ソースから更新」)か、CLI を使います:

multica skill refresh <skill-id>

スキルはソースから再ダウンロードされ、その場で置き換えられます:

  • 保持されるもの:スキルの同一性 —— エージェントへの割り当て、ラベル、作成者、作成日時。エージェントが再追加する必要はありません。
  • 置き換えられるもの:名前(ソース側で改名された場合はそれに従います)、説明、SKILL.md、すべての補助ファイル。スキルへのローカル編集は上書きされます。

ソースから更新できるのは、スキルの作成者とワークスペースの owneradmin です。手動で作成したスキル、アーカイブファイルからインポートしたスキル、ランタイムからコピーしたスキルにはホストされたソースがないため、この方法では更新できません。再インポートしてください。

複数のスキルをまとめて更新するには、スキル一覧で選択して選択ツールバーの更新を使います。ホストされたソースを持つ選択中のスキルはすべてソースから再ダウンロードされ、ソースのないものはスキップされます。

スキルの内容

すべてのスキルには、主ファイル SKILL.md があります。ここに次の内容を書きます。

  • このスキルが適用される場面
  • 開始前に確認すること
  • 実行手順
  • 結果をどんな形で提出するか
  • どんな場合に停止してメンバーへ確認するか

補助ファイルも追加できます。例:

SKILL.md
references/api-conventions.md
templates/review-report.md
scripts/check.sh

SKILL.md は予約されたパスで、同名の補助ファイルは作成できません。補助ファイルは、主ファイルと一緒にエージェントへ提供されます。

エージェントへの追加

スキルを作成またはインポートしたら、さらに具体的なエージェントへ追加する必要があります。スキルのページでエージェントを選ぶことも、エージェントの スキル タブから管理することもできます。

  • 1 つのエージェントは複数のスキルを使えます。
  • 同じスキルを複数のエージェントで使えます。
  • しばらく使わないときは、スキルを削除せず紐づけを無効化できます。
  • 編集した内容は以降の実行から有効になり、すでに実行中の作業は変わりません。

エージェントへのスキルの追加、削除、無効化ができるのは、そのエージェントを変更する権限を持つメンバーだけです。

ワークスペーススキルとリポジトリ内のスキル

ワークスペーススキルは Multica に保存されます。チームで共同でメンテナンスし、さまざまなエージェントに追加する使い方に向いています。

一部の AI コーディングツールは、.claude/skills/.agents/skills/ など、コードリポジトリ内のプロジェクトレベルのスキルも直接読み込みます。これらのファイルはリポジトリの管理下のままで、Multica が自動的にワークスペーススキルとして登録することはありません。具体的な対応方法は使用するツールによります。AI コーディングツール対応表を参照してください。

接続中のコンピュータにインストール済みのランタイムローカルのスキル(Claude Code と Codex)は、エージェントの スキル タブに表示され、エージェントごとに個別に無効化できます。無効化にも、そのエージェントを変更する権限が必要です。

変更権限

どのワークスペースメンバーでもスキルを作成・インポートできます。作成者とワークスペースの owneradmin は変更と削除ができます。ほかのメンバーは閲覧と利用はできますが、内容の上書きはできません。

削除は永久的な操作で、すべてのエージェントから同時にそのスキルが取り外されます。

外部からインポートしたスキルには、スクリプト、コマンド、安全でない指示が含まれることがあります。Multica が代わりに審査、署名、サンドボックス化することはありません。インポートした内容はそのままエージェントに渡されて実行されるため、信頼できるソースからインポートしてください。

次のステップ