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 addmay download and install external code; verify the source when the user provides an untrusted URL.ov skills remove --allis destructive; confirm with the user before executing.ov skills updatereplaces 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,listshould include the new skill. - After
remove,listshould no longer include the removed skill. - After
update,show <name> --sourceshould reflect fresh content.
Boundaries
- Do not invent skill names or URLs. Use what the user provides.
- Do not execute
ov skills remove --allwithout explicit user confirmation. - Do not treat
ov add-skill(legacy resource command) as equivalent toov skills add.
Runtime Resources
docs/upgrade-guide.md— migrating from legacyov 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.

