Skip to main content

culvii skill install

Install the Culvii authoring skill bundle for AI agents.

Synopsis​

culvii skill install [--agent <agent>] [--global] [--force]

Description​

Installs the Culvii authoring skill bundle for supported AI agents. This command runs locally and does not require authentication or an internet connection (the bundle is embedded in the CLI).

When --agent is omitted, it auto-detects .claude, .cursor, .windsurf, .github, .opencode, .gemini, and .kiro directories in the current project, installs into every detected agent directory, and always installs the portable/Codex bundle to .agents/skills/culvii. If none of those agent directories are detected, it defaults to installing for Claude Code (.claude/skills/culvii) and .agents/skills/culvii.

To update an installed skill bundle after a new CLI release, upgrade @culvii/cli (npm install -g @culvii/cli@latest) and re-run culvii skill install (or culvii skill install --global). The installer replaces older managed bundles completely (including removing obsolete files) and refuses to overwrite unmanaged directories unless --force is supplied.

The command compares the manifest hash to determine if the skill is installed, updated, or unchanged. If a newer version is available in the CLI, it will be updated automatically.

Target directories​

AgentProject PathGlobal Path
claude.claude/skills/culvii~/.claude/skills/culvii
cursor.cursor/skills/culvii~/.cursor/skills/culvii
windsurf.windsurf/skills/culvii~/.codeium/windsurf/skills/culvii
github.github/skills/culvii~/.copilot/skills/culvii
opencode.opencode/skills/culvii~/.config/opencode/skills/culvii
gemini.gemini/skills/culvii~/.gemini/skills/culvii
kiro.kiro/skills/culvii~/.kiro/skills/culvii
agents / codex.agents/skills/culvii~/.agents/skills/culvii

Flags​

FlagRequiredDescription
--agent-Specify agent: claude, cursor, windsurf, github, opencode, gemini, kiro, codex (alias for agents), or agents.
--global-Install globally instead of in the current project.
--force-Replace an existing unmanaged Culvii skill directory.

Examples​

# Auto-detect and install
culvii skill install

# Install globally for a specific agent
culvii skill install --agent cursor --global

Error behaviour​

ConditionMessageExit
Invalid agent"Invalid agent: <value>. Must be one of: ..."1
Unmanaged directory"Refusing to replace unmanaged skill directory: <path>. Re-run with --force."1