Guia de leitura localizado
xlsxFinalidade, utilização e fonte
Use esta habilidade sempre que uma planilha for a principal entrada ou saída. Isso significa qualquer tarefa em que o usuário queira: abrir, ler, editar ou corrigir um arquivo .xlsx, .xlsm, .xltx, .csv ou .tsv existente (por exemplo, adicionar colunas, calcular fórmulas, formatar, criar gráficos, limpar dados desorganizados); criar uma nova planilha do zero ou a partir de outras fontes de dados; ou converter entre formatos de arquivo tabular. Acione esta habilidade especialmente quando o usuário referenciar uma planilha pelo nome ou caminho — mesmo que casualmente (como "o arquivo xlsx nos meus downloads") — e desejar que algo seja feito com ela ou gerado a partir dela. Acione também para limpar ou reestruturar arquivos de dados tabulares desorganizados (linhas malformadas, cabeçalhos fora do lugar, dados inválidos) em planilhas adequadas. O resultado final deve ser uma planilha. NÃO acione esta habilidade quando o resultado final principal for um documento do Word, um relatório HTML, um script Python independente, um pipeline de banco de dados ou uma integração com a API do Google Sheets, mesmo que envolva dados tabulares.
Fonte recuperada:
- Repositório de origem
- anthropics/skills
- SKILL.md
skills/xlsx/SKILL.md- Estrelas do repositório
- 185,373
- Atualização do repositório
- 2026-10-29
- Classificação de Habilidades
- Dados
- Última coleta
Licença: Arquivo de licença pendente de verificação
Os trechos do fluxo de trabalho são auxiliares de leitura e não instruções executáveis do Codez. Nenhuma Skill de terceiros foi executada para gerar esta página.
Os trechos abaixo, que descrevem o propósito e o fluxo de trabalho, são material original, organizado e traduzido para facilitar a leitura. Eles são distintos da análise editorial da Codez, que possui uma etiqueta separada.
O que esta habilidade faz
Use esta habilidade sempre que uma planilha for a principal entrada ou saída. Isso significa qualquer tarefa em que o usuário queira: abrir, ler, editar ou corrigir um arquivo .xlsx, .xlsm, .xltx, .csv ou .tsv existente (por exemplo, adicionar colunas, calcular fórmulas, formatar, criar gráficos, limpar dados desorganizados); criar uma nova planilha do zero ou a partir de outras fontes de dados; ou converter entre formatos de arquivo tabular. Acione esta habilidade especialmente quando o usuário referenciar uma planilha pelo nome ou caminho — mesmo que casualmente (como "o arquivo xlsx nos meus downloads") — e desejar que algo seja feito com ela ou gerado a partir dela. Acione também para limpar ou reestruturar arquivos de dados tabulares desorganizados (linhas malformadas, cabeçalhos fora do lugar, dados inválidos) em planilhas adequadas. O resultado final deve ser uma planilha. NÃO acione esta habilidade quando o resultado final principal for um documento do Word, um relatório HTML, um script Python independente, um pipeline de banco de dados ou uma integração com a API do Google Sheets, mesmo que envolva dados tabulares.
Como funciona o fluxo de trabalho upstream
Criação, edição e análise de arquivos XLSX.
>openpyxl,pandas, emarkitdownestão pré-instalados — não executepip installPrimeiro, escreva o script e importe-o diretamente. Somente se uma importação falhar (ou omarkitdowncomando ausente):pip installo pacote ausente. > Os caminhos dos scripts abaixo são relativos ao diretório desta habilidade.
Escolher fórmulas que resistam à verificação.
O LibreOffice implementa menos funções que o Excel, e uma função que ele não consegue avaliar se torna um literal.#NAME?Incorporado ao arquivo que você enviar. Preferencialmente em Excel.2007-funções da era —SUMIFS,INDEX,MATCH,IFERROR,SUMPRODUCT— que não precisam de prefixo.
pegadinhas do openpyxl
A leitura de um modelo requer duas cargas.data_only=TrueO método cache retorna valores em cache sem as fórmulas; o método padrão retorna strings de fórmulas sem valores. Uma única execução não pode fornecer ambos.data_only=TrueSalvar o arquivo é destrutivo. Como a planilha não contém mais fórmulas, salvar substitui todas elas por valores literais — permanentemente.
python scripts/recalc.py output.xlsx [timeout_seconds] # default 30Requisitos e configuração
Requisitos para cada saída
Fontes profissionais (Arial, Times New Roman) em todo o texto, a menos que o usuário especifique o contrário. Sem erros de fórmula. Nunca envie enquantorecalc.pyrelatórioserrors_foundSe você acha que um erro é anterior à sua atuação, prove: carregue o *original* comdata_only=TrueE observe aquela célula. Um erro que você introduziu é exatamente igual a um que você herdou.
Dependências
openpyxl,pandas,markitdown(pip, pré-instalado — instalar somente se uma importação falhar ou se o comando estiver faltando) · LibreOffice (soffice, configurado automaticamente para ambientes isolados viascripts/office/soffice.py)
Limites e verificações de qualidade
Recalcular (obrigatório sempre que o arquivo contiver fórmulas)
O openpyxl grava fórmulas como strings sem valores em cache. Até que você recalcule, cada célula da fórmula será lida como tal.Nonepara qualquer coisa que leia valores em cache —pandas,load_workbook(data_only=True)e a maioria dos visualizadores. O LibreOffice calcula todas as fórmulas, o arquivo é reescrito no local e você obtém o formato JSON:status(success|errors_found),total_formulas,total_errorse umerror_summarynomeando até100células por tipo de erro (locations_truncateddiz quantos reteve — confiançatotal_errors(não o comprimento da lista). Corrija o nome e execute novamente. JSON com umerrorchave em vez de umastatusSignifica que nada foi recalculado e somente esse caso resulta em um valor diferente de zero.errors_foundsaídas0Portanto, nunca trate uma saída limpa como uma planilha limpa.
Comece com um teste seguro.
- Verifique o host compatível e as instruções de instalação do repositório. Mantenha o diretório Skill e seus scripts, recursos e documentação referenciados juntos;SKILL.mdsozinho pode omitir dependências.
- Forneça ao agente suas entradas reais, a saída desejada e os critérios de aceitação. A sintaxe de invocação e as ferramentas disponíveis dependem do host; este site não pressupõe um comando de instalação universal.
- Teste o fluxo de trabalho original em um projeto descartável ou em uma cópia. Analise as operações que alteram arquivos, serviços remotos ou recursos faturáveis antes de permiti-las.
- Valide o resultado comparando-o com as verificações de qualidade da fonte e com seus próprios requisitos. Um gatilho bem-sucedido ou uma alta contagem de estrelas no repositório não garantem um resultado correto.
Leia mais na fonte.
Habilidades relacionadas
Tradução e escopo
Este guia de leitura seleciona trechos do texto fixado a montante.SKILL.mdA tradução foi feita com auxílio de ferramentas. Este não é um manual completo nem garante compatibilidade comprovada. Leia o original e os arquivos referenciados antes de usar.
Esta introdução refere-se à versão fixada abaixo; a atividade atual do repositório e o tempo de coleta são mostrados separadamente.
- Fonte fixada
- Leia o original ↗
- Fonte recuperada
- Commit de origem
ca45fc496a3436251f191354091d557da31c15b5- Fonte SHA-256
6712b39718fe815054abca9c3ee72f989613e6f771c8a5c58f30a65a6c905622