AI Skill (Claude Code)

vuer-auth ships a Claude Code skill so an AI assistant can wire your app, CLI, or backend up to vuer-auth for you — generating the login flow, the token verification, and the client setup, all grounded in the real endpoints.

What is a skill? A Claude Code skill is packaged know-how the assistant loads on demand. The vuer-auth skill teaches it how to grant login and verify tokens against vuer-auth.


What it can do for you

Once installed, you can ask Claude things like:

  • "Add Sign in with Vuer to this React app."
  • "Verify a vuer-auth JWT in my Express/Fastify backend."
  • "Get me a token from staging so I can test."
  • "Register a new app called my-app with vuer-auth."

The skill knows the correct endpoints, the EdDSA/JWKS verification, the /.well-known/jwks.json path, the login flows (browser, CLI, device), and ships ready-to-run helper scripts.


Install

The skill is distributed as a Claude Code plugin from the vuer-auth marketplace. In Claude Code, run:

/plugin marketplace add vuer-ai/vuer-auth
/plugin install vuer-auth@vuer-auth

That's it. The skill is now available in all your projects as vuer-auth:vuer-auth, and Claude activates it automatically when a task involves vuer-auth login or token verification.

Note: Plugins work in the Claude Code CLI, the desktop app, and the IDE extensions (VS Code / JetBrains).


What's included

ItemPurpose
SKILL.mdThe decision guide: which login flow to use, endpoints, token shape.
references/login-browser.mdReact SPA login via @vuer-ai/vuer-auth-client.
references/login-cli.mdCLI / local-server callback flow.
references/login-device.mdHeadless device flow (RFC 8628).
references/verify-token.mdServer-side EdDSA / JWKS verification.
scripts/signin.mjsZero-dependency CLI login → writes .vuer_token.
scripts/verify-token.mjsVerify a token against the JWKS and print its claims.

Try the bundled scripts

After installing, the helper scripts can be run directly (Node ≥ 18):

# Sign in and save a token (defaults to staging)
node ${CLAUDE_PLUGIN_ROOT}/skills/vuer-auth/scripts/signin.mjs

# Verify it and print the claims
node ${CLAUDE_PLUGIN_ROOT}/skills/vuer-auth/scripts/verify-token.mjs --token "$(cat .vuer_token)"

Add --server https://auth.vuer.ai to either script to target production.


See Also