auth-flow-design

Select OAuth 2.x/OIDC authentication flows by client type and constraints.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/vTRKA/supervibe --skill auth-flow-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: auth-flow-design
Source: https://github.com/vTRKA/supervibe/tree/main/skills/auth-flow-design
Command: npx skills add https://github.com/vTRKA/supervibe --skill auth-flow-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents insecure or incompatible authentication implementations by forcing a deliberate OAuth 2.1 / OIDC flow choice before writing auth code.

Core Features & Use Cases

  • Auth-flow selection: Picks the correct OAuth/OIDC flow by client type (authorization-code + PKCE, client-credentials, or device authorization) and rejects risky mismatches like ROPC and token storage in localStorage.
  • Refresh, storage, and logout design: Defines refresh-token rotation, cookie vs token storage boundaries, and logout coordination across SPA/mobile/API/IdP.
  • Evidence-first output: Produces a concrete design handoff (and blocks when required evidence/capability/approvals are missing) with confidence scoring.

Quick Start

Tell the AI tool which app and clients you are building, then ask it to design your authentication authorization flow with redirect URIs, PKCE, refresh rotation, storage, and logout steps.

Frequently Asked Questions about auth-flow-design

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

FAQPage Schema
How do I choose the right OAuth 2.x or OIDC authentication flow for my application?

Choosing the correct OAuth 2.x or OIDC authentication flow requires evaluating your client type and runtime constraints to select authorization-code with PKCE, client-credentials, or device authorization, while rejecting risky mismatches like ROPC.

What is the best way to handle refresh token rotation and storage for SPAs and mobile apps?

Handling refresh token rotation and storage involves defining secure boundaries between cookie and token storage, ensuring proper rotation, and coordinating logout across SPA, mobile, API, and IdP environments.

Can I use the authorization code flow with PKCE for my new SPA and API authentication design?

Yes, the authorization code flow with PKCE is the recommended approach for new SPA and API authentication design, preventing insecure token storage in localStorage by enforcing safer client-specific flow selection.

How does logout coordination work across SPA, mobile, API, and IdP sessions?

Logout coordination works by defining explicit logout steps that synchronize session termination across SPA, mobile, API, and IdP, ensuring tokens are invalidated and users are fully logged out from all client runtimes.

Why should I avoid the ROPC flow and token storage in localStorage for OAuth modernization?

Avoiding the ROPC flow and token storage in localStorage during OAuth modernization is necessary because they introduce severe security risks, prompting the selection of safer alternatives like authorization-code with PKCE and secure cookie boundaries.

What evidence is required to produce an authentication design handoff with confidence gating?

Producing an authentication design handoff with confidence gating requires reading relevant standards, inventorying existing grant and client configuration, and validating evidence to output a PASS, PARTIAL, or BLOCKED status.