ravnhq AI Skills Manager (corvus)
Manage Ravn AI Toolkit skills using the corvus CLI. Install, update, remove, and configure skills for any project without needing Bash knowledge.
Prerequisites
Check if corvus is installed:
corvus --version
If not installed, run the bootstrap installer:
curl -fsSL https://raw.githubusercontent.com/ravnhq/ai-toolkit/main/install.sh | bash
After installation, restart the shell or source ~/.zshrc.
Workflow
1. Browse Available Skills
List all skills grouped by category:
corvus list
Search by keyword:
corvus search <keyword>
Preview a specific skill's details, rules, and dependencies:
corvus info <skill-name>
2. Install Skills
Interactive mode (recommended for first-time users) — launches a picker UI:
corvus
Direct install to the current project:
corvus install <skill-name> [<skill-name> ...]
Target flags — install Agent Skills under each product’s skills/ directory (Claude Code, Cursor), or under rules/ where that product only supports rules (OpenCode, Codex):
| Flag | Target |
|---|---|
--claude |
.claude/skills (project — Claude Code Agent Skills) |
--cursor |
.cursor/skills (project — Cursor Agent Skills) |
--opencode |
.opencode/rules (project) |
--codex |
.codex/rules (project) |
--global-claude |
~/.claude/skills (global) |
--global-cursor |
~/.cursor/skills (global) |
--global-opencode |
~/.config/opencode/rules (global) |
--global-codex |
~/.codex/rules (global) |
corvus install --claude tech-react
corvus install --codex lang-typescript
corvus install --global-claude core-coding-standards
Recipe install — predefined skill sets for common stacks:
corvus install --recipe fullstack-ts
corvus install --recipe ios-swift
corvus install --recipe backend-api
Dependencies are resolved automatically. Use --no-deps to skip.
3. Update Skills
Pull latest toolkit and update all installed skills:
corvus update
corvus auto-checks for updates every 7 days and prompts when new versions are available.
4. Manage Installed Skills
Check installed versions vs latest:
corvus status
Remove a skill:
corvus remove <skill-name>
corvus remove --global <skill-name>
5. Team Collaboration
The .corvusrc file in the project root tracks installed skills and can be committed to git. Teammates can sync all project skills with:
corvus sync
6. Health Check
Run diagnostics to verify installation, dependencies, and configuration:
corvus doctor
7. Shell Completions
Print setup instructions for your shell:
corvus completions # auto-detect shell
corvus completions --shell zsh
corvus completions --shell bash
corvus completions --shell fish
Follow the printed instructions to add completions to your shell config. For fish, the output will guide you to create a completions file at ~/.config/fish/completions/corvus.fish.
Configuration
Global Config (~/.corvus/config)
| Key | Default | Description |
|---|---|---|
update_check |
7 | Days between auto-update checks (0 = disabled) |
auto_deps |
true | Automatically install dependency skills |
global_skills |
(empty) | Comma-separated list of global skills with versions |
Project Config (.corvusrc)
| Key | Description |
|---|---|
install_dir |
Where skills are copied (e.g., .claude/skills, .cursor/skills) |
skills |
Comma-separated list of installed skills with versions |
Skill Scoping
Global skills apply to every project. Set personal defaults:
corvus install --global core-coding-standards lang-typescript
Project skills are project-specific additions. Stored in .corvusrc:
corvus install tech-react tech-drizzle
Both layers merge at runtime. Project versions take priority on conflicts.
Available Recipes
| Recipe | Skills |
|---|---|
fullstack-ts |
lang-typescript, tech-react, tech-trpc, tech-drizzle, tech-vitest, design-frontend |
ios-swift |
swift-concurrency, liquid-glass-ios |
backend-api |
lang-typescript, tech-trpc, tech-drizzle, platform-testing |
Maintaining corvus
Use this section when making changes to the corvus CLI itself (TypeScript source in cli-ts/).
Version Locations
Both must be kept in sync on every release:
| File | Field |
|---|---|
cli-ts/src/core/paths.ts |
CORVUS_VERSION constant |
cli-ts/package.json |
"version" field |
Workflow for Every corvus Change
- Make the code changes in
cli-ts/src/. - Run tests:
cd cli-ts && npm test - Read the current version from
cli-ts/src/core/paths.ts, propose the next version to the user (increment build number), and wait for approval:"Current version is
0.1.0. Proposed next version:0.1.1. Approve?" - Update
CORVUS_VERSIONinpaths.tsand"version"inpackage.jsonatomically. - Bump the skill version:
ruby scripts/skill_version.rb skills/assistant/agent-skills-manager/SKILL.md build - Commit, push to fork, update PR.
Examples
Positive Trigger
User: "Install AI skills for my React + tRPC + Drizzle project"
Expected behavior: Run corvus install --recipe fullstack-ts in the project directory. This installs all 6 skills with their dependencies resolved automatically.
Non-Trigger
User: "Fix the TypeScript error in my API handler"
Expected behavior: Do not use this skill. Choose a more relevant skill like lang-typescript or tech-trpc.
Troubleshooting
corvus Command Not Found
- Error:
corvus: command not foundafter installation. - Cause:
~/.local/binis not in PATH, or shell was not restarted. - Solution: Run
source ~/.zshrc(or~/.bashrc) or restart the terminal. If still missing, addexport PATH="$HOME/.local/bin:$PATH"to your shell config.
Skills Not Installing
- Error:
Registry not foundwhen running install. - Cause: The local toolkit cache is missing or corrupted.
- Solution: Run
corvus updateto re-pull the repository cache at~/.corvus/repo/.
Outdated Skills After Update
- Error:
corvus statusshows skills behind latest butupdatereports all up to date. - Cause: The
.corvusrcversion numbers may be stale. - Solution: Run
corvus remove <skill>thencorvus install <skill>to force a fresh install.