CommunityEscrita e Ediçãogithub.com

AHMEDGabal1/document-craft

Habilidade open-source para Agentes que cria documentos profissionais em conformidade com normas (ISO/IEEE/APA/PDF-A, i18n/RTL).

O que é document-craft?

Esta habilidade (skill) capacita o agente a gerar documentos profissionais e padronizados de acordo com normas internacionais reconhecidas, como ISO, IEEE, APA e PDF/A, além de suporte nativo para internacionalização (i18n) e direção de texto RTL (direita para esquerda). É ideal para criar Procedimentos Operacionais Padrão (POPs), especificações técnicas, relatórios formais, propostas, contratos, manuais de usuário, whitepapers e documentos acadêmicos. O agente deve primeiro carregar o arquivo de referência correspondente ao tipo de documento antes de iniciar a redação. A habilidade segue um fluxo de trabalho claro: classificar o documento e o público, carregar a referência correta, construir a estrutura básica (bloco de título, sumário, seções numeradas), aplicar tipografia e layout padronizados, redigir cada seção de forma direta e, por fim, revisar usando uma lista de verificação abrangente. As plataformas suportadas incluem ambientes onde agentes como Claude Code, Cursor ou Codex operam, desde que possam acessar os arquivos de referência incluídos na skill (document-types.md, typography-layout.md, internationalization.md). O resultado é a geração de documentos profissionais, consistentes e sem surpresas, adequados para audiências internacionais e reguladas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add AHMEDGabal1/document-craft

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Crie documentos profissionais em conformidade com normas. Carregue o arquivo de referência correspondente antes de redigir.

Quando usar esta habilidade

Ative para: POPs, especificações técnicas, relatórios, propostas/respostas a RFPs, contratos/políticas, manuais de usuário, whitepapers e qualquer documento que precise ser lido como autoritário para um público internacional ou regulamentado.

Princípios fundamentais

  1. Padrões sobre gosto. Siga o padrão correto para o tipo de documento e jurisdição (tabela abaixo). Não invente formatação.
  2. Estrutura antes do texto. Defina seções, numeração e cabeçalhos antes de escrever frases.
  3. Fonte única da verdade. Glossário único, lista única de siglas, bloco único de versão/proprietário/data.
  4. Acessibilidade e localidade. Respeite a localidade (LTR/RTL, formatos de data/número, tamanho de papel, unidades de medida) desde o início.
  5. Sem surpresas. Previsível, escaneável, consistente — não "criativo".

Seleção de padrão

Tipo de documentoPadrão principalReferência
POP / processoISO 9001:2015 (cláusula 7.5)document-types.md
Especificação técnicaISO/IEC/IEEE 29148:2018document-types.md
Requisitos de softwareIEEE 830 / ISO/IEC 25030document-types.md
Relatório formalISO 21500 / ISO 7144document-types.md
Contrato / políticaJurisdição local + ISO 32000 (PDF/A)document-types.md
Acadêmico / citaçõesAPA 7 / Chicago / ISO 690document-types.md
LocalizaçãoISO 17100, W3C i18ninternationalization.md

Fluxo de trabalho

  1. Classifique o tipo de documento e o público (interno/externo, jurisdição, idioma, RTL/LTR).
  2. Carregue o(s) arquivo(s) de referência relevante(s) através da tabela acima.
  3. Construa o esqueleto: bloco de título, versão/proprietário/data, sumário, seções com hierarquia numerada, glossário, referências/apêndices.
  4. Aplique tipografia e layout conforme typography-layout.md (escala tipográfica, espaçamento, níveis de cabeçalho, tabelas, figuras, legendas).
  5. Redija seção por seção. Mantenha frases diretas, voz ativa, sem enchimento.
  6. Revise usando a lista de verificação (abaixo) e o padrão carregado.

Lista de verificação de revisão

  • Padrão correto identificado e aplicado
  • Bloco de título: título, ID do documento, versão, status, proprietário, data, classificação
  • Hierarquia de seções numerada é consistente e sem reinícios
  • Termos definidos uma vez no glossário; siglas expandidas no primeiro uso
  • Figuras/tabelas numeradas e legendadas; referências cruzadas resolvidas
  • Localidade correta (data, número, unidades, tamanho de papel, espelhamento RTL)
  • Citações/referências formatadas conforme estilo escolhido
  • Sem seções órfãs, sem links quebrados, sem texto de espaço reservado
  • Destino de exportação confirmado (PDF/A para arquivamento, ISO 32000)

Referências (carregue conforme necessário)

  • document-types.md — modelos de seção e elementos obrigatórios por tipo de documento
  • typography-layout.md — escala tipográfica, espaçamento, grades, tabelas, figuras, exportação PDF
  • internationalization.md — localidade, RTL/LTR, tradução, numeração entre idiomas

Habilidades Relacionadas