Installation

npx skills add cloudvoyant/codevoyant

Works with Claude Code, OpenCode, VS Code Copilot, and any other agent that supports the Agent Skills format.

Compatibility

Skills are designed to work across agents. Where platform-specific features aren't available, they degrade gracefully:

• Subagents (Task tool) — used for background execution and parallel work. Falls back to sequential inline execution on agents that don't support spawning subagents.
• AskUserQuestion — interactive prompts fall back to numbered lists.
• context: fork — Claude Code-specific agent forking; ignored on other platforms, skill runs inline.

Command arguments (OpenCode vs Claude Code)

Both Claude Code and OpenCode register skills as slash commands and pass the text after the command into the skill body. Claude Code substitutes $ARGUMENTS/$N natively; OpenCode runs the SKILL.md body through its command template pipeline too — $ARGUMENTS becomes the raw remainder, $N becomes positional tokens (with the highest-numbered $N in the body consuming all remaining tokens), and a body with no substitution tokens gets the raw remainder appended as a trailing paragraph. So /spec new my-feature reaches the spec dispatcher as new my-feature on both. When OpenCode's model loads a skill via the skill tool instead (by name), no arguments are passed — the model reads them from your message. Dispatcher skills follow the cross-agent contract in skills/shared/arg-handling.md: they parse the invocation from the request text and, when no verb is parseable, ask the user what they want instead of silently running help. This substitution behavior is verified against the opencode version in use and can vary by version.

Updating

Re-run the install command to get the latest version:

npx skills add cloudvoyant/codevoyant

To pin a specific version:

npx skills add cloudvoyant/codevoyant@v1.31.0

Local development

npx skills add /path/to/codevoyant

Permissions

Skills load reference files (recipes, workflow guides) at runtime. To avoid being prompted on every read, add the skills directory to your allowed paths.

User-wide (~/.claude/settings.json):

{
  "permissions": {
    "allow": ["Read(~/.claude/skills/**)"]
  }
}

Project-only (.claude/settings.json in your project root) — same format.

Troubleshooting

If commands aren't showing up or updates aren't applying, reinstall:

npx skills add cloudvoyant/codevoyant

For anything else: open an issue.