Communitygithub.com

David-Li0406/meta-skill-evloving

Criação, edição e análise abrangente de documentos com suporte a alterações controladas, comentários, preservação de formatação e extração de texto. Ideal quando Claude precisa trabalhar com documentos profissionais (.docx) para: (1) criar novos documentos, (2) modificar ou editar conteúdo, (3) trabalhar com alterações controladas, (4) adicionar comentários ou qualquer outra tarefa com documentos.

O que é meta-skill-evloving?

Esta skill capacita o Claude a trabalhar profissionalmente com arquivos .docx, permitindo criação, edição e análise de documentos com preservação de formatos complexos. Ela suporta plataformas como Claude Code, Cursor e Codex, e oferece workflows especializados: desde extração de texto via pandoc até acesso XML bruto para manipulação avançada. A skill é particularmente útil para tarefas que exigem alterações controladas, comentários ou edição de documentos legais/acadêmicos, utilizando uma árvore de decisão clara para escolher o workflow adequado. Para edição, ela implementa um sistema de 'redlining' que planeja alterações em markdown antes de aplicá-las via OOXML, com suporte a batching e mapeamento preciso de texto para XML. Além disso, permite conversão de documentos para imagens (via PDF) para análise visual. Dependências como pandoc, docx (npm), LibreOffice e Poppler são necessárias, mas a skill fornece instruções completas de instalação e uso.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/David-Li0406/meta-skill-evloving/tree/HEAD/AgentSkillOS/data/skill_seeds/docx

Perguntar na sua IA favorita

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

Documentação

Criação, edição e análise de arquivos DOCX

Visão Geral

O usuário pode solicitar que você crie, edite ou analise o conteúdo de um arquivo .docx. Um arquivo .docx é essencialmente um arquivo ZIP contendo arquivos XML e outros recursos que você pode ler ou editar. Você dispõe de diferentes ferramentas e workflows para diferentes tarefas.

Árvore de Decisão do Workflow

Leitura/Análise de Conteúdo

Use as seções "Extração de texto" ou "Acesso XML bruto" abaixo

Criação de Novo Documento

Use o workflow "Criando um novo documento Word"

Edição de Documento Existente

  • Documento próprio + alterações simples Use o workflow "Edição OOXML básica"

  • Documento de terceiros Use o "Workflow de redlining" (recomendado como padrão)

  • Documentos jurídicos, acadêmicos, empresariais ou governamentais Use o "Workflow de redlining" (obrigatório)

Leitura e análise de conteúdo

Extração de texto

Se você precisar apenas ler o conteúdo textual de um documento, converta o documento para markdown usando pandoc. O pandoc oferece excelente suporte para preservar a estrutura do documento e pode mostrar alterações controladas:

# Converter documento para markdown com alterações controladas
pandoc --track-changes=all caminho-para-arquivo.docx -o saida.md
# Opções: --track-changes=accept/reject/all

Acesso XML bruto

Você precisa de acesso XML bruto para: comentários, formatação complexa, estrutura do documento, mídia incorporada e metadados. Para qualquer um desses recursos, você precisará descompactar um documento e ler seu conteúdo XML bruto.

Descompactando um arquivo

python ooxml/scripts/unpack.py <arquivo_office> <diretoria_saida>

Estruturas de arquivo principais

  • word/document.xml - Conteúdo principal do documento
  • word/comments.xml - Comentários referenciados em document.xml
  • word/media/ - Imagens e arquivos de mídia incorporados
  • Alterações controladas usam tags <w:ins> (inserções) e <w:del> (exclusões)

Criando um novo documento Word

Ao criar um novo documento Word do zero, use o docx-js, que permite criar documentos Word usando JavaScript/TypeScript.

Workflow

  1. OBRIGATÓRIO - LEIA O ARQUIVO INTEIRO: Leia docx-js.md (~500 linhas) completamente do início ao fim. NUNCA defina limites de alcance ao ler este arquivo. Leia o conteúdo completo do arquivo para obter sintaxe detalhada, regras críticas de formatação e melhores práticas antes de prosseguir com a criação do documento.
  2. Crie um arquivo JavaScript/TypeScript usando componentes Document, Paragraph, TextRun (Você pode assumir que todas as dependências estão instaladas; caso contrário, consulte a seção de dependências abaixo)
  3. Exporte como .docx usando Packer.toBuffer()

Editando um documento Word existente

Ao editar um documento Word existente, use a biblioteca Document (uma biblioteca Python para manipulação OOXML). A biblioteca gerencia automaticamente a configuração da infraestrutura e fornece métodos para manipulação de documentos. Para cenários complexos, você pode acessar o DOM subjacente diretamente através da biblioteca.

Workflow

  1. OBRIGATÓRIO - LEIA O ARQUIVO INTEIRO: Leia ooxml.md (~600 linhas) completamente do início ao fim. NUNCA defina limites de alcance ao ler este arquivo. Leia o conteúdo completo do arquivo para obter a API da biblioteca Document e padrões XML para edição direta de arquivos de documento.
  2. Descompacte o documento: python ooxml/scripts/unpack.py <arquivo_office> <diretoria_saida>
  3. Crie e execute um script Python usando a biblioteca Document (veja a seção "Document Library" em ooxml.md)
  4. Compacte o documento final: python ooxml/scripts/pack.py <diretoria_entrada> <arquivo_office>

A biblioteca Document fornece tanto métodos de alto nível para operações comuns quanto acesso direto ao DOM para cenários complexos.

Workflow de redlining para revisão de documentos

Este workflow permite planejar alterações controladas abrangentes usando markdown antes de implementá-las em OOXML. CRÍTICO: Para alterações controladas completas, você deve implementar TODAS as alterações sistematicamente.

Estratégia de Lotes: Agrupe alterações relacionadas em lotes de 3 a 10 alterações. Isso torna a depuração gerenciável enquanto mantém a eficiência. Teste cada lote antes de passar para o próximo.

Princípio: Edições Mínimas e Precisas Ao implementar alterações controladas, marque apenas o texto que realmente muda. Repetir texto inalterado dificulta a revisão das edições e parece pouco profissional. Divida as substituições em: [texto inalterado] + [exclusão] + [inserção] + [texto inalterado]. Preserve o RSID da execução original para o texto inalterado, extraindo o elemento <w:r> do original e reutilizando-o.

Exemplo - Alterando "30 dias" para "60 dias" em uma frase:

# RUIM - Substitui a frase inteira
'<w:del><w:r><w:delText>O prazo é de 30 dias.</w:delText></w:r></w:del><w:ins><w:r><w:t>O prazo é de 60 dias.</w:t></w:r></w:ins>'

# BOM - Apenas marca o que mudou, preserva o <w:r> original para o texto inalterado
'<w:r w:rsidR="00AB12CD"><w:t>O prazo é de </w:t></w:r><w:del><w:r><w:delText>30</w:delText></w:r></w:del><w:ins><w:r><w:t>60</w:t></w:r></w:ins><w:r w:rsidR="00AB12CD"><w:t> dias.</w:t></w:r>'

Workflow de alterações controladas

  1. Obter representação markdown: Converta o documento para markdown com as alterações controladas preservadas:

    pandoc --track-changes=all caminho-para-arquivo.docx -o atual.md
    
  2. Identificar e agrupar alterações: Revise o documento e identifique TODAS as alterações necessárias, organizando-as em lotes lógicos:

    Métodos de localização (para encontrar alterações no XML):

    • Números de seção/cabeçalho (ex.: "Seção 3.2", "Artigo IV")
    • Identificadores de parágrafo se numerados
    • Padrões grep com texto circundante único
    • Estrutura do documento (ex.: "primeiro parágrafo", "bloco de assinatura")
    • NÃO use números de linha do markdown - eles não correspondem à estrutura XML

    Organização em lotes (agrupe 3-10 alterações relacionadas por lote):

    • Por seção: "Lote 1: Emendas da Seção 2", "Lote 2: Atualizações da Seção 5"
    • Por tipo: "Lote 1: Correções de datas", "Lote 2: Alterações de nomes das partes"
    • Por complexidade: Comece com substituições de texto simples, depois aborde alterações estruturais complexas
    • Sequencial: "Lote 1: Páginas 1-3", "Lote 2: Páginas 4-6"
  3. Ler documentação e descompactar:

    • OBRIGATÓRIO - LEIA O ARQUIVO INTEIRO: Leia ooxml.md (~600 linhas) completamente do início ao fim. NUNCA defina limites de alcance ao ler este arquivo. Preste atenção especial às seções "Document Library" e "Tracked Change Patterns".
    • Descompacte o documento: python ooxml/scripts/unpack.py <arquivo.docx> <dir>
    • Anote o RSID sugerido: O script de descompactação sugerirá um RSID para usar em suas alterações controladas. Copie este RSID para uso na etapa 4b.
  4. Implementar alterações em lotes: Agrupe as alterações logicamente (por seção, por tipo ou por proximidade) e implemente-as juntas em um único script. Esta abordagem:

    • Facilita a depuração (lote menor = mais fácil isolar erros)
    • Permite progresso incremental
    • Mantém a eficiência (tamanho de lote de 3-10 alterações funciona bem)

    Agrupamentos de lote sugeridos:

    • Por seção do documento (ex.: "Alterações na Seção 3", "Definições", "Cláusula de rescisão")
    • Por tipo de alteração (ex.: "Alterações de datas", "Atualizações de nomes das partes", "Substituições de termos legais")
    • Por proximidade (ex.: "Alterações nas páginas 1-3", "Alterações na primeira metade do documento")

    Para cada lote de alterações relacionadas:

    a. Mapear texto para XML: Use grep no word/document.xml para verificar como o texto está dividido entre elementos <w:r>.

    b. Criar e executar script: Use get_node para encontrar nós, implemente as alterações e depois doc.save(). Consulte a seção "Document Library" em ooxml.md para padrões.

    Nota: Sempre execute grep no word/document.xml imediatamente antes de escrever um script para obter os números de linha atuais e verificar o conteúdo do texto. Os números de linha mudam após cada execução do script.

  5. Empacotar o documento: Após todos os lotes estarem concluídos, converta o diretório descompactado de volta para .docx:

    python ooxml/scripts/pack.py descompactado documento-revisado.docx
    
  6. Verificação final: Faça uma verificação abrangente do documento completo:

    • Converta o documento final para markdown:
      pandoc --track-changes=all documento-revisado.docx -o verificacao.md
      
    • Verifique se TODAS as alterações foram aplicadas corretamente:
      grep "frase original" verificacao.md  # NÃO deve encontrá-la
      grep "frase substituta" verificacao.md  # Deve encontrá-la
      
    • Verifique se nenhuma alteração não intencional foi introduzida

Convertendo Documentos para Imagens

Para analisar visualmente documentos Word, converta-os para imagens usando um processo de duas etapas:

  1. Converter DOCX para PDF:

    soffice --headless --convert-to pdf documento.docx
    
  2. Converter páginas PDF para imagens JPEG:

    pdftoppm -jpeg -r 150 documento.pdf pagina
    

    Isso cria arquivos como pagina-1.jpg, pagina-2.jpg, etc.

Opções:

  • -r 150: Define resolução para 150 DPI (ajuste para equilíbrio entre qualidade e tamanho)
  • -jpeg: Saída em formato JPEG (use -png para PNG, se preferir)
  • -f N: Primeira página a converter (ex.: -f 2 começa da página 2)
  • -l N: Última página a converter (ex.: -l 5 para na página 5)
  • pagina: Prefixo para arquivos de saída

Exemplo para intervalo específico:

pdftoppm -jpeg -r 150 -f 2 -l 5 documento.pdf pagina  # Converte apenas as páginas 2-5

Diretrizes de Estilo de Código

IMPORTANTE: Ao gerar código para operações DOCX:

  • Escreva código conciso
  • Evite nomes de variáveis verbosos e operações redundantes
  • Evite comandos print desnecessários

Dependências

Dependências necessárias (instale se não estiverem disponíveis):

  • pandoc: sudo apt-get install pandoc (para extração de texto)
  • docx: npm install -g docx (para criar novos documentos)
  • LibreOffice: sudo apt-get install libreoffice (para conversão para PDF)
  • Poppler: sudo apt-get install poppler-utils (para pdftoppm converter PDF para imagens)
  • defusedxml: pip install defusedxml (para análise XML segura)

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

David-Li0406/meta-skill-evloving

Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.

David-Li0406/meta-skill-evloving

Create technical diagrams using Mermaid syntax for architecture, sequences, ERDs, flowcharts, and state machines. Use for visualizing system design, data flows, and processes. Triggers: diagram, mermaid, architecture diagram, sequence diagram, flowchart, ERD, entity relationship, state diagram, C4 model, component diagram, visualize, draw.

David-Li0406/meta-skill-evloving

Complete color manipulation and green screen effects system. PROACTIVELY activate for: (1) Green screen/chromakey removal, (2) Color grading with LUTs, (3) Color correction (levels, curves, white balance), (4) Colorkey/color removal effects, (5) Hue/saturation manipulation, (6) Color space conversions (BT.709, BT.2020, HDR), (7) Color isolation effects, (8) Teal and orange look, (9) Vintage/film looks, (10) Color keying for transparency. Provides: chromakey and colorkey filters, LUT application (lut3d), curves and levels adjustment, color balance, selective color manipulation, color space handling, HDR tone mapping, professional color grading chains.

David-Li0406/meta-skill-evloving

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

David-Li0406/meta-skill-evloving

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

David-Li0406/meta-skill-evloving

Build with OpenAI's stateless APIs - Chat Completions (GPT-5, GPT-4o), Embeddings, Images (DALL-E 3), Audio (Whisper + TTS), and Moderation. Includes Node.js SDK and fetch-based approaches for Cloudflare Workers. Use when: implementing chat completions with GPT-5/GPT-4o, streaming responses with SSE, using function calling/tools, creating structured outputs with JSON schemas, generating embeddings for RAG (text-embedding-3-small/large), generating images with DALL-E 3, editing images with GPT-Image-1, transcribing audio with Whisper, synthesizing speech with TTS (11 voices), moderating content (11 safety categories), or troubleshooting rate limits (429), invalid API keys (401), function calling failures, streaming parse errors, embeddings dimension mismatches, or token limit exceeded.

David-Li0406/meta-skill-evloving

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

David-Li0406/meta-skill-evloving

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

David-Li0406/meta-skill-evloving

Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas

David-Li0406/meta-skill-evloving

Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.

David-Li0406/meta-skill-evloving

Best practices for Remotion - Video creation in React

David-Li0406/meta-skill-evloving

Provides bidirectional translation (Chinese/English), grammar checking, and sentence polishing. Supports specific tense constraints, context-aware tone adjustment, and natural expression optimization. Outputs direct text without formatting.

David-Li0406/meta-skill-evloving

指导如何通过自定义注解(如@Unicom)标识Dubbo接口,利用BeanDefinitionRegistryPostProcessor在启动时扫描并动态注册ReferenceBean,实现RPC调用的封装。

David-Li0406/meta-skill-evloving

生成Python脚本,利用FFmpeg将图片序列按3x3布局合并,或将合并图拆分。要求使用subprocess模块执行命令,并支持用户交互式输入路径。

David-Li0406/meta-skill-evloving

SOP for extracting and analyzing promotional activity details, handling time formatting, location mapping, payment logic, and step-by-step process validation.

David-Li0406/meta-skill-evloving

Specializes in creating TikTok short video scripts using an anthropomorphic 'Chef' perspective to explain wildlife food chains and survival environments, utilizing real field footage.

David-Li0406/meta-skill-evloving

针对TikTok平台,以拟人化视角(如动物作为厨师)创作系列短视频脚本。重点介绍野生动物、食物链及生态环境,要求使用野外实拍素材,风格幽默且具有教育意义。

David-Li0406/meta-skill-evloving

Generates KWL (Know, Want to know, Learned) charts for educational videos, specifically BrainPOP, using simple 7th-grade language and short, concise bullet points.

David-Li0406/meta-skill-evloving

Develops DAX measures to calculate promo and regular volumes and generates a calculated table of dates excluding continuous promo date ranges, handling multiple periods and nulls.

David-Li0406/meta-skill-evloving

Tracks complex, multi-session work using the Beads issue tracker and dependency graphs, and provides persistent memory that survives conversation compaction. Use when work spans multiple sessions, has complex dependencies, or needs persistent context across compaction cycles. Trigger with phrases like "create task for", "what's ready to work on", "show task", "track this work", "what's blocking", or "update status".

Habilidades Relacionadas