ravi-sso

Generates short-lived identity verification tokens for third-party services supporting Login with Ravi.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents acting on the web often need to prove their identity to third-party services. This Skill provides short-lived SSO tokens that let external services verify a Ravi identity without sharing credentials or passwords. ## Core Features & Use Cases - SSO Token Generation: Run ravi sso token to obtain a short-lived token (5-minute TTL) that proves your Ravi identity. - Third-Party Verification Flow: Pass the token to any service supporting "Login with Ravi"; their backend verifies it via the Ravi API and receives your identity name, email, and phone. - Use Case: An agent signing into a partner SaaS dashboard requests a fresh token, submits it in the service's login form, and the service confirms the agent's identity without any password exchange. ## Quick Start Ask the agent to get a Ravi SSO token and pass it to the third-party service that supports Login with Ravi.

Frequently Asked Questions about ravi-sso

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

FAQPage Schema
How do I get a Ravi SSO token for a third-party service?▼

Run `ravi sso token` with the Ravi CLI to receive a token and its expiration timestamp. Pass the token to the third-party service however it requires, such as in a request body, header, or query parameter.

How do third-party services verify a Ravi SSO token?▼

The third-party backend calls POST https://api.ravi.app/api/sso/verify/ with the token and receives the identity's UUID, name, email, phone, and owner details. This endpoint is for third-party backends only, not for the agent itself.

How long does a Ravi SSO token last?▼

Each token has a 5-minute TTL. Request a fresh token immediately before passing it to a service and never cache or reuse tokens across sessions.

Why does ravi sso token return a 402 error?▼

A 402 response means the identity is on the free plan, since SSO tokens require an active paid subscription. Upgrade the subscription associated with the Ravi identity to resolve it.

When should I use ravi-sso instead of ravi-login?▼

Use ravi-sso only to prove your identity to third-party services supporting Login with Ravi. Use ravi-login to authenticate the agent itself to Ravi, and ravi-secrets for credential storage.