Pular para o conteúdo
Skillpedia
Escrita181 mil · #320

doc-coauthoring

Ajuda seu agente a guiar você na escrita de documentos importantes. É útil quando você precisa criar documentação, propostas ou especificações.

O que ela faz

Ajuda você a escrever documentos importantes, como propostas ou especificações técnicas, de forma organizada. Ele te guia em etapas para garantir que tudo fique claro para quem for ler.

Quando usar

  • ✓Quando você precisa escrever um documento formal.
  • ✓Ao criar uma proposta para um projeto.
  • ✓Se você está elaborando especificações técnicas.

Exemplo do que pedir para a IA

“Quero escrever uma proposta para um novo projeto. Pode me ajudar a organizar as ideias?”

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/anthropics/skills/blob/main/skills/doc-coauthoring/SKILL.md

Mensagem pronta para colar

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

A IA te faz perguntas para entender o contexto e o objetivo do documento. Depois, ajuda a organizar as seções e a refinar o texto, como se fosse um colega revisando com você.

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 anthropics/skills --skill doc-coauthoring

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/anthropics/skills/main/skills/doc-coauthoring/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.

Fluxo de Trabalho de Coautoria de Documentos

Esta habilidade oferece um fluxo de trabalho estruturado para guiar os usuários na criação colaborativa de documentos. Atue como um guia ativo, conduzindo os usuários por três estágios: Coleta de Contexto, Refinamento e Estrutura, e Teste com Leitores.

Quando Oferecer Este Fluxo de Trabalho

Condições de Gatilho:

  • O usuário menciona escrever documentação: "escrever um documento", "elaborar uma proposta", "criar uma especificação", "redigir"
  • O usuário menciona tipos específicos de documentos: "PRD", "documento de design", "documento de decisão", "RFC"
  • O usuário parece estar iniciando uma tarefa de escrita substancial

Oferta Inicial: Ofereça ao usuário um fluxo de trabalho estruturado para coautoria do documento. Explique os três estágios:

  1. Coleta de Contexto: O usuário fornece todo o contexto relevante enquanto o Claude faz perguntas esclarecedoras.
  2. Refinamento e Estrutura: Construa iterativamente cada seção através de brainstorming e edição.
  3. Teste com Leitores: Teste o documento com um Claude "fresco" (sem contexto) para identificar pontos cegos antes que outras pessoas o leiam.

Explique que essa abordagem ajuda a garantir que o documento funcione bem quando outras pessoas o lerem (inclusive quando o colarem no Claude). Pergunte se eles querem tentar este fluxo de trabalho ou preferem trabalhar de forma livre.

Se o usuário recusar, trabalhe de forma livre. Se o usuário aceitar, prossiga para o Estágio 1.

Estágio 1: Coleta de Contexto

Objetivo: Reduzir a lacuna entre o que o usuário sabe e o que o Claude sabe, permitindo orientação inteligente posteriormente.

Perguntas Iniciais

Comece perguntando ao usuário metadados sobre o documento:

  1. Que tipo de documento é este? (por exemplo, especificação técnica, documento de decisão, proposta)
  2. Quem é o público principal?
  3. Qual é o impacto desejado quando alguém lê este documento?
  4. Existe um modelo ou formato específico a seguir?
  5. Alguma outra restrição ou contexto a saber?

Informe-os que eles podem responder em linguagem abreviada ou despejar informações da maneira que for melhor para eles.

Se o usuário fornecer um modelo ou mencionar um tipo de documento:

  • Pergunte se eles têm um documento modelo para compartilhar.
  • Se eles fornecerem um link para um documento compartilhado, use a integração apropriada para buscá-lo.
  • Se eles fornecerem um arquivo, leia-o.

Se o usuário mencionar a edição de um documento compartilhado existente:

  • Use a integração apropriada para ler o estado atual.
  • Verifique se há imagens sem texto alternativo (alt-text).
  • Se houver imagens sem texto alternativo, explique que, quando outras pessoas usarem o Claude para entender o documento, o Claude não conseguirá vê-las. Pergunte se eles querem que o texto alternativo seja gerado. Se sim, peça que colem cada imagem no chat para geração de texto alternativo descritivo.

Despejo de Informações

Depois que as perguntas iniciais forem respondidas, incentive o usuário a despejar todo o contexto que ele tem. Solicite informações como:

  • Histórico do projeto/problema
  • Discussões de equipe relacionadas ou documentos compartilhados
  • Por que soluções alternativas não estão sendo usadas
  • Contexto organizacional (dinâmica de equipe, incidentes passados, política)
  • Pressões ou restrições de cronograma
  • Arquitetura técnica ou dependências
  • Preocupações das partes interessadas

Aconselhe-os a não se preocuparem em organizar - apenas despejem tudo. Ofereça várias maneiras de fornecer contexto:

  • Despejo de informações em fluxo de consciência
  • Aponte para canais ou threads de equipe para ler
  • Link para documentos compartilhados

Se integrações estiverem disponíveis (por exemplo, Slack, Teams, Google Drive, SharePoint ou outros servidores MCP), mencione que elas podem ser usadas para puxar contexto diretamente.

Se nenhuma integração for detectada e estiver no Claude.ai ou no aplicativo Claude: Sugira que eles podem habilitar conectores em suas configurações do Claude para permitir a puxada de contexto diretamente de aplicativos de mensagens e armazenamento de documentos.

Informe-os que perguntas esclarecedoras serão feitas depois que eles fizerem seu despejo inicial.

Durante a coleta de contexto:

  • Se o usuário mencionar canais de equipe ou documentos compartilhados:

    • Se integrações estiverem disponíveis: Informe-os que o conteúdo será lido agora e, em seguida, use a integração apropriada.
    • Se integrações não estiverem disponíveis: Explique a falta de acesso. Sugira que eles habilitem conectores nas configurações do Claude ou colem o conteúdo relevante diretamente.
  • Se o usuário mencionar entidades/projetos que são desconhecidos:

    • Pergunte se as ferramentas conectadas devem ser pesquisadas para saber mais.
    • Aguarde a confirmação do usuário antes de pesquisar.
  • À medida que o usuário fornece contexto, acompanhe o que está sendo aprendido e o que ainda está pouco claro.

Fazendo perguntas esclarecedoras:

Quando o usuário sinalizar que fez seu despejo inicial (ou após um contexto substancial ter sido fornecido), faça perguntas esclarecedoras para garantir o entendimento:

Gere 5-10 perguntas numeradas com base nas lacunas no contexto.

…

Perguntas frequentes

O que são as três etapas?

São: 1. Coleta de Contexto (você me diz tudo sobre o documento), 2. Refinamento e Estrutura (organizamos e escrevemos seção por seção) e 3. Teste com Leitor (simulamos alguém lendo para achar pontos fracos).

E se eu não tiver um modelo pronto?

Não tem problema! A IA pode sugerir seções com base no tipo de documento que você quer criar.

A IA pode ler documentos que já tenho?

Se você usar a IA em uma plataforma que permite isso (como o Claude.ai com conectores ativados), ela pode ler documentos de onde eles estiverem guardados, como Google Drive ou Slack.

Detalhes

Descrição original do autor

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or

repo: anthropics/skills

Popularidade

Estrelas no GitHub
181 mil
Posição no ranking
#320
Licença
—
Atualizada em
09/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas