OpenViking (OV) Skills Management
The ov skills command group manages agent skills on OpenViking — including installation from local directories, Git repositories, GitHub URLs, or raw content; listing, searching, inspecting, updating, and removing skills; and validating skill format locally.
Goal
Guide an agent to correctly invoke ov skills subcommands for skill lifecycle operations without guessing flags, source types, or update semantics.
Load When
- User explicitly requests skill management:
ov skills ..., install skill, update skill, delete skill, remove skill.
- User asks to validate a SKILL.md or skill directory.
- User asks to find or search installed skills.
- User asks to inspect a skill's content, files, or source.
- Agent needs to discover available skills before selecting one.
Inputs
| Name |
Required |
Description |
subcommand |
yes |
One of list, find, add, show, update, remove, validate |
target |
conditional |
Skill name, query string, source path/URL, or directory path |
level |
no |
Content level for show/find: 0 (abstract), 1 (overview), 2 (full) |
Workflow
- Identify the user's intent and map to the correct
ov skills <subcommand>.
- Determine the source type for
add (local dir, local file, Git URL, GitHub tree URL, raw content).
- Construct the command with appropriate flags.
- Execute and report results.
Permissions
ov skills add may download and install external code; verify the source when the user provides an untrusted URL.ov skills remove --all is destructive; confirm with the user before executing.ov skills update replaces skill content in-place; the old version is not retained.
Output
- CLI output returned directly to the user.
- Errors surfaced with suggested fixes.
Verification
- After
add, list should include the new skill.
- After
remove, list should no longer include the removed skill.
- After
update, show <name> --source should reflect fresh content.
Boundaries
- Do not invent skill names or URLs. Use what the user provides.
- Do not execute
ov skills remove --all without explicit user confirmation.
- Do not treat
ov add-skill (legacy resource command) as equivalent to ov skills add.
Runtime Resources
docs/upgrade-guide.md — migrating from legacy ov add-skill / resource commands.examples/commands.md — common command patterns by scenario.docs/source-types.md — deep dive on supported source formats and URL patterns.
1---
2name: ov-skills
3description: Load when an agent needs to manage, install, update, remove, or validate OpenViking skills via the `ov skills` CLI. Trigger on explicit user requests about skill management, when the user mentions `ov skills`, `install skill`, `update skill`, `delete skill`, `validate skill`, or when an agent needs to discover what skills are available on the OpenViking server.
4compatibility: OpenViking CLI configured at `~/.openviking/ovcli.conf`
5version: 1.0.0
6last_updated: 2026-06-08
7---
8
9# OpenViking (OV) Skills Management
10
11The `ov skills` command group manages agent skills on OpenViking — including installation from local directories, Git repositories, GitHub URLs, or raw content; listing, searching, inspecting, updating, and removing skills; and validating skill format locally.
12
13## Goal
14
15Guide an agent to correctly invoke `ov skills` subcommands for skill lifecycle operations without guessing flags, source types, or update semantics.
16
17## Load When
18
19- User explicitly requests skill management: `ov skills ...`, `install skill`, `update skill`, `delete skill`, `remove skill`.
20- User asks to validate a SKILL.md or skill directory.
21- User asks to find or search installed skills.
22- User asks to inspect a skill's content, files, or source.
23- Agent needs to discover available skills before selecting one.
24
25## Inputs
26
27| Name | Required | Description |
28|---|---|---|
29| `subcommand` | yes | One of `list`, `find`, `add`, `show`, `update`, `remove`, `validate` |
30| `target` | conditional | Skill name, query string, source path/URL, or directory path |
31| `level` | no | Content level for `show`/`find`: `0` (abstract), `1` (overview), `2` (full) |
32
33## Workflow
34
351. Identify the user's intent and map to the correct `ov skills <subcommand>`.
362. Determine the source type for `add` (local dir, local file, Git URL, GitHub tree URL, raw content).
373. Construct the command with appropriate flags.
384. Execute and report results.
39
40## Permissions
41
42- `ov skills add` may download and install external code; verify the source when the user provides an untrusted URL.
43- `ov skills remove --all` is destructive; confirm with the user before executing.
44- `ov skills update` replaces skill content in-place; the old version is not retained.
45
46## Output
47
48- CLI output returned directly to the user.
49- Errors surfaced with suggested fixes.
50
51## Verification
52
53- After `add`, `list` should include the new skill.
54- After `remove`, `list` should no longer include the removed skill.
55- After `update`, `show <name> --source` should reflect fresh content.
56
57## Boundaries
58
59- Do not invent skill names or URLs. Use what the user provides.
60- Do not execute `ov skills remove --all` without explicit user confirmation.
61- Do not treat `ov add-skill` (legacy resource command) as equivalent to `ov skills add`.
62
63## Runtime Resources
64
65- `docs/upgrade-guide.md` — migrating from legacy `ov add-skill` / resource commands.
66- `examples/commands.md` — common command patterns by scenario.
67- `docs/source-types.md` — deep dive on supported source formats and URL patterns.
volcengine