Technical Writing

O skill seo ajuda a auditar, planejar e implementar SEO técnico, otimização on-page, dados estruturados, Core Web Vitals e mapeamento de palavras-chave. Use-o para temas como rastreabilidade, indexabilidade, metadados, schema, links internos, alterações em sitemap e robots, ou SEO para Keyword Research, com orientações específicas por página e prontas para اجراção.

A skill java-coding-standards oferece orientação prática para escrever Java 17+ legível e fácil de manter em serviços Spring Boot, cobrindo nomenclatura, imutabilidade, Optional, streams, exceptions, generics e organização de pacotes. Use-a para programação, refatoração e java-coding-standards em Code Review.

cpp-coding-standards é um guia de padrões de codificação em C++ baseado no C++ Core Guidelines. Use-o para escrever, revisar e refatorar C++ moderno com foco em segurança, clareza, manutenibilidade, RAII, segurança de tipos e bom design. Ideal para usar o cpp-coding-standards em Code Review e em decisões práticas de time.

code-tour cria arquivos CodeTour `.tour` reutilizáveis com âncoras reais em arquivos e linhas. Use o skill code-tour para tours de onboarding, walkthroughs de arquitetura, tours de PR, caminhos de RCA e code-tour para Technical Writing quando você precisar de uma sequência guiada em vez de um resumo estático.

A skill article-writing ajuda a criar conteúdos longos com boa estrutura, consistência de voz e base em evidências. Use para artigos, guias, tutoriais, newsletters e fluxos de Copywriting com article-writing, quando o objetivo for um texto refinado e pronto para publicar.

A skill architecture-decision-records ajuda a registrar decisões de arquitetura durante sessões no Claude Code como ADRs estruturados. Ela identifica momentos de decisão, registra contexto, alternativas e justificativa, e mantém um histórico de ADR para futuras pessoas mantenedoras. É útil para equipes de Technical Writing e de engenharia que precisam de um histórico durável de decisões.

api-design é uma skill de design de APIs REST para planejar e revisar endpoints, nomenclatura de recursos, códigos de status, paginação, filtragem, versionamento e respostas de erro.

brainstorming é uma skill de pré-implementação que explora o contexto, faz perguntas de esclarecimento uma por vez e exige aprovação do design antes de qualquer código. Inclui um companion visual opcional e forte suporte a planejamento de requisitos.

O writing-plans ajuda a transformar uma especificação ou documento de requisitos num plano de implementação detalhado, com orientação ao nível de ficheiros, sequência de tarefas, passos de teste e um prompt de revisão antes de começar a programar.

doc-coauthoring é um fluxo estruturado para criar documentação com IA, reunindo contexto, refinando o outline, escrevendo por seções e testando com leitores para gerar specs, RFCs e propostas prontas para revisão.

technical-writer é uma skill leve de documentação para criar README files, docs de API, guias de configuração, tutoriais, materiais de onboarding e notas de versão com mais clareza. Ela coloca a escrita técnica a serviço dos objetivos do usuário, com foco em quick starts, exemplos e troubleshooting. A skill é entregue em um único arquivo SKILL.md, sem scripts ou templates extras.

document-release é um skill de atualização de documentação pós-release que lê a documentação do projeto, cruza as mudanças entregues com o diff e atualiza README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, CHANGELOG e VERSION para que a documentação reflita exatamente o que foi publicado. Use o skill document-release em redação técnica quando o código já estiver mesclado e você precisar de um guia confiável de document-release.

caveman é uma skill de comunicação ultracompacta para respostas técnicas curtas, resumos e ajuda com depuração. Ela preserva o sentido técnico, corta o excesso e permanece ativa após o gatilho até você dizer stop caveman ou normal mode. É ideal para Technical Writing, notas de code review, atualizações de incidentes e trocas mais rápidas quando você já conhece o assunto.

A skill edit-article ajuda a reestruturar rascunhos já existentes, melhorar a clareza e enxugar o texto. Use quando precisar de um guia confiável de edit-article para revisar artigos, especialmente em fluxos de trabalho de redação técnica em que a ordem das seções e as dependências importam.

writing-shape é uma skill de rascunho conversacional para transformar material bruto em Markdown em um artigo publicável. Ela ajuda na escolha da abertura, no desenvolvimento parágrafo a parágrafo e nas decisões de estrutura para Technical Writing, notas de entrevistas, limpeza de transcrições e rascunhos iniciais. Use o guia writing-shape quando você precisar de um processo editorial guiado, e não de um prompt único.

grill-with-docs é uma skill de planejamento e documentação que testa o seu plano contra o modelo de domínio já existente no repositório, refina a terminologia e atualiza `CONTEXT.md` e ADRs à medida que as decisões se consolidam. Use-a em Technical Writing, engenharia com foco em produto e qualquer fluxo em que a linguagem ancorada no repositório importe mais do que um brainstorming baseado só em prompt.

ubiquitous-language é uma skill no estilo DDD que extrai um glossário compartilhado de conversas, sinaliza termos ambíguos e sinônimos, e escreve UBIQUITOUS_LANGUAGE.md. Use-a para definir termos do domínio, alinhar equipes e aprimorar o ubiquitous-language em Technical Writing.

python-code-style ajuda com formatação, linting, nomenclatura, type hints e docstrings em Python. Use para revisar pull requests, padronizar convenções da equipe e orientar a configuração de ruff, mypy ou pyright no `pyproject.toml`.

architecture-decision-records ajuda equipes a criar e manter ADRs com contexto, decisões, alternativas e consequências bem definidos, para uma documentação técnica de decisões durável e consistente.

A skill changelog-automation ajuda equipes a estruturar fluxos de changelog com Keep a Changelog, SemVer, release notes e Conventional Commits. Use para planejar o contexto de instalação, definir entradas de uso e melhorar a consistência das notas de versão em Technical Writing e documentação para desenvolvedores.

A skill add-educational-comments adiciona comentários didáticos a um arquivo de código especificado, preservando a estrutura e o comportamento. Ela pode solicitar o arquivo se ele não for informado, adapta a explicação ao nível de quem vai ler e segue limites claros de crescimento de linhas para edição educacional de código.

gws-docs ajuda você a ler e escrever no Google Docs por meio da CLI `gws`, com controle em nível de método para criação, leitura e atualizações em lote. Siga o fluxo de instalação, schema e uso no guia gws-docs para redação técnica e automação de documentação.

adr-skill ajuda equipes a criar e manter Architecture Decision Records que agentes conseguem executar. Ele oferece suporte para redigir ADRs, estruturar pastas iniciais, escolher templates, atualizar status e validar decisões com checklists, scripts e exemplos.

Clarify melhora textos confusos de UX, mensagens de erro, rótulos, etapas de onboarding e instruções para que as pessoas consigam agir com menos dúvida. É útil para Redação Técnica, conteúdo de suporte e equipes de produto que precisam de textos de interface mais claros. A skill começa pelo contexto, pelo público e pelo estado do usuário antes de reescrever, para que o resultado seja mais direto, específico e fácil de usar.