CommunityProgramação e Desenvolvimentogithub.com

mcollina/documentação

Cria, estrutura e revisa documentação técnica seguindo o framework Diátaxis (tutoriais, guias práticos, referência e páginas explicativas). Utilize quando precisar escrever ou reorganizar documentação, estruturar um tutorial vs. um guia prático, criar documentação de referência ou de API, criar páginas explicativas, escolher entre os tipos de documentação Diátaxis ou melhorar a estrutura da documentação existente. Termos de ativação: estrutura de documentação, Diátaxis, tutoriais vs guias práticos, organizar documentação, guia do usuário, documentação de referência, redação técnica.

O que é documentação?

Esta skill capacita agentes de IA a atuarem como especialistas em documentação técnica, seguindo o framework Diátaxis, que divide a documentação em quatro tipos: tutoriais (aprendizado guiado), guias práticos (como fazer uma tarefa específica), referência (descrições técnicas precisas) e explicações (contexto e fundamentos). Ela é útil para desenvolvedores e equipes que precisam criar, estruturar ou revisar documentação técnica de forma consistente e profissional, suportando plataformas como Claude Code, Cursor e Codex. A skill analisa o contexto do usuário, sugere o tipo de documentação mais adequado com base na necessidade (ex: ensinar, resolver um problema, descrever uma API ou aprofundar conceitos), gera o conteúdo seguindo boas práticas de redação técnica e pode revisar documentação existente para identificar lacunas de estrutura, clareza ou aderência ao Diátaxis. O resultado é uma documentação mais clara, organizada e útil, adaptada ao público-alvo e ao propósito.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentação

O que documentação faz?

Cria, estrutura e revisa documentação técnica seguindo o framework Diátaxis (tutoriais, guias práticos, referência e páginas explicativas). Utilize quando precisar escrever ou reorganizar documentação, estruturar um tutorial vs. um guia prático, criar documentação de referência ou de API, criar páginas explicativas, escolher entre os tipos de documentação Diátaxis ou melhorar a estrutura da documentação existente. Termos de ativação: estrutura de documentação, Diátaxis, tutoriais vs guias práticos, organizar documentação, guia do usuário, documentação de referência, redação 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`.

Habilidades Relacionadas

steipete/bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

community

steipete/eightctl

Control Eight Sleep pods (status, temperature, alarms, schedules).

community

steipete/blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

community

steipete/bear-notes

Create, search, and manage Bear notes via grizzly CLI.

community

steipete/camsnap

Capture frames or clips from RTSP/ONVIF cameras.

community

steipete/gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

community
← More Programação e Desenvolvimento skills