mcollina/documentation

Crée, structure et révise une documentation technique selon le cadre Diátaxis (tutoriels, guides pratiques, documentation de référence et pages d’explication).

Qu'est-ce que documentation ?

Cette compétence aide à créer, structurer et réviser une documentation technique en suivant le cadre Diátaxis, une méthodologie qui divise la documentation en quatre types distincts : tutoriels, guides pratiques, documentation de référence et pages d’explication. Elle est particulièrement utile lorsqu’un utilisateur doit rédiger ou réorganiser des documents, choisir entre un tutoriel et un guide pratique, construire une documentation de référence ou d’API, créer des pages d’explication, ou améliorer la structure existante de sa documentation. Basée sur SKILL.md, elle fournit des conseils précis pour chaque type de document et s’active avec des termes déclencheurs comme « structure de documentation », « tutoriels vs guides pratiques », ou « rédaction technique ». La compétence est conçue pour être intégrée dans des agents IA comme Claude Code ou Cursor, et son approche systématique garantit une documentation claire et adaptée aux besoins des utilisateurs finaux.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mcollina/skills/tree/main/skills/documentation

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait documentation ?

Crée, structure et révise une documentation technique en suivant le cadre Diátaxis (tutoriels, guides pratiques, documentation de référence et pages d’explication). À utiliser lorsqu’un utilisateur a besoin de rédiger ou de réorganiser des documents, de structurer un tutoriel par rapport à un guide pratique, de créer une documentation de référence ou d’API, de produire des pages d’explication, de choisir entre les types de documentation Diátaxis, ou d’améliorer la structure d’une documentation existante. Les termes déclencheurs incluent : structure de documentation, Diátaxis, tutoriels vs guides pratiques, organiser la documentation, guide utilisateur, documentation de référence, rédaction technique.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

mcollina/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, managing authentication, configuring CORS and security headers, integrating databases, working with WebSockets, and deploying to production. Covers the full Fastify request lifecycle (hooks, serialization, logging with Pino) and TypeScript integration via strip types. Trigger terms: Fastify, Node.js server, REST API, API routes, backend framework, fastify.config, server.ts, app.ts.

mcollina/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 stripping (--experimental-strip-types), writing Node 22+ TypeScript without a build step, or when the user mentions 'native TypeScript in Node', 'strip types', 'Node 22 TypeScript', '.ts files without compilation', 'ts-node alternative', or needs guidance on error handling, graceful shutdown, flaky tests, profiling, or environment configuration in Node.js. Helps configure tsconfig.json for type stripping, set up package.json scripts, handle module resolution and import extensions, and apply robust patterns across the full Node.js stack.

mcollina/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 optimization/deoptimization, libuv thread pool tuning, N-API or NAN bindings, build system failures, or any Node.js internals below the JavaScript layer.

mcollina/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, `infer`, `extends`, conditional types, mapped types, template literal types, branded/opaque types, or utility types like `Partial`, `Record`, `ReturnType`, and `Awaited`.

Skills associés