otp-auth

Implement passwordless email-OTP authentication with MongoDB session storage.

Updated May 13, 2026
One-click install
npx skills add https://github.com/dloschiavo/orca --skill otp-auth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: otp-auth
Source: https://github.com/dloschiavo/orca/tree/main/recipe/otp-auth
Command: npx skills add https://github.com/dloschiavo/orca --skill otp-auth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a secure and efficient way to implement passwordless email-OTP authentication, eliminating the need for traditional passwords and OAuth, while ensuring strong user verification and session management.

Core Features & Use Cases

  • Passwordless Authentication: Offers a secure, passwordless login process using email and OTP.
  • Data Model: Defines a comprehensive data model for sessions and users, with indexes and lifetimes optimized for performance and security.
  • Auth Helpers: Provides a suite of authentication helpers for session management, permission checks, and error handling.
  • Dev Bypass: Includes a development bypass for admin access without OTP on localhost.
  • API Routes: Offers a detailed API for request-OTP and verify-OTP, with security measures like rate limiting and bot protection.
  • Bootstrap Superadmin Seed: Ensures a superadmin account is created on first DB connect for system setup.

Quick Start

Use the otp-auth skill to request an OTP for email verification and then verify the OTP to log in.

Frequently Asked Questions about otp-auth

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

FAQPage Schema
How do I implement passwordless email-OTP authentication for my application?

Passwordless email-OTP authentication allows users to log in via a one-time password sent to their email, eliminating traditional passwords. This Skill provides the necessary API routes, data models, and session management logic to execute the request-OTP and verify-OTP workflow securely.

What is passwordless authentication and how does OTP verification work?

Passwordless authentication verifies identity without storing user passwords by sending a one-time password (OTP) to an email address. The user enters the OTP to confirm ownership of the email, granting them a secure authenticated session managed by the backend.

Do I need MongoDB to use email-OTP session management?

Yes, MongoDB is required for email-OTP session management. The Skill uses MongoDB to store session and user data, defining indexes and lifetimes optimized for secure authentication performance and identity verification.

Does passwordless email-OTP authentication include rate limiting and bot protection?

Yes, passwordless email-OTP authentication includes rate limiting and bot protection. The provided API routes for requesting and verifying OTPs are equipped with security measures designed to prevent automated attacks and secure session control.

Can I bypass email-OTP authentication during local development?

Yes, you can bypass email-OTP authentication on localhost using the included development bypass feature. This allows admin access without requiring OTP verification during local testing and development.

Why use email-OTP authentication instead of traditional passwords or OAuth?

Email-OTP authentication eliminates the security vulnerabilities of traditional passwords and the third-party dependencies of OAuth. It provides strong user verification and simplified session management by securely sending one-time passwords directly to the user's email.