Skill: raunaksingwi/ravi-contacts (version 2.1.1)

--- name: ravi-contacts description: Manage contacts associated with your identity — list, search, create, update, and delete. Use ravi-contacts to resolve a person's name to their email or phone before sending (e.g. "email Alice" or "text Bob" → search contacts first). Do NOT use for website credentials (use ravi-passwords) or API keys (use ravi-secrets). --- # Ravi Contacts Manage contacts associated with your identity. Contacts store people you interact with — their email, phone, display name, and nickname. ## Commands ```bash # List all contacts ravi contacts list # Fuzzy search contacts by name or email (phone is not fuzzy-searched) ravi contacts search "alice" # Get a single contact ravi contacts get <uuid> # Create a contact ravi contacts create --email "[REDACTED_SECRET]" --display-name "Alice Smith" # Create with phone and nickname ravi contacts create --phone "+15551234567" --nickname "alice" # Create a full contact ravi contacts create --email "[REDACTED_SECRET]" --phone "+15559876543" --display-name "Bob Jones" --nickname "bob" # Update a contact ravi contacts update <uuid> --nickname "ally" # Delete a contact ravi contacts delete <uuid> ``` **Create/update fields:** `--email`, `--phone`, `--display-name`, `--nickname`, `--is-trusted` ## JSON Shapes **`ravi contacts list`:** ```json [ { "uuid": "...", "identity": 1, "email": "[REDACTED_SECRET]", "phone_number": "+15551234567", "display_name": "Alice Smith", "nickname": "alice", "is_trusted": false, "source": "auto", "interaction_count": 5, "last_interaction_dt": "2026-03-01T14:00:00Z", "created_dt": "2026-02-20T10:30:00Z", "updated_dt": "2026-02-28T09:15:00Z" } ] ``` **`ravi contacts get <uuid>`:** ```json { "uuid": "...", "email": "[REDACTED_SECRET]", "phone_number": "+15551234567", "display_name": "Alice Smith", "nickname": "alice", "is_trusted": false, "source": "auto", "interaction_count": 5, "last_interaction_dt": "2026-03-01T14:00:00Z", "created_dt": "2026-02-20T10:30:00Z", "updated_dt": "2026-02-28T09:15:00Z" } ``` ## Resolving Recipients When the user asks to email or text someone by name (e.g. "email Alice" or "text Bob"), **always search contacts first** to resolve their name to an email address or phone number: ```bash # Step 1: Search by name ravi contacts search "Alice" # Step 2: If one match → use the email/phone from the result # Step 3: If multiple matches → confirm with the user which one they mean # Step 4: If no matches → ask the user for the email/phone directly ``` This is the primary integration point with **ravi-email-send** and SMS workflows. ## Key Concepts - **Auto-contacts** — Ravi automatically creates contacts from email and SMS interactions. When you send or receive a message, a contact is created or updated for the other party. - **Manual contacts** — You can also create contacts manually via the CLI. - **Trusted contacts** — Contacts marked with `--is-trusted` are classified as trusted senders. Emails from trusted contacts are routed to the `email_trusted` SSE channel, distinct from `email_owner` (your own emails) and `email_untrusted` (unknown senders). By default, contacts are not trusted. - **`interaction_count`** — Tracks how many email/SMS interactions you have had with this contact. Auto-incremented by the system. - **`last_interaction_dt`** — Timestamp of the most recent email or SMS interaction with this contact. Updated automatically. ## Important Notes - **Contacts are stored in plaintext** — do not store sensitive information in contact fields. Use **ravi-passwords** for credentials and **ravi-secrets** for API keys. - **Auto-contacts from interactions** — sending or receiving email/SMS automatically creates or updates contacts. You do not need to manually create contacts for people you interact with. - **Phone numbers in E.164 format** — always include the country code (e.g., `+15551234567`). ## Full API Reference For complete endpoint details, request/response schemas, and parameters: [Contacts](https://ravi.id/docs/schema/contacts.json) ## Related Skills - **ravi-identity** — Get your own email address and phone number - **ravi-passwords** — Store website credentials (not contact info) - **ravi-secrets** — Store API keys and env vars (not contact info) - **ravi-inbox** — Read incoming email and SMS messages - **ravi-email-send** — Send emails to your contacts


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)