Skills概要

KovaのSkillsは、AIエージェント（Claude Code、GPT、Gemini等）が自然言語の指示をCLIコマンドに変換して実行するための拡張機能です。各Skillはトリガー条件・入力バリデーション・エラーハンドリングを内包しており、エージェントが安全にウォレット操作を自動化できます。

Skill一覧

現在提供されているSkillを以下に示します。

Skill	説明	対応コマンド
create-wallet	ウォレットのセットアップ・情報確認・エクスポート	`init` / `wallet info / export / reset-passphrase`
check-balance	残高確認	`balance`
send-tokens	トークン送金	`send`
swap-tokens	Uniswap V3 + Permit2 + Universal Router 経由のトークンスワップ	`swap`
run-tests	Kova コマンドの統合テスト自動実行	`wallet / balance / send`
manage-config	設定管理	`config set / get / list`

インストール方法

SkillsはKovaに同梱されており、npx kova@latest コマンドで即座に利用できます。別途インストールは不要です。


# 動作確認
npx kova@latest --version

AIエージェント統合の場合は、Claude Codeの設定ファイルにSkillsを追加してください。


# Claude Codeへの登録（例）
claude skills add kova

詳細はAIエージェント統合ガイドを参照してください。

共通仕様

JSON出力

すべてのSkillは、CLIと同じJSON形式で結果を返します。

成功時:


{
  "ok": true,
  "data": {
    "...": "各スキル固有のデータ"
  }
}

エラー時:


{
  "ok": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "エラーメッセージ"
  }
}

エラー自動検出

各Skillは "ok": false を検出すると、エラーコードに応じた対処法をエージェントに提示します。共通エラーコードは以下の通りです。

エラーコード	説明
`WALLET_NOT_FOUND`	指定したウォレットが存在しない
`CHAIN_NOT_SUPPORTED`	サポート外のチェーン名
`INVALID_PARAMS`	無効なパラメータ形式（アドレス・トークンシンボル・args 形式など）
`INSUFFICIENT_BALANCE`	残高不足
`POLICY_DENIED`	ポリシー違反（agent 経路）
`CREDENTIAL_REQUIRED`	agent 経路で credential 未設定

セキュリティ

dry-runデフォルト

send-tokens Skillを含む送金操作は、デフォルトで dry-run（シミュレーション） として実行されます。実際のトランザクションは --broadcast フラグを明示した場合のみ送信されます。これにより、エージェントが誤って送金を実行するリスクを防ぎます。


# dry-run（デフォルト）- トランザクションは送信されない
npx kova@latest send --to 0x... --amount 1.0 --token USDC
 
# broadcast - 実際に送金する
npx kova@latest send --to 0x... --amount 1.0 --token USDC --broadcast

入力バリデーション

すべてのSkillは、ユーザー入力をCLIコマンドに渡す前に以下を検証します：

ウォレット名：英数字とハイフンのみ（シェルメタキャラクタを拒否）
送金先アドレス：^0x[0-9a-fA-F]{40}$ 形式のみ許可
金額：数字と小数点のみ（負の値・シェルメタキャラクタを拒否）
チェーン名・トークンシンボル：サポート一覧との照合