Descope Skills

A collection of AI agent skills for integrating Descope authentication into your applications. Skills follow the Agent Skills format and work with any compatible AI coding assistant.

Available Skills

descope-auth — Integrate Descope authentication into applications

Integrate Descope authentication into applications with support for passwordless auth, OAuth, SSO, and MFA. Uses a smart router pattern to detect your framework and provide targeted integration guidance.

Use when:

• "Add authentication to my app"
• "Implement login with Descope"
• "Set up passwordless auth"
• "Add OAuth/SSO to my application"
• "Integrate passkeys"

Frameworks supported:

• Next.js (App Router with middleware)
• React (SPA with protected routes)
• Node.js (backend session validation)
• Python (backend session validation)

Features:

• Framework detection - Automatically routes to appropriate integration guide
• Security guardrails - Prevents common authentication mistakes
• Skills.sh compliant - Follows official specification
• Copy-paste ready - All code examples use correct SDK imports

Authentication methods covered:

• OTP (Email/SMS) - Quick verification codes
• Magic Link - Passwordless email links
• Passkeys - Biometric/WebAuthn (most secure)
• OAuth - Social login (Google, GitHub, etc.)
• SSO - Enterprise SAML/OIDC
• TOTP - Authenticator app MFA
• Passwords - Traditional auth (fallback)

descope-terraform — Manage Descope projects as infrastructure-as-code

Manage Descope projects as infrastructure-as-code using the official Terraform provider. Generates valid HCL configurations for authentication methods, RBAC, connectors, and project settings.

Use when:

• "Set up Terraform for my Descope project"
• "Manage Descope authentication config as code"
• "Create roles and permissions with Terraform"
• "Add connectors to my Descope Terraform config"
• "Deploy Descope project settings across environments"

Resources managed:

• descope_project - Full project configuration (auth methods, RBAC, connectors, flows, settings)
• descope_management_key - Management keys with RBAC scoping
• descope_descoper - Console user accounts with role assignments

Covers:

• Provider setup and management key configuration
• Authentication methods (OTP, Magic Link, Passkeys, OAuth, SSO, Password, TOTP)
• Authorization (roles and permissions)
• 60+ connector types (email, SMS, HTTP, observability, fraud detection, CRM, etc.)
• Project settings, applications (OIDC/SAML), flows, JWT templates, and custom attributes

Requirements:

• Terraform CLI installed
• Paid Descope License (Pro +)
• Management Key from Company Settings

Installation

Using skills CLI

npx skills add descope/skills

Using Claude Code

Add the marketplace and install the plugin:

/plugin marketplace add descope/skills
/plugin install descope-skills

Usage

Skills are automatically loaded by compatible AI agents once installed. Simply describe what you need:

descope-auth examples

Add Descope authentication to my Next.js app

Help me implement passkey login with Descope

Set up backend session validation for my Node.js API

Add OAuth login (Google and GitHub) using Descope

descope-terraform examples

Set up Terraform to manage my Descope project

Create a Descope project with password auth and RBAC using Terraform

Add an HTTP connector and S3 audit logging to my Descope Terraform config

Compatible Agents

Works with any agent supporting the Agent Skills format:

• Claude Code (Anthropic)
• OpenCode (OhMyOpenCode)
• Cursor
• Cline
• GitHub Copilot
• Windsurf
• And 36+ more agents

Skill Structure

skills/
├── descope-auth/
│   ├── SKILL.md - Main instructions with framework detection
│   └── references/
│       ├── nextjs.md - Next.js App Router patterns
│       ├── react.md - React SPA patterns
│       └── backend.md - Node.js/Python validation
└── descope-terraform/
    ├── SKILL.md - Provider setup, common configurations, and guardrails
    └── references/
        ├── project-resource.md - Full descope_project schema
        ├── other-resources.md - descope_management_key and descope_descoper schemas
        └── connectors.md - All 60+ supported connector types

Getting Started with Descope

1. Create a free account on our Sign Up page
2. Get your Project ID from Settings → Project
3. Install the skills via npx skills add descope/skills or the /plugin command in Claude Code
4. Ask your AI agent to integrate Descope authentication or set up Terraform

Documentation

• Descope Documentation
• Descope Flows Guide
• Authentication Methods
• API Reference
• Terraform Provider
• Managing Environments with Terraform

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE file for details.

About Descope

Descope provides passwordless authentication and user management for developers. Build secure, frictionless authentication flows with our no-code Flow Builder and developer-friendly SDKs.

Support

• Descope Community Slack
• GitHub Discussions
• Email Support

---

Made with 💜 by Descope