スキルのインストール

チャットで話しかけるだけで、外部スキルパッケージを使って Minara を拡張できます

Minara には豊富な組み込みスキルカタログが同梱されていますが、任意の Git リポジトリから外部スキルを追加することも可能です。外部スキルはプレーンな Markdown（SKILL.md）と小さなマニフェストで構成され、ローカルインストールにベンダリングされるため、組み込みスキルと同じようにアクティベーションできます。

手軽な方法：Minara に話しかける

スキルをインストールするときは、チャットで Minara に伝えるのが推奨の方法です。Agent はスキルインストールの意図を理解し、適切なコマンドを実行します。ライセンスの確認からスキルの登録まで、REPL を離れることなく完結します。

プロンプトの例：

install this skill: https://github.com/acme/minara-skill-tax-reports

add the coinglass skill from github

vendor https://github.com/some-org/skills-monorepo, the one under
skills/invoice-parser

I want the polymarket trading skill — find and install it

upgrade my coingecko skill to latest

remove the tax_reports skill, I don't need it anymore

Minara はインストールを実行する前に確認を求めます（外部コードのインストールはティア 3 のアクション）。検出されたライセンスを表示し、スキルが登録されたことを報告します。次のセッションから新しいスキルがアクティベーション可能になります。

このフローが推奨される理由：

URL の解析、サブパスの検出、ライセンスの判断を Agent が代行します
ライセンス警告（UNKNOWN、⚠️ NONE、⚠️ PROPRIETARY）が、暗号めいた接頭辞ではなく文脈に沿った説明で伝わります
「次は ETH で試して」といった続きのやり取りが同じ会話内で自然に行えます

CLI を使う方法（希望する場合）

スクリプトや非インタラクティブな環境では、同じ操作を minara skills コマンドファミリーから実行できます。

minara skills list                          # インストール済み外部スキルを表示
minara skills add <git-url> [options]       # 新しいスキルをインストール
minara skills upgrade [<id>]                # 最新バージョンを取得
minara skills remove <id>                   # アンインストール

これらはすべてユーザーごとのスキルディレクトリ（~/.minara/skills/）に対して動作します。リポジトリのソースには触れないため、インストール済みスキルは npm install を経ても残り、メインのコードベースにコミットされません。

スキルの追加（CLI）

最もシンプルな形式は Git URL を指定するだけです。

minara skills add https://github.com/acme/minara-skill-tax-reports

Minara はリポジトリをクローンし、SKILL.md マニフェストを検出してライセンスを確認し、スキルを登録してサマリーを表示します。

✓ Installed: acme.tax_reports
  License: MIT (OK)
  Tools:   0
  Prompt:  ~420 tokens

スキルは次の minara chat セッションから利用可能になります。実行中の REPL を再起動する必要はありませんが、既に起動しているセッションには反映されません。

マルチスキルリポジトリ

1 つの Git リポジトリに複数のスキルを異なるサブディレクトリで格納できます。--subpath で対象を指定してください。

minara skills add https://github.com/acme/skills-monorepo \
  --subpath skills/tax-reports

minara skills add https://github.com/acme/skills-monorepo \
  --subpath skills/invoice-parser \
  --id acme.invoices

ID を上書きする

インストール済みスキルには、リポジトリパスから導出されたデフォルト ID が付与されます。--id で上書きできます。

minara skills add https://github.com/acme/foo --id acme.custom_name

2 つのスキルの ID が衝突する場合や、アクティベーション名を短くしたい場合に活用してください。

ref を固定する

minara skills add https://github.com/acme/foo --ref v1.2.0
minara skills add https://github.com/acme/foo --ref main
minara skills add https://github.com/acme/foo --ref 3f1e2d4

タグ、ブランチ、コミット SHA など、git checkout が受け付けるものであれば何でも指定できます。

ライセンス検出について（重要）

すべてのスキルは LICENSE ファイルのスキャンが行われます。インストーラーは次のいずれかを表示します。

結果	意味
`MIT` / `Apache-2.0` / その他 SPDX	寛容なオープンソース。安心して利用できます
`UNKNOWN`	LICENSE ファイルは存在するが、既知の SPDX 識別子に一致しない
`⚠️ NONE`	LICENSE ファイルが存在しない。注意して進めてください
`⚠️ PROPRIETARY`	再配布を禁じる条項が検出された。インストールはブロックされます

目安: UNKNOWN または ⚠️ NONE が表示された場合は、本番環境でスキルを使用する前にリポジトリを開いて LICENSE を確認してください。ライセンスが不明または曖昧な場合、そのコードを利用する権限がないことを意味します。

過去の事例として、Anthropic の公式 docx / pdf / pptx スキルには「サービス外へのコピー保持を禁止する」ライセンスが付いており、ベンダリングできません。Minara は代わりに MIT ライセンスの代替ライブラリ（docx / pdf-lib / pptxgenjs）を使用しています。

インストール済みスキルを確認する

minara skills list

acme.tax_reports           v0.3.1  MIT           ~420 tok
community.chart_generator  main    Apache-2.0    ~680 tok
local.my_workflow          —       UNKNOWN       ~210 tok

列の構成：ID、固定 ref、検出されたライセンス、プロンプトサイズ。

大きなスキル（1500 token 超）はフラグが立ちます。activation: "always" の場合、毎ターンのシステムプロンプトが膨らむため、インストールを維持する前にマニフェストを確認してください。

アップグレード

minara skills upgrade                          # 全スキルをアップグレード
minara skills upgrade acme.tax_reports         # 特定のスキルをアップグレード

Minara は固定 ref（ref が指定されていない場合は HEAD）の最新バージョンを取得し、ライセンスを再検証して、プロンプトサイズやツールの変更点を報告します。

↑ acme.tax_reports: v0.3.1 → v0.3.2
  Prompt: 420 → 445 tokens (+5.9%)
  Tools:  unchanged

アップグレードによってライセンスが変更される場合（例：MIT → プロプライエタリ）、アップグレードは拒否されます。手動で再インストールするまで古いバージョンが維持されます。

削除

minara skills remove acme.tax_reports

~/.minara/skills/ からクローンを削除し、スキルの登録を解除します。次の REPL セッションには表示されなくなります。

スキルの入手先

Minara レジストリ: Minara チームが管理するキュレーション済みスキル
GitHub 上の Cocoon-AI: 公開スキルのライブラリ（随時拡大中）（Cocoon-AI organization）
自社の Git ホスト: チーム内部向けのスキルは、Minara プロセスが URL に到達できる任意のセルフホスト型 Git サーバーに置けます

外部スキルは組み込みスキルと同じ DomainSkill コントラクトを使用します。スキルをインストールするだけでなく作成したい場合は、貢献ガイド → スキルの追加を参照してください。

トラブルシューティング

「License: ⚠️ NONE」と表示された。問題がありますか？ リポジトリによって異なります。個人の実験用であれば問題ないことが多いです。ユーザーにデプロイするものであれば、作者に LICENSE ファイルの追加を依頼してください。

「スキルの登録に失敗した」 多くの場合、SKILL.md のフロントマターの記述に問題があります。minara skills list を実行してください。失敗したスキルはパースエラーとともに表示されるため、上流リポジトリに Issue を立てられます。

「ツールの衝突：名前がすでに登録されています」 2 つのインストール済みスキルが同じツール名を宣言しています。--id でどちらかをリネームするか、重複しているほうを削除してください。

「追加後に表示されない」 requires_env が設定された外部スキルは、該当する環境変数がセットされるまで表示されません。スキルのマニフェストで必要な環境変数を確認し、.env に追加してください。