Skip to Content
ReferenceCLIコマンドskills

skills コマンド

skillsコマンドは、Kova が利用するスキル（AI エージェント向けのプロンプト + メタデータ）を管理するためのコマンドです。SKILL.md ファイル群を検出された AI エージェントのスキルディレクトリに同期し、自然言語で呼び出せる形に展開します。

対応エージェント

エージェントスキルディレクトリ
Claude Code~/.claude/skills/
Codex~/.codex/skills/
OpenClaw~/.openclaw/skills/
Hermes (Nous Research)~/.hermes/skills/（$HERMES_HOME/skills/ で上書き可）

デフォルトでは、システムにインストール済みのエージェントを自動検出し、すべてのスキルディレクトリに同時インストールします。--agent フラグで対象を絞ることもできます。

構文

kova skills <subcommand> [options]

サブコマンド一覧

サブコマンド説明
install <alias>プレビュー + 確認後にリポジトリグループのスキルを一括インストール
remove <alias> [--force]リポジトリグループのスキルを一括削除。確認プロンプトあり
listインストール済みスキル一覧（リポジトリグループ別）
update [alias]全スキルリポジトリを更新（alias 省略時は全リポジトリ）
search [query]利用可能なスキルを検索（installed フラグ付き）

install / remove の引数は**リポジトリエイリアス（グループ名）**です（例: base / morpho / jpyc / tcg）。個別のスキル名（send-tokens など）は指定できません。

すべての書き込み操作（install / remove / update）は owner-only（OperationKind 分類）。agent モード（非 TTY + credential）では INTERACTIVE_INPUT_REQUIRED でブロックされます。

--agent フラグ

kova skills install base --agent codex --agent openclaw

--agent は複数回指定可能です。省略時はシステムにインストール済みの全エージェントに展開されます。

skills install

リポジトリグループに含まれるスキルをプレビューして、確認後に一括インストールします。

構文

kova skills install <alias> [--agent <agent>...] [--force]

オプション

オプション必須/任意説明デフォルト
--agent任意対象エージェント（複数回指定可: claude, codex, openclaw, hermes）検出された全エージェント
--force任意インストール済みのスキルも再インストールfalse

使用例

kova skills install base

対話プロンプト（stderr）:

Skill group: base (Base Skills)
Skills (3):
  - send-tokens: Send native tokens (ETH, POL) or ERC-20 tokens...
  - check-balance: Check wallet balance...
  - manage-config: Manage Kova configuration...

? Install all 3 skills in "base"? (y/N)

出力例:

{
  "ok": true,
  "data": {
    "alias": "base",
    "installed": ["send-tokens", "check-balance", "manage-config"],
    "skipped": [],
    "failed": []
  }
}

インストール結果は stderr にも表示されます。

✓ send-tokens installed
✓ check-balance installed
✓ manage-config installed

skills remove

リポジトリグループに含まれるインストール済みスキルを一括削除します。--force なしでは確認プロンプトが出ます。

構文

kova skills remove <alias> [--force]

オプション

オプション必須/任意説明デフォルト
--force任意確認プロンプトをスキップfalse

使用例

kova skills remove base

対話プロンプト（stderr）:

Skill group: base (Base Skills)
Will remove (3):
  - send-tokens
  - check-balance
  - manage-config

? Remove all 3 skills in "base"? (y/N)

出力例:

{
  "ok": true,
  "data": {
    "removed": ["send-tokens", "check-balance", "manage-config"]
  }
}

skills list

インストール済みスキル一覧を表示します。

構文

kova skills list

使用例

kova skills list

出力例:

{
  "ok": true,
  "data": {
    "skills": [
      {
        "name": "check-balance",
        "repo": "local/base-skills",
        "installedAt": "2026-04-15T08:32:14Z"
      },
      {
        "name": "send-tokens",
        "repo": "local/base-skills",
        "installedAt": "2026-04-15T08:32:18Z"
      }
    ],
    "total": 2
  }
}

skills update

設定済みのスキルリポジトリを更新します。alias を省略すると全リポジトリを更新します。

構文

kova skills update [alias]

使用例

# 全リポジトリを更新
kova skills update
 
# 特定グループのみ更新
kova skills update base

出力例:

{
  "ok": true,
  "data": {
    "results": [
      {
        "repo": "local/base-skills",
        "updated": true
      }
    ]
  }
}

利用可能なスキルを検索します。query を省略すると全スキルを返します。マッチ条件は name の部分一致 OR description の小文字部分一致です。

構文

kova skills search [query]

使用例

kova skills search send

出力例:

{
  "ok": true,
  "data": {
    "skills": [
      {
        "name": "send-tokens",
        "description": "Send native tokens (ETH, POL) or ERC-20 tokens...",
        "repo": "local/base-skills",
        "installed": true
      }
    ],
    "total": 1
  }
}

リポジトリが未取得の場合は、ダウンロード可否を尋ねる stderr プロンプトが先に出ます。

よくあるエラーと対処法

SKILL_NOT_FOUND

エラーメッセージ（install 時 — 未知のエイリアス）:

{
  "ok": false,
  "error": {
    "code": "SKILL_NOT_FOUND",
    "message": "Unknown alias \"unknown-alias\". Run \"kova skills list\" to see available aliases."
  }
}

注意: kova skills install base のようにリポジトリエイリアスを指定してください。個別スキル名（send-tokens など）を指定すると SKILL_NOT_FOUND になります。

エラーメッセージ（remove 時 — グループ内にインストール済みスキルなし）:

{
  "ok": false,
  "error": {
    "code": "SKILL_NOT_FOUND",
    "message": "No installed skills found in group \"base\""
  }
}

対処法:

# 利用可能なエイリアスを確認
kova skills list
 
# 必要なら repo を更新
kova skills update

注意点

1. owner-only 操作

install / remove / update は owner-only です。agent モード（非 TTY + credential）では INTERACTIVE_INPUT_REQUIRED でブロックされます。これは AI エージェント内から無断でスキルを書き換えられないようにするためです。

2. SKILL.md プレビューの確認

install 時は 必ず SKILL.md の先頭 500 文字をプレビューして確認してください。スキルは自然言語プロンプトをそのまま AI エージェント（Claude Code, Codex, OpenClaw, Hermes）に渡す仕組みなので、悪意あるスキルが意図しない CLI コマンドを実行する可能性があります。

3. 依存スキル

スキルが他のスキルに依存している場合、install は依存を先にインストールします。remove はデフォルトで依存元の存在を警告するので、--force の使用は慎重に行ってください。

4. リポジトリ管理

スキルリポジトリは SKILL_REPOS で固定されており、kova skills update は全リポジトリを git pull します。任意の URL を追加する仕組みは現時点では未実装です。

関連コマンド

  • plugin — npm パッケージとしての拡張をインストール（owner-only）
  • config — lang などスキル UX に影響する設定の管理
  • launch — インストール済みスキルを AI エージェント経由で利用

関連項目

Last updated on
statusplugin