Magic Link SSO Skills

Agent-agnostic skills.sh skills for setting up, implementing, comparing, and troubleshooting Magic Link SSO across supported deployment shapes and web stacks, including the optional email one-time-code (OTP) alternative to the magic link.

This repository is structured for the open Agent Skills ecosystem, so the same skill pack can be installed for Codex, Claude, Gemini, and other agents that support standard SKILL.md-based skills through skills.

Install

Install the whole repository:

npx skills add magic-link-sso/skills

Install a specific skill:

npx skills add magic-link-sso/skills --skill implement-magic-link-sso

List available skills without installing:

npx skills add magic-link-sso/skills --list

Included Skills

implement-magic-link-sso

Routes an agent to the right Magic Link SSO integration path for:

• Next.js App Router
• Nuxt SSR
• Angular SSR
• Fastify
• Django
• Magic Link SSO Gate for static, CSR-only, unknown, or unsupported stacks

It acts as a dispatcher skill: detect the framework, open the matching bundled reference, apply the shared checklist, and avoid re-deriving the integration from scratch. The references cover both magic-link callbacks and the optional email OTP exchange.

setup-magic-link-sso

Guides self-hosting setup and operator decisions for:

• the Magic Link SSO server in classic mode
• Magic Link SSO Gate in front of private upstreams
• the optional manager in managed mode
• local evaluation versus production-like deployment shapes
• opt-in email OTP configuration and local OTP evaluation commands

It acts as a setup dispatcher skill: choose the right infrastructure path, read only the relevant setup references, validate the deployment shape, and hand off framework-specific app wiring to implement-magic-link-sso.

Repo Layout

This repo follows the layout that skills discovers by default:

skills/
  implement-magic-link-sso/
    SKILL.md
    references/
    agents/
  setup-magic-link-sso/
    SKILL.md
    references/

Core compatibility comes from skills/<skill-name>/SKILL.md with YAML frontmatter. Extra files such as bundled references or agent-specific metadata can live alongside the skill without breaking discovery.

About Magic Link SSO

The underlying product, server, and framework integrations live in the main magic-link-sso/magic-sso repository.