Impeccable Backend

25 backend skills for AI coding assistants.

The backend equivalent of Impeccable — a vocabulary of expert backend knowledge packaged as skills for Claude Code, Cursor, Antigravity, and Gemini CLI.

Works with any major backend stack: Node.js/Express, NestJS, FastAPI, Django, Laravel, Spring Boot, Go/Gin.

Install

# Auto-detects your AI tool
npx impeccable-backend

# Install globally (available in all projects)
npx impeccable-backend --global

# Install for a specific tool
npx impeccable-backend --tool=cursor
npx impeccable-backend --tool=claude
npx impeccable-backend --tool=antigravity
npx impeccable-backend --tool=gemini

First Step After Installing

Run /teach-backend once per project. It scans your stack and saves a .impeccable-backend.md context file that every other skill reads automatically.

Skills (25)

⚙️ Setup

| Skill | What it does | |---|---| | /teach-backend | Gather project context once — stack, DB, auth, conventions. All other skills benefit. | | /onboard-backend | Generate ONBOARDING.md for new team members. Setup guide, architecture overview, common tasks. | | /env-config | Audit env vars, add startup validation, organize .env structure, secrets checklist. |

🔍 Audit & Review

| Skill | What it does | |---|---| | /code-review | Full code review: security, performance, correctness, maintainability, test gaps. | | /security-audit | OWASP Top 10 audit, injection checks, CORS, headers, secrets, mass assignment. |

🏗️ Architecture

| Skill | What it does | |---|---| | /architecture | Layered architecture, folder structure, service/repository pattern, separation of concerns. | | /api-design | REST best practices: naming, HTTP methods, status codes, versioning, pagination, response shape. | | /microservices | Service boundaries, event-driven patterns, circuit breakers, API gateway — and when NOT to use microservices. | | /scalability | Stateless design, read replicas, connection pooling, bottleneck identification, load testing. |

🗄️ Data

| Skill | What it does | |---|---| | /db-schema | Schema design, normalization, indexing strategy, soft deletes, constraints, naming conventions. | | /data-modeling | Complex modeling: polymorphic associations, hierarchical data, multi-tenancy, audit logs, time-series. | | /migrations | Reversible migrations, zero-downtime strategy (expand/contract), naming, CI integration. |

🔐 Security & Auth

| Skill | What it does | |---|---| | /auth-patterns | JWT access+refresh tokens, RBAC, OAuth2, API keys, password hashing, token rotation. | | /rate-limiting | Per-IP, per-user, per-endpoint limits, Redis-backed, 429 responses with Retry-After. | | /validation | Schema validation (Zod/Pydantic/etc), request body/query/params, sanitization, consistent error shape. |

⚡ Performance

| Skill | What it does | |---|---| | /performance | N+1 detection, index strategy, caching opportunities, async processing, connection pooling. | | /caching | Redis setup, cache-aside pattern, TTL strategy, cache invalidation, HTTP cache headers. | | /queue-workers | BullMQ/Celery/Laravel Queue setup, job retry strategies, scheduled jobs, monitoring with Bull Board. |

🧪 Quality

| Skill | What it does | |---|---| | /testing | Test pyramid, integration tests with real DB, factories, mocking, coverage targets. | | /refactor | Extract functions, remove N+1, replace magic values, consolidate error handling, SOLID. | | /error-handling | Centralized error middleware, custom error classes, async propagation, DB error normalization. | | /logging | Structured logging with Pino/structlog, log levels, PII redaction, correlation IDs, aggregator integration. |

📦 Operations

| Skill | What it does | |---|---| | /deployment | Production Dockerfile, health check endpoint, graceful shutdown, CI/CD pipeline, checklist. | | /monitoring | Sentry integration, custom Prometheus metrics, uptime monitoring, alert thresholds, distributed tracing. | | /documentation | OpenAPI/Swagger setup, JSDoc annotations, README structure, stack-specific auto-doc tools. |

How Skills Activate

Skills activate when you describe what you need in natural language. No slash commands required (except in Claude Code).

| Instead of | Say | |---|---| | /api-design | "My routes are inconsistent, fix the API design" | | /security-audit | "Audit the security of this endpoint before we ship" | | /testing | "Add integration tests for the auth module" | | /performance | "These queries are slow, help me optimize" | | /refactor | "This service file is 400 lines, clean it up" |

To force a specific skill: "Use the /auth-patterns skill to implement refresh token rotation"

Update

npx impeccable-backend --update

Stack Support

Every skill includes stack-specific notes for:

• Node.js — Express, NestJS
• Python — FastAPI, Django
• PHP — Laravel
• Java — Spring Boot
• Go — Gin

License

MIT — personal use now, open source when ready.