https://github.com/descope/skills
Official collection of Descope authentication skills for AI coding agents
https://github.com/descope/skills
ai-agents authentication descope oauth passwordless skills sso
Last synced: 2 months ago
JSON representation
Official collection of Descope authentication skills for AI coding agents
- Host: GitHub
- URL: https://github.com/descope/skills
- Owner: descope
- License: mit
- Created: 2026-02-01T06:58:35.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-17T17:17:24.000Z (3 months ago)
- Last Synced: 2026-03-18T06:54:37.020Z (3 months ago)
- Topics: ai-agents, authentication, descope, oauth, passwordless, skills, sso
- Size: 50.8 KB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Descope Skills
A collection of AI agent skills for integrating Descope authentication into your applications. Skills follow the [Agent Skills](https://agentskills.io/) 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](https://registry.terraform.io/providers/descope/descope/latest/docs). 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](https://app.descope.com/company)
## Installation
Using skills CLI
```bash
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](https://code.claude.com) (Anthropic)
- [OpenCode](https://opencode.ai) (OhMyOpenCode)
- [Cursor](https://cursor.com)
- [Cline](https://cline.bot)
- [GitHub Copilot](https://github.com/features/copilot)
- [Windsurf](https://windsurf.com)
- And [36+ more agents](https://github.com/vercel-labs/skills#supported-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](https://www.descope.com/sign-up)
2. **Get your Project ID** from [Settings → Project](https://app.descope.com/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](https://docs.descope.com)
- [Descope Flows Guide](https://docs.descope.com/flows)
- [Authentication Methods](https://docs.descope.com/auth-methods)
- [API Reference](https://docs.descope.com/api)
- [Terraform Provider](https://registry.terraform.io/providers/descope/descope/latest/docs)
- [Managing Environments with Terraform](https://docs.descope.com/managing-environments/terraform)
## Contributing
Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## License
MIT License - see [LICENSE](LICENSE) file for details.
## About Descope
[Descope](https://www.descope.com) 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](https://www.descope.com/community)
- [GitHub Discussions](https://github.com/descope/descope-js/discussions)
- [Email Support](mailto:support@descope.com)
---
Made with 💜 by [Descope](https://www.descope.com)