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.

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.