Agent Skills › volcengine/OpenViking › ov-skills

ov-skills

GitHub

用于管理 OpenViking Agent Skills 的生命周期，包括安装、更新、删除、验证及查询技能。通过 CLI 命令引导用户完成技能源添加与格式校验，确保操作安全与规范。

examples/skills/ov-skills/SKILL.md volcengine/OpenViking

触发场景

用户请求安装、更新或删除技能用户提及 ov skills 相关命令需要验证或查找可用技能

安装

npx skills add volcengine/OpenViking --skill ov-skills -g -y

更多选项

非标准路径

npx skills add https://github.com/volcengine/OpenViking/tree/main/examples/skills/ov-skills -g -y

不安装直接使用

npx skills use volcengine/OpenViking@ov-skills

指定 Agent (Claude Code)

npx skills add volcengine/OpenViking --skill ov-skills -a claude-code -g -y

安装 repo 全部 skill

npx skills add volcengine/OpenViking --all -g -y

预览 repo 内 skill

npx skills add volcengine/OpenViking --list

SKILL.md

Frontmatter

{
    "name": "ov-skills",
    "version": "1.0.0",
    "description": "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.",
    "last_updated": 1780876800,
    "compatibility": "OpenViking CLI configured at `~\/.openviking\/ovcli.conf`"
}

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.