auth
Setup authentication flow (register, login, session/JWT, middleware)
SKILL.mdskills/core/auth/SKILL.md
GitHubContext
Project {{project_name}} uses {{stack}}. Setup authentication with strategy: {{input.strategy}}.
Read AGENTS.md for security conventions.
Instructions
Analyze existing auth setup
- Check if auth middleware / auth routes already exist
- Check already installed dependencies (bcrypt, jsonwebtoken, passport, next-auth, etc.)
- Identify existing user model/schema
Setup dependencies Adjust based on strategy:
- JWT: bcrypt/argon2, jsonwebtoken/jose
- Session: express-session, connect-redis (optional)
- OAuth: next-auth / passport + passport-google-oauth20, etc.
Create/update user model
- Fields: id, email, password_hash, name, created_at, updated_at
- If OAuth: add provider, provider_id fields
- Migration if needed (use migration skill)
Create auth service
- Register: validate input, hash password, create user, return token
- Login: find user, verify password, return token
- Verify: validate token, return user
- Refresh: refresh expired token (if JWT)
Create auth routes
- POST /api/auth/register
- POST /api/auth/login
- POST /api/auth/logout
- GET /api/auth/me (current user)
- POST /api/auth/refresh (if JWT)
Create auth middleware
- Extract token from header/cookie
- Verify token
- Attach user to request
- Return 401 if invalid
Create tests
- Register: success, duplicate email, weak password
- Login: success, wrong password, user not found
- Protected route: with token, without token, expired token
- Middleware: valid token, invalid token, no token
Script
#!/bin/bash
# Install auth dependencies based on strategy
STRATEGY="{{input.strategy}}"
if [ "$STRATEGY" = "jwt" ]; then
echo "Dependencies needed: bcryptjs jsonwebtoken"
elif [ "$STRATEGY" = "session" ]; then
echo "Dependencies needed: bcryptjs express-session"
elif [ "$STRATEGY" = "oauth" ]; then
echo "Dependencies needed: next-auth (or passport)"
fi
Validation
- User model/schema created with proper fields
- Password hashing works (not stored as plaintext)
- Register endpoint works (happy path + errors)
- Login endpoint works (happy path + errors)
- Auth middleware protects routes correctly
- Token validation works
- Tests passing (minimum 8 test cases)
- No security vulnerabilities (no secret in code, proper CORS, etc)
- Typecheck passing