zhangmask/c_animecompanion/ov-skills

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

Workflow

1. Identify the user's intent and map to the correct ov skills <subcommand>.
2. Determine the source type for add (local dir, local file, Git URL, GitHub tree URL, raw content).
3. Construct the command with appropriate flags.
4. 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.