Communitygithub.com

bg-szy/TOP-SKILLS

Use esta habilidade sempre que um arquivo de planilha for a entrada ou saída principal. Isso significa qualquer tarefa onde o usuário queira: abrir, ler, editar ou corrigir um arquivo .xlsx, .xlsm, .xltx, .csv ou .tsv existente (ex.: adicionar colunas, calcular fórmulas, formatar, criar gráficos, limpar dados bagunçados); criar uma nova planilha do zero ou a partir de outras fontes de dados; ou converter entre formatos de arquivos tabulares. Acione especialmente quando o usuário mencionar um arquivo de planilha pelo nome ou caminho — mesmo casualmente (como "o xlsx nos meus downloads") — e quiser que algo seja feito nele ou produzido a partir dele. Também acione para limpar ou reestruturar arquivos de dados tabulares bagunçados (linhas malformadas, cabeçalhos deslocados, dados inúteis) em planilhas adequadas. A entrega deve ser um arquivo de planilha. NÃO acione quando a entrega principal for um documento Word, relatório HTML, script Python autônomo, pipeline de banco de dados ou integração com a API do Google Sheets, mesmo que dados tabulares estejam envolvidos.

O que é TOP-SKILLS?

Esta habilidade é especializada na criação, edição e análise de arquivos de planilha (XLSX, XLSM, CSV, TSV) usando Python, com foco em geração de fórmulas, formatação profissional e recálculo confiável. Ela utiliza bibliotecas pré-instaladas como openpyxl, pandas e markitdown, evitando a necessidade de instalação manual, a menos que uma importação falhe. O processo inclui etapas obrigatórias de recálculo via LibreOffice para garantir que todas as fórmulas sejam avaliadas corretamente, além de documentar armadilhas comuns do openpyxl, como células mescladas, perda de macros e como lidar com referências externas que podem quebrar. A habilidade também fornece diretrizes detalhadas para modelos financeiros, incluindo codificação de cores, formatação de números e estruturação de suposições. É particularmente útil para desenvolvedores e analistas que precisam automatizar a criação de planilhas complexas sem erros de fórmula, garantindo que o arquivo final funcione tanto no Excel quanto no LibreOffice.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/skills/xlsx

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 XLSX

TarefaAbordagem
Criar ou editar com fórmulas/formataçãoopenpyxl — veja as armadilhas abaixo
Dados em massa entrada/saídapandas (read_excel, to_excel)
Olhada rápida em uma planilhamarkitdown arquivo.xlsx — ## NomeDaPlanilha por planilha; também lê .xlsm. Sem coordenadas de célula, portanto não planeje edições a partir dele
Ler um modelo (fórmulas e valores)duas passadas de load_workbook — veja as armadilhas

openpyxl, pandas e markitdown estão pré-instalados — não execute pip install primeiro; escreva o script e importe diretamente. Somente se uma importação falhar (ou o comando markitdown estiver faltando): pip install o pacote ausente.

Os caminhos dos scripts abaixo são relativos ao diretório desta habilidade.

Requisitos para toda saída

  • Fonte profissional (Arial, Times New Roman) em todo o documento, a menos que o usuário diga o contrário.
  • Zero erros de fórmula. Nunca entregue enquanto recalc.py relatar errors_found. Se você acha que um erro é anterior a você, prove: carregue o original com data_only=True e olhe para aquela célula. Um erro que você introduziu parece exatamente igual a um que você herdou.
  • Use fórmulas, nunca resultados fixos. Escreva sheet['B10'] = '=SUM(B2:B9)', não o total calculado em Python. A planilha deve recalcular quando suas entradas mudarem.
  • Siga a especificação do usuário literalmente. Nomes de guias exatos, cabeçalhos de coluna exatos e a fórmula que ele detalhou. Um redesign que calcula outra coisa falha, por mais elegante que seja.
  • Documente toda suposição e número fixo onde o leitor possa vê-lo — um comentário de célula, ou uma célula adjacente no final de uma tabela. Cite uma fonte real quando existir (Fonte: Formulário 10-K da Empresa, AF2024, Página 45, Nota de Receita, [URL SEC EDGAR]); quando o número veio do usuário, diga isso claramente.
  • Uma pasta de trabalho criada por você para alguém preencher precisa de uma breve legenda nomeando quais células editar, e uma linha de exemplo com valores realistas mostrando o formato esperado. Nunca adicione essa linha a um arquivo que você foi solicitado a editar.
  • Editando um arquivo existente: siga suas convenções exatamente. Elas substituem todas as diretrizes aqui. Encontre primeiro suas células de entrada designadas — uma cor de fonte, preenchimento ou sombreamento distinto as marca — escreva apenas lá, e deixe toda fórmula existente intacta.

Recalcular (obrigatório sempre que o arquivo contiver fórmulas)

openpyxl escreve fórmulas como strings sem valores em cache. Até você recalcular, toda célula de fórmula é lida como None para qualquer coisa que leia valores em cache — pandas, load_workbook(data_only=True) e a maioria dos visualizadores.

python scripts/recalc.py saida.xlsx [tempo_limite_segundos]   # padrão 30

O LibreOffice calcula cada fórmula, o arquivo é reescrito no lugar, e você recebe JSON: status (success | errors_found), total_formulas, total_errors e um error_summary nomeando até 100 células por tipo de erro (locations_truncated informa quantas ele ocultou — confie em total_errors, não no comprimento da lista). Corrija o que ele nomeia e execute novamente. JSON com uma chave error em vez de status significa que nada foi recalculado, e apenas esse caso sai com código diferente de zero — errors_found sai com 0, portanto nunca trate uma saída limpa como uma pasta de trabalho limpa.

Um recálculo verde prova que suas fórmulas avaliam, não que estão corretas. Um intervalo deslocado por um ou uma referência à linha errada produz um arquivo limpo, sem erros, com números errados. Escreva 2–3 fórmulas primeiro e verifique se elas trazem os valores esperados, antes de construir uma grade.

Uma pasta de trabalho que vincula a outro arquivo perde esses links se você a salvar novamente com openpyxl e depois recalcular. Tal fórmula lê ='[1]Análise de Retornos'!$B$2 — o [1] é um índice na lista de referências externas da pasta de trabalho, nomeando um arquivo separado no disco, não uma planilha. Esse arquivo raramente está presente aqui, então o valor em cache da célula é a única coisa que mantém seus dados. openpyxl remove esse valor ao salvar; o LibreOffice então precisa resolver a referência de verdade, falha, escreve #NAME? e deleta todos os links. recalc.py se recusa a executar nesse estado — copie os valores dessas células do original antes de salvar por cima (--force substitui, e aceita a perda).

Escolhendo fórmulas que sobrevivem à verificação

O LibreOffice implementa menos funções que o Excel, e uma que ele não consegue avaliar se torna um literal #NAME? gravado no arquivo que você entrega.

  • Prefira funções da era Excel-2007 — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — que não precisam de prefixo.
  • Seis funções pós-2007 funcionam, mas apenas com um prefixo _xlfn. , porque o openpyxl escreve sua fórmula no XML literalmente e o Excel armazena nomes pós-2007 prefixados (sua IU oculta o prefixo): _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. Escritas sem prefixo, cada uma gera #NAME?.
  • Nunca use XLOOKUP, XMATCH, SORT, FILTER, UNIQUE ou SEQUENCE. O LibreOffice do runtime não consegue avaliá-las sob nenhum prefixo. Versões mais novas as avaliam, mas são funções de matriz com dispersão e um arquivo escrito pelo openpyxl não tem metadados de dispersão, então apenas a célula superior esquerda do intervalo recebe um valor — e recalc.py relata total_errors: 0 no resultado truncado. Use INDEX/MATCH para buscas, e classifique, filtre e remova duplicatas em Python antes de escrever as células.
  • Uma fórmula que o LibreOffice não conseguiu analisar é escrita de volta em minúsculas — um sinal rápido ao lado de um #NAME?.

Armadilhas do openpyxl

  • Ler um modelo requer duas cargas. data_only=True produz valores em cache com as fórmulas removidas; o padrão produz strings de fórmula sem valores. Uma única passada não pode fornecer ambos.
  • data_only=True é destrutivo se você salvar. Essa pasta de trabalho não tem mais fórmulas, então salvar substitui cada uma por um literal — permanentemente.
  • data_only=True em um arquivo que o openpyxl acabou de escrever retorna None em todo lugar — execute recalc.py primeiro. (Uma fórmula cujo resultado é "" também é lida como None.)
  • Células mescladas: escreva apenas a âncora superior esquerda. Todas as outras células no intervalo são MergedCell cujo .value é somente leitura.
  • .xlsm perde suas macros a menos que você passe keep_vba=True para load_workbook.
  • Um nome de planilha contendo espaço deve ser entre aspas em uma referência entre planilhas: ='Entradas de Suposições'!$B$5. Sem aspas, avalia para #VALOR!.

Modelos financeiros

A menos que o usuário diga o contrário, ou o arquivo existente já faça outra coisa.

Cor: texto azul (0,0,255) para entradas fixas e alavancas de cenário · preto para fórmulas · verde (0,128,0) para links para outra planilha · vermelho (255,0,0) para links para outro arquivo · preenchimento amarelo (255,255,0) para suposições principais e células que o usuário deve preencher.

Números: moeda $#,##0, com a unidade nomeada no cabeçalho (Receita ($mm)) · zeros renderizam como -, inclusive em porcentagens ($#,##0;($#,##0);-) · negativos entre parênteses · porcentagens 0.0%, armazenadas como frações (0.15 renderiza 15.0%; armazenar 15 renderiza 1500.0%) · múltiplos de avaliação 0.0x · anos como texto ("2024", nunca 2,024).

Estrutura: toda suposição em sua própria célula nomeada, referenciada pelas fórmulas que a usam (=B5*(1+$B$6), nunca =B5*1.05) · fórmulas consistentes em todo período de projeção, pois uma célula editada isolada no meio de uma linha é o erro silencioso mais comum · proteger denominadores que podem ser zero.

Dependências

openpyxl, pandas, markitdown (pip, pré-instalados — instale apenas se uma importação falhar ou o comando estiver faltando) · LibreOffice (soffice, configurado automaticamente para ambientes isolados via scripts/office/soffice.py)

Individual skills in this repo

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

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

Habilidades Relacionadas