Fastify Best Practices

fastify-best-practices

Guides development of Fastify Node.js backend servers and REST APIs using TypeScript or JavaScript. Use when building, configuring, or debugging a Fastify application — including defining routes, implementing plugins, setting up JSON Schema validation, handling errors, optimising performance, man...

mcollina/skills·64.1Kinstalls1.9Kstars

SKILL.md

Full skill instructions

When to use

Use this skill when you need to:

Develop backend applications using Fastify
Implement Fastify plugins and route handlers
Get guidance on Fastify architecture and patterns
Use TypeScript with Fastify (strip types)
Implement testing with Fastify's inject method
Configure validation, serialization, and error handling

Quick Start

A minimal, runnable Fastify server to get started immediately:

import Fastify from 'fastify'

const app = Fastify({ logger: true })

app.get('/health', async (request, reply) => {
  return { status: 'ok' }
})

const start = async () => {
  await app.listen({ port: 3000, host: '0.0.0.0' })
}
start()

How to use

Read individual rule files for detailed explanations and code examples:

rules/plugins.md - Plugin development and encapsulation
rules/routes.md - Route organization and handlers
rules/schemas.md - JSON Schema validation
rules/error-handling.md - Error handling patterns
rules/hooks.md - Hooks and request lifecycle
rules/authentication.md - Authentication and authorization
rules/testing.md - Testing with inject()
rules/performance.md - Performance optimization
rules/logging.md - Logging with Pino
rules/typescript.md - TypeScript integration
rules/decorators.md - Decorators and extensions
rules/content-type.md - Content type parsing
rules/serialization.md - Response serialization
rules/cors-security.md - CORS and security headers
rules/websockets.md - WebSocket support
rules/database.md - Database integration patterns
rules/configuration.md - Application configuration
rules/deployment.md - Production deployment
rules/http-proxy.md - HTTP proxying and reply.from()

Core Principles

Encapsulation: Fastify's plugin system provides automatic encapsulation
Schema-first: Define schemas for validation and serialization
Performance: Fastify is optimized for speed; use its features correctly
Async/await: All handlers and hooks support async functions
Minimal dependencies: Prefer Fastify's built-in features and official plugins

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/mcollina/skills --skill fastify

View on GitHub

skills/fastify/SKILL.md

node
Provides domain-specific best practices for Node.js development with TypeScript, covering type stripping, async patterns, error handling, streams, modules, testing, performance, caching, logging, and more. Use when setting up Node.js projects with native TypeScript support, configuring type strip...
5.6K installs
typescript-magician
Designs complex generic types, refactors `any` types to strict alternatives, creates type guards and utility types, and resolves TypeScript compiler errors. Use when the user asks about TypeScript (TS) types, generics, type inference, type guards, removing `any` types, strict typing, type errors,...
2.6K installs
nodejs-core
Debugs native module crashes, optimizes V8 performance, configures node-gyp builds, writes N-API/node-addon-api bindings, and diagnoses libuv event loop issues in Node.js. Use when working with C++ addons, native modules, binding.gyp, node-gyp errors, segfaults, memory leaks in native code, V8 op...
1.8K installs
documentation
Creates, structures, and reviews technical documentation following the Diátaxis framework (tutorials, how-to guides, reference, and explanation pages). Use when a user needs to write or reorganize docs, structure a tutorial vs. a how-to guide, build reference docs or API documentation, create exp...
1.7K installs

More skills from mcollina

mcollina/skills

oauth

Implements OAuth 2.0/2.1 authorization flows in Fastify applications — configures authorization code with PKCE, client credentials, device flow, refresh token rotation, JWT validation, and token introspection/revocation endpoints. Use when setting up authentication, authorization, login flows, ac...

1.9K 1.3K

View

mcollina/skills

skill-optimizer

Optimizes AI skills for activation, clarity, and cross-model reliability. Use when creating or editing skill packs, diagnosing weak skill uptake, reducing regressions, tuning instruction salience, improving examples, shrinking context cost, or setting benchmark/release gates for skills. Trigger t...

1.9K 1.3K

View

mcollina/skills

octocat

Use this skill whenever the prompt contains any `github.com` URL, even if the user only pastes a link and gives no GitHub-specific keywords. Handles git and GitHub operations using the gh CLI. Triggers include any GitHub link to an issue, pull request, commit, compare page, Actions run, release, ...

1.9K 676

View

mcollina/skills

init

Creates, updates, or optimizes an AGENTS.md file for a repository with minimal, high-signal instructions covering non-discoverable coding conventions, tooling quirks, workflow preferences, and project-specific rules that agents cannot infer from reading the codebase. Use when setting up agent ins...

1.9K 641

View

mcollina/skills

linting-neostandard-eslint9

Configures ESLint v9 flat config and neostandard for JavaScript and TypeScript projects, including migrating from legacy `.eslintrc*` files or the `standard` package. Use when you need to set up or fix linting with `eslint.config.js` or `eslint.config.mjs`, troubleshoot lint errors, configure neo...

1.9K 625

View

mcollina/skills

snipgrapher

Configures and uses snipgrapher to generate polished code snippet images, including syntax-highlighted PNGs, SVGs, and WebP exports with custom themes, profiles, and styling options. Use when the user wants to create code screenshots, turn code into shareable images, generate pretty code snippets...

1.9K 493

View

mcollina/githuman-skills