ravi-identity

Retrieve and manage agent identities with email addresses and phone numbers via the Ravi CLI.

1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/ravi-hq/ravi-skills --skill ravi-identity-ravi-hq
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ravi-identity
Source: https://github.com/ravi-hq/ravi-skills/tree/main/skills/ravi-identity
Command: npx skills add https://github.com/ravi-hq/ravi-skills --skill ravi-identity-ravi-hq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents acting on the web need their own identity — an email address for signups, a phone number for SMS verification, and a name for forms — but they have no built-in way to obtain or manage one. This Skill gives an agent access to its Ravi identity so it can register for services and receive verification codes as itself. ## Core Features & Use Cases - Identity lookup: Check auth status and retrieve the current identity's email address, phone number, and owner info with simple CLI commands like ravi get email and ravi get phone. - Identity creation: Create new identities with auto-generated realistic names and matching email addresses, optionally provisioning a phone number in the same call with --provision-phone. - Identity listing: List all identities with their UUIDs, names, inboxes, and phone numbers in structured JSON. - Use Case: An agent needs to sign up for a SaaS tool. It runs ravi get email to get its own address, uses the identity name on the signup form, and later reads the verification code via the companion inbox skill. ## Quick Start Ask the agent to check its Ravi auth status and show its email address and phone number so it can sign up for a service.

Frequently Asked Questions about ravi-identity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get an email address and phone number for an AI agent?▼

Use the Ravi CLI: run `ravi get email` for the agent's email address and `ravi get phone` for its phone number after authenticating with `ravi auth login`. Each identity includes its own inbox and optionally a real phone number for SMS verification.

How do I create a new identity for an AI agent?▼

Run `ravi identity create` to generate an identity with a realistic auto-generated name and matching email address. Add `--provision-phone` to also provision a phone number in the same call, which requires an active paid plan.

Can multiple agents share one Ravi CLI config on the same machine?▼

No. The Ravi CLI binds to one identity per machine via `~/.ravi/config.json`, and you should not use `ravi identity use` or `--identity` to multiplex agents. Additional agents on the same host must use the HTTP API with per-identity `ravi_id_` keys.

Why does phone provisioning fail with a 402 error?▼

Phone provisioning returns HTTP 402 Payment Required when the account lacks an active paid plan. Tell the user to upgrade their plan, then retry `ravi identity create --provision-phone` or call the provision-phone API endpoint for an existing identity.

When should I not use the ravi-identity skill?▼

Do not use it for reading SMS or email messages (use ravi-inbox), sending email (use ravi-email-send), or managing credentials and secrets (use ravi-passwords or ravi-secrets). It only covers identity lookup, listing, and creation.