ov-skills

OpenViking（OV）スキル管理

ov skills コマンドグループでは、OpenViking 上のエージェントスキルを管理します。ローカルディレクトリ、Git リポジトリ、GitHub URL、または生コンテンツからのインストール、スキルの一覧表示、検索、確認、更新、削除、ローカルでのスキル形式の検証を行えます。ov add-skill は ov skills add と同じコマンドで、同じフラグを指定します。

目的

フラグ、ソースの種類、更新の動作を推測せずに、スキルのライフサイクル操作に適した ov skills サブコマンドをエージェントが正しく実行できるようにします。

使用するタイミング

• ユーザーが明示的にスキル管理を依頼した場合：ov skills ...、install skill、update skill、delete skill、remove skill。
• ユーザーが SKILL.md またはスキルディレクトリの検証を依頼した場合。
• ユーザーがインストール済みスキルの検索を依頼した場合。
• ユーザーがスキルの内容、ファイル、またはソースの確認を依頼した場合。
• エージェントがスキルを選ぶ前に、利用可能なスキルを見つける必要がある場合。

入力

名前	必須	説明
subcommand	はい	list（別名 ls）、find、add、show、update、remove（別名 rm、delete）、validate のいずれか
argument	条件付き	show／update／remove 用のスキル名、find 用の検索クエリ、add 用のソースパス／URL または生の SKILL.md テキスト、validate 用のローカルパス
root	いいえ	-p で指定するスキルルート URI：viking://~/skills（プライベート）または viking://agent/skills（アカウントで共有）。add はデフォルトでプライベートルートを使用します。list／find は両方のルートを検索します。show／update／remove は、名前からまずプライベート側のコピーを解決し、次に共有側のコピーを解決します。
level	いいえ	show／find 用の -L／--level：0（概要）、1（概説）、2（SKILL.md 全文）

ワークフロー

1. ユーザーの意図を特定し、適切な ov skills <subcommand> に対応づけます。
2. add のソースの種類（ローカルディレクトリ、ローカルファイル、Git URL、GitHub ツリー URL、生コンテンツ）を判断します。ソースに複数のスキルが含まれる可能性がある場合は、最初に ov skills add <source> --list を実行し、--skill でスキルを選びます。
3. examples/commands.md に記載されているフラグのみを使用してコマンドを組み立てます。-p の長形式は、list／find／show では --uri、add／update／remove では --parent-auto-create です。機械可読な出力にするには、グローバルオプション -o json を追加します。
4. コマンドを実行し、結果を報告します。

権限

• ov skills add は外部コードをダウンロードしてインストールする場合があります。ユーザーが信頼できない URL を指定した場合は、ソースを確認してください。
• ov skills update と ov skills remove は常に確認を求めます。また、ソースに複数のスキルが含まれる場合、ov skills add も確認を求めます。ターミナルがない場合、コマンドは requires confirmation. Pass --yes to skip the prompt. というエラーで失敗します。会話内でユーザーに確認してから、--yes を付けて再実行してください。
• ov skills remove --all は破壊的な操作です。実行前にユーザーへ確認してください。
• ov skills update はスキルの内容をその場で置き換えます。旧バージョンは保持されません。

出力

• CLI の出力はそのままユーザーに返します。デフォルトでは表形式、-o json を指定すると JSON 形式です（show は --format json も受け付けます）。
• エラーには修正方法が提示されます。

検証

• add の後、list に新しいスキルが表示されることを確認します。--wait を指定しない場合、処理がバックグラウンドで続くことがあります。ov task status <task_id> で確認してください。
• remove の後、list に削除したスキルが表示されないことを確認します。
• update の後、show <name> --level 2 で新しい SKILL.md が表示されること、また show <name> --source で記録されたソースが表示されることを確認します。

制約

• スキル名や URL を捏造しないでください。ユーザーが提供したものを使用してください。
• ユーザーの明示的な確認なしに ov skills remove --all を実行しないでください。
• スキル名を指定せずにエージェントシェルから ov skills remove を実行しないでください。ターミナルが必要な対話型ピッカーが開きます。
• スキルの削除には ov rm ではなく ov skills remove を使用してください。スキルのプライバシー設定も削除するのは ov skills remove のみです。

ランタイムリソース

• docs/upgrade-guide.md — 汎用的なファイルシステムコマンドから ov skills への移行。
• examples/commands.md — シナリオ別の一般的なコマンドパターン。
• docs/source-types.md — 対応しているソース形式と URL パターンの詳細。