Pular para o conteúdo
Skillpedia
Escrita48 mil · #2871

documentation

Ajuda seu agente a criar documentação técnica. Ele pode escrever arquivos README, comentários de código e documentação de API. É útil para manter o código organizado e compreensível.

O que ela faz

Esta ferramenta ajuda a criar diversos tipos de documentação para projetos de software, como manuais, descrições de código e guias de uso. Ela organiza o processo de escrita e garante que tudo fique claro e completo.

Quando usar

  • ✓Quando você precisa criar a documentação de um novo projeto.
  • ✓Ao escrever a descrição de como uma API funciona.
  • ✓Para explicar o funcionamento interno de um código.

Exemplo do que pedir para a IA

“Crie a documentação completa para o meu projeto, incluindo README, guias de API e comentários de código.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/documentation/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/documentation/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A ferramenta funciona dividindo o trabalho em etapas, como planejar a estrutura, documentar a API, explicar o código e criar manuais. Ela usa outras ferramentas menores para cada tarefa específica.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add sickn33/agentic-awesome-skills --skill documentation

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/documentation/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Pacote de Fluxo de Trabalho de Documentação

Visão Geral

Fluxo de trabalho abrangente de documentação para gerar documentação de API, documentação de arquitetura, arquivos README, comentários de código e conteúdo técnico a partir de bases de código.

Quando Usar Este Fluxo de Trabalho

Use este fluxo de trabalho quando:

  • Criar documentação de projeto
  • Gerar documentação de API
  • Escrever documentação de arquitetura
  • Documentar código
  • Criar guias do usuário
  • Manter wikis

Escopo

Selecione apenas as fases necessárias para a solicitação; este pacote não autoriza todas as habilidades referenciadas ou publicações externas. Verifique cada ID e pré-requisitos locais antes da invocação. Preserve a documentação existente, distinga as decisões propostas das aceitas, mantenha dados privados fora de exemplos públicos e execute as verificações de documentação reais do projeto.

Fases do Fluxo de Trabalho

Fase 1: Planejamento da Documentação

Habilidades a Invocar

  • docs-architect - Arquitetura de documentação
  • documentation-templates - Modelos de documentação

Ações

  1. Identificar necessidades de documentação
  2. Escolher ferramentas de documentação
  3. Planejar a estrutura da documentação
  4. Definir diretrizes de estilo
  5. Configurar o site de documentação

Prompts Copiar e Colar

Use @docs-architect to plan documentation structure
Use @documentation-templates to set up documentation

Fase 2: Documentação de API

Habilidades a Invocar

  • api-documenter - Documentação de API
  • api-documentation-generator - Geração automática
  • openapi-spec-generation - Especificações OpenAPI

Ações

  1. Extrair endpoints de API
  2. Gerar especificações OpenAPI
  3. Criar referência de API
  4. Adicionar exemplos de uso
  5. Configurar geração automática

Prompts Copiar e Colar

Use @api-documenter to generate API documentation
Use @openapi-spec-generation to create OpenAPI specs

Fase 3: Documentação de Arquitetura

Habilidades a Invocar

  • c4-architecture-c4-architecture - Arquitetura C4
  • c4-context - Diagramas de contexto
  • c4-container - Diagramas de contêiner
  • c4-component - Diagramas de componentes
  • c4-code - Diagramas de código
  • mermaid-expert - Diagramas Mermaid

Ações

  1. Criar diagramas C4
  2. Documentar a arquitetura
  3. Gerar diagramas de sequência
  4. Documentar fluxos de dados
  5. Criar documentação de implantação

Prompts Copiar e Colar

Use @c4-architecture-c4-architecture to create C4 diagrams
Use @mermaid-expert to create architecture diagrams

Fase 4: Documentação de Código

Habilidades a Invocar

  • code-documentation-code-explain - Explicação de código
  • code-documentation-doc-generate - Geração de documentação
  • documentation-generation-doc-generate - Geração automática

Ações

  1. Extrair comentários de código
  2. Gerar JSDoc/TSDoc
  3. Criar documentação de tipos
  4. Documentar funções
  5. Adicionar exemplos de uso

Prompts Copiar e Colar

Use @code-documentation-code-explain to explain code
Use @code-documentation-doc-generate to generate docs

Fase 5: README e Primeiros Passos

Habilidades a Invocar

  • readme - Geração de README
  • environment-setup-guide - Guias de configuração
  • tutorial-engineer - Criação de tutoriais

Ações

  1. Criar README
  2. Escrever guia de primeiros passos
  3. Documentar instalação
  4. Adicionar exemplos de uso
  5. Criar guia de solução de problemas

Prompts Copiar e Colar

Use @readme to create project README
Use @tutorial-engineer to create tutorials

Fase 6: Wiki e Base de Conhecimento

Habilidades a Invocar

  • wiki-architect - Arquitetura de wiki
  • wiki-page-writer - Páginas de wiki
  • wiki-onboarding - Documentos de integração
  • wiki-qa - Perguntas e Respostas da Wiki
  • wiki-researcher - Pesquisa na Wiki
  • wiki-vitepress - Wiki VitePress

Ações

  1. Projetar estrutura da wiki
  2. Criar páginas de wiki
  3. Escrever guias de integração
  4. Documentar processos
  5. Configurar site da wiki

Prompts Copiar e Colar

Use @wiki-architect to design wiki structure
Use @wiki-page-writer to create wiki pages
Use @wiki-onboarding to create onboarding docs

Fase 7: Changelog e Notas de Lançamento

Habilidades a Invocar

  • changelog-automation - Geração de changelog
  • wiki-changelog - Changelog a partir do git

Ações

  1. Extrair histórico de commits
  2. Categorizar alterações
  3. Gerar changelog
  4. Criar notas de lançamento
  5. Preparar atualizações; publicar apenas no destino explicitamente autorizado

Prompts Copiar e Colar

Use @changelog-automation to generate changelog
Use @wiki-changelog to create release notes

Fase 8: Manutenção da Documentação

Habilidades a Invocar

  • doc-coauthoring - Escrita colaborativa
  • reference-builder - Documentos de referência

Ações

…

Perguntas frequentes

O que são 'skills'?

Skills são como ferramentas ou mini-programas que a IA usa para realizar tarefas específicas, como gerar documentação ou explicar código.

O que é um 'workflow bundle'?

É um conjunto de instruções e ferramentas organizadas para realizar uma tarefa maior, como a criação de toda a documentação de um projeto.

Preciso saber programar para usar isso?

Não, a ideia é que você possa pedir a documentação sem precisar entender os detalhes técnicos de programação.

Detalhes

Descrição original do autor

Documentation generation workflow covering API docs, architecture docs, README files, code comments, and technical writing.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#2871
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas