Agent Skills
Overview
Ravi provides skill files that teach AI agents how to use the Ravi CLI. Skills are structured documents that describe available commands, JSON output shapes, and common workflows. They work with any agent platform that supports skill files.
Prerequisites
Install the Ravi CLI first — skills teach agents how to use it but don’t include the CLI itself.
brew install ravi-hq/tap/ravi
ravi auth login
Install
Any agent (skills.sh)
# All skills
npx skills add ravi-hq/ravi-skills
# Individual skill
npx skills add ravi-hq/ravi-skills --skill ravi-identity
Claude Code
/plugin marketplace add ravi-hq/ravi-skills
/plugin install ravi
OpenClaw (ClawdHub)
for s in ravi ravi-identity ravi-inbox ravi-email-send ravi-login ravi-passwords ravi-vault ravi-feedback; do
clawdhub install "$s"
done
Available skills
| Skill | Description | Key commands |
|---|---|---|
| ravi | Overview — what Ravi is and when to use each skill | — |
| ravi-identity | Check auth, get Identity details, switch Identities | ravi auth status --json |
| ravi-inbox | Read SMS and email — OTPs, verification links | ravi inbox sms --unread --json |
| ravi-email-send | Compose, reply, reply-all with HTML and attachments | ravi email compose --to "..." --subject "..." --body "..." --json |
| ravi-login | Signup/login workflows with 2FA and credential storage | ravi passwords create example.com --json |
| ravi-passwords | Website credentials (domain + username + password) | ravi passwords get <uuid> --json |
| ravi-vault | Key-value secrets (API keys, env vars) | ravi secrets set KEY "value" --json |
| ravi-feedback | Send feedback, bugs, or feature requests | ravi feedback "message" --json |
How skills work
Each skill file is a Markdown document with:
- Frontmatter — skill name and description
- Commands — available CLI commands with flags and examples
- JSON shapes — expected output structure for each command
- Workflows — step-by-step recipes for common tasks
- Rules — conventions like always using
--json
When an agent platform loads a skill, the agent learns how to use the described tools without needing explicit tool definitions.
Skill selection guide
| I need to… | Use skill |
|---|---|
| Check auth or get email/phone | ravi-identity |
| Read incoming SMS or email | ravi-inbox |
| Send an email, reply, or forward | ravi-email-send |
| Sign up for a service or complete 2FA | ravi-login |
| Store or retrieve website passwords | ravi-passwords |
| Store or retrieve API keys | ravi-vault |
| Send feedback or report bugs | ravi-feedback |
Next steps
- Claude Code — Claude Code plugin setup
- OpenClaw — OpenClaw plugin with real-time channels