CommunityProgramación y desarrollogithub.com

mcollina/documentation

Crea, estructura y revisa documentación técnica siguiendo el marco Diátaxis (tutoriales, guías prácticas, referencia y páginas de explicación).

¿Qué es documentation?

Esta habilidad permite a un agente de IA generar, reorganizar y revisar documentación técnica de alta calidad basándose en el marco Diátaxis, que clasifica la documentación en cuatro tipos: tutoriales, guías prácticas, referencias y explicaciones. Es útil para desarrolladores y equipos técnicos que necesitan mejorar la estructura de su documentación, diferenciar entre un tutorial y una guía práctica, crear documentación de referencia o API, o escribir páginas de explicación. Funciona en plataformas como Cursor, Claude Code y Codex, entre otras, y se activa mediante términos como "estructura de documentación", "Diátaxis", "tutoriales vs guías prácticas" y "documentación técnica". Al usarla, el agente aplica las mejores prácticas de escritura técnica y asegura que cada pieza de documentación cumpla con su propósito específico dentro del ecosistema Diátaxis.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace documentation?

Crea, estructura y revisa documentación técnica siguiendo el marco Diátaxis (tutoriales, guías prácticas, referencia y páginas de explicación). Úsala cuando un usuario necesite escribir o reorganizar documentación, estructurar un tutorial en lugar de una guía práctica, crear documentación de referencia o documentación de API, desarrollar páginas de explicación, elegir entre los tipos de documentación de Diátaxis o mejorar la estructura de la documentación existente. Los términos de activación incluyen: estructura de documentación, Diátaxis, tutoriales vs guías prácticas, organizar documentos, guía de usuario, documentos de referencia, escritura técnica.

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 relacionados