auth-module-builder — скилл для Claude Code: логин, JWT, сессии
Скилл auth-module-builder для Claude Code описывает сборку модуля аутентификации: маршруты входа и регистрации, JWT, bcrypt, сессии в Redis и модель угроз. Задача — собрать логин с нуля.
MIT 263 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill auth-module-builder -a claude-codeЧто делает auth-module-builder
Скилл задаёт каркас модуля аутентификации: маршруты POST /login, /register, /logout, /refresh, /forgot-password и три middleware — authenticate, requireAuth, optionalAuth. Проверка токена берёт его из заголовка Authorization и подгружает пользователя по id из payload. Внутри шаблоны на TypeScript: access-токен на 15 минут, refresh на 7 дней, хеширование через bcrypt.
Сессии идут отдельным блоком: express-session поверх Redis-хранилища, куки httpOnly, sameSite: lax, флаг secure включается в продакшене. Рядом чеклист и модель угроз: перебор паролей, кража токена, CSRF, фиксация сессии, XSS — против каждого пункта названа мера.
Три секрета читаются из окружения: JWT_SECRET, JWT_REFRESH_SECRET, SESSION_SECRET. Без них подпись токенов и сессии работать не будут, так что переменные стоит завести до запуска агента. В чеклисте стоимость bcrypt — не ниже 10, и в примере ровно 10; ниже опускать нельзя.
Какие задачи решает
- собрать регистрацию и вход с хешированием паролей
- выпустить access- и refresh-токены с разными сроками жизни
- настроить сессии в Redis с httpOnly-куками
- закрыть маршруты аутентификации от перебора и CSRF
- описать модель угроз для ревью безопасности
Примеры запросов агенту
- Собери модуль аутентификации: вход, регистрация, выход и обновление токена
- Добавь middleware
requireAuthс проверкой JWT из заголовкаAuthorization - Настрой сессии в Redis с httpOnly-куками и защитой от CSRF
Как установить auth-module-builder
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill auth-module-builder -a claude-code2Вручную: положить файлы
~/.claude/skills/auth-module-builder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/auth-module-builder/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill auth-module-builder -a codex2Вручную: положить файлы
.agents/skills/auth-module-builder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill auth-module-builder -a cursor2Вручную: положить файлы
.cursor/skills/auth-module-builder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills backend/auth-module-builder/SKILL.md2Вручную: положить файлы
.github/skills/auth-module-builder/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill auth-module-builder -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path backend/auth-module-builderВручную: положить файлы
.devin/skills/auth-module-builder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill auth-module-builder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об auth-module-builder
Как установить auth-module-builder в Claude Code?
Выполните npx skills add patricio0312rev/skills --skill auth-module-builder -a claude-code. Файл скилла появится в ~/.claude/skills/auth-module-builder/SKILL.md.
Что делает auth-module-builder?
Описывает маршруты входа, регистрации и сброса пароля, middleware проверки JWT, хеширование bcrypt, настройки кук и CSRF. Дополнительно даёт чеклист безопасности и разбор типовых атак с мерами защиты.
Какие переменные окружения нужны?
JWT_SECRET и JWT_REFRESH_SECRET для подписи токенов, SESSION_SECRET для сессий. Все три берутся из окружения, в код их не зашивают.
Исходный текст
SKILL.md · MIT
---
name: auth-module-builder
description: Implements secure authentication patterns including login/registration, session management, JWT tokens, password hashing, cookie settings, and CSRF protection. Provides auth routes, middleware, security configurations, and threat model documentation. Use when building "authentication", "login system", "JWT auth", or "session management".
---
# Auth Module Builder
Implement secure, production-ready authentication systems.
## Core Components
**Routes**: POST /login, /register, /logout, /refresh, /forgot-password
**Middleware**: authenticate, requireAuth, optionalAuth
**Security**: bcrypt hashing, JWT signing, secure cookies, CSRF tokens
**Session**: Redis/DB storage, expiration, refresh tokens
**Threats**: Document common attacks and mitigations
## JWT Pattern
```typescript
// Generate tokens
const accessToken = jwt.sign(
{ userId: user.id, email: user.email },
process.env.JWT_SECRET,
{ expiresIn: "15m" }
);
const refreshToken = jwt.sign(
{ userId: user.id, type: "refresh" },
process.env.JWT_REFRESH_SECRET,
{ expiresIn: "7d" }
);
// Verify middleware
export const authenticate = async (req, res, next) => {
const token = req.headers.authorization?.split(" ")[1];
if (!token) return res.status(401).json({ error: "No token" });
try {
const decoded = jwt.verify(token, process.env.JWT_SECRET);
req.user = await User.findById(decoded.userId);
next();
} catch (err) {
res.status(401).json({ error: "Invalid token" });
}
};
```
## Session Pattern
```typescript
// Express session with Redis
app.use(
session({
store: new RedisStore({ client: redisClient }),
secret: process.env.SESSION_SECRET,
resave: false,
saveUninitialized: false,
cookie: {
secure: process.env.NODE_ENV === "production",
httpOnly: true,
maxAge: 1000 * 60 * 60 * 24 * 7, // 7 days
sameSite: "lax",
},
})
);
```
## Password Security
```typescript
import bcrypt from "bcrypt";
// Hash password
const hashedPassword = await bcrypt.hash(password, 10);
// Verify password
const isValid = await bcrypt.compare(password, user.hashedPassword);
```
## Security Checklist
- [ ] Passwords hashed with bcrypt (cost ≥10)
- [ ] JWT secrets from environment, rotated regularly
- [ ] HTTPS only in production
- [ ] httpOnly, secure cookies
- [ ] CSRF protection enabled
- [ ] Rate limiting on auth routes
- [ ] Account lockout after failed attempts
- [ ] Password reset tokens expire
- [ ] Email verification for new accounts
## Threat Model
**Brute Force**: Rate limit + account lockout
**Token Theft**: Short expiry, httpOnly cookies, HTTPS only
**CSRF**: SameSite cookies + CSRF tokens
**Session Fixation**: Regenerate session ID on login
**XSS**: Sanitize inputs, CSP headers
© patricio0312rev · MIT · patricio0312rev/skills