Communitygithub.com

bg-szy/TOP-SKILLS

Utilisez cette compétence chaque fois qu'un fichier de feuille de calcul est l'entrée ou la sortie principale, que ce soit pour créer, lire, éditer, nettoyer ou convertir des fichiers .xlsx, .xlsm, .xltx, .csv ou .tsv.

Qu'est-ce que TOP-SKILLS ?

Cette compétence est conçue pour tous les scénarios où une feuille de calcul est au cœur de la tâche : création, édition, formatage, nettoyage de données, conversion entre formats tabulaires ou analyse de modèles existants. Elle repose sur les bibliothèques Python préinstallées `openpyxl`, `pandas` et l'outil `markitdown` pour la lecture rapide, et nécessite LibreOffice pour le recalcul des formules. La compétence impose des normes professionnelles strictes : police cohérente, zéro erreur de formule, utilisation systématique de formules plutôt que de valeurs codées en dur, et respect minutieux des spécifications utilisateur. Elle inclut également des directives pour les modèles financiers (codage couleur, formatage des nombres) et des mises en garde détaillées sur les pièges d'openpyxl (cellules fusionnées, macros dans .xlsm, références externes). Le pipeline de travail typique consiste à générer un script Python, exécuter `recalc.py` pour valider les formules, et livrer un fichier .xlsx professionnel et sans erreur. Cette compétence fonctionne sur toutes les plateformes supportant Python et LibreOffice, en particulier Claude Code, Cursor et Codex.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Création, édition et analyse XLSX

TâcheApproche
Créer ou éditer avec formules/mise en formeopenpyxl — voir les pièges ci-dessous
Données en vrac entrée ou sortiepandas (read_excel, to_excel)
Aperçu rapide d'une feuillemarkitdown fichier.xlsx — ## NomFeuille par feuille ; lit aussi .xlsm. Pas de coordonnées de cellules, donc ne planifiez pas d'éditions à partir de celui-ci
Lire un modèle (formules et valeurs)deux passes load_workbook — voir les pièges

openpyxl, pandas et markitdown sont préinstallés — n'exécutez pas pip install d'abord ; écrivez le script et importez directement. Uniquement si une importation échoue (ou si la commande markitdown est manquante) : pip install le paquet manquant.

Les chemins de scripts ci-dessous sont relatifs au répertoire de cette compétence.

Exigences pour chaque sortie

  • Police professionnelle (Arial, Times New Roman) partout, sauf indication contraire de l'utilisateur.
  • Zéro erreur de formule. Ne livrez jamais tant que recalc.py signale errors_found. Si vous pensez qu'une erreur vous préexistait, prouvez-le : chargez l'original avec data_only=True et examinez cette cellule. Une erreur que vous avez introduite ressemble exactement à une erreur héritée.
  • Utilisez des formules, jamais de résultats codés en dur. Écrivez sheet['B10'] = '=SUM(B2:B9)', pas le total calculé par Python. La feuille doit se recalculer lorsque ses entrées changent.
  • Suivez les spécifications de l'utilisateur à la lettre. Noms d'onglets exacts, en-têtes de colonnes exacts, et la formule qu'il/elle a explicitée. Une refonte qui calcule autre chose échoue, aussi élégante soit-elle.
  • Documentez chaque hypothèse et nombre codé en dur là où le lecteur le verra — un commentaire de cellule, ou une cellule adjacente en fin de tableau. Citez une source réelle lorsqu'elle existe (Source : Company 10-K, FY2024, Page 45, Note sur les Revenus, [URL SEC EDGAR]) ; lorsque le nombre provient de l'utilisateur, dites-le clairement.
  • Un classeur que vous créez pour que quelqu'un le remplisse nécessite une courte légende nommant les cellules à éditer, et une ligne d'exemple avec des valeurs réalistes montrant le format attendu. N'ajoutez jamais une telle ligne à un fichier que l'on vous a demandé d'éditer.
  • Édition d'un fichier existant : respectez ses conventions exactement. Elles remplacent toutes les directives ici. Trouvez d'abord ses cellules d'entrée désignées — une couleur de police, un remplissage ou une trame distinctifs les marquent — écrivez uniquement là, et ne touchez à aucune formule existante.

Recalculer (obligatoire chaque fois que le fichier contient des formules)

openpyxl écrit les formules sous forme de chaînes sans valeurs mises en cache. Jusqu'à ce que vous recalculiez, chaque cellule de formule se relit comme None pour tout ce qui lit les valeurs en cache — pandas, load_workbook(data_only=True) et la plupart des visionneuses.

python scripts/recalc.py sortie.xlsx [temps_limite_secondes]   # défaut 30

LibreOffice calcule chaque formule, le fichier est réécrit sur place, et vous obtenez du JSON : status (success | errors_found), total_formulas, total_errors, et un error_summary nommant jusqu'à 100 cellules par type d'erreur (locations_truncated dit combien il a retenues — faites confiance à total_errors, pas à la longueur de la liste). Corrigez ce qu'il nomme et relancez-le. JSON avec une clé error au lieu d'un status signifie que rien n'a été recalculé, et seulement ce cas-là se termine avec un code non nul — errors_found se termine avec 0, donc ne traitez jamais un code de sortie propre comme un classeur propre.

Un recalcul vert prouve que vos formules s'évaluent, pas qu'elles sont correctes. Une plage décalée d'une ligne ou une référence à la mauvaise ligne produit un fichier propre et sans erreur avec des nombres erronés. Écrivez 2-3 formules d'abord et vérifiez qu'elles tirent les valeurs attendues, avant de construire une grille.

Un classeur qui pointe vers un autre fichier perd ces liens si vous le réenregistrez avec openpyxl et ensuite recalculez. Une telle formule lit ='[1]Retour Sur Analyse'!$B$2 — le [1] est un index dans la liste des références externes du classeur, nommant un fichier séparé sur le disque, pas une feuille. Ce fichier est rarement présent ici, donc la valeur en cache de la cellule est la seule chose qui retient ses données. openpyxl supprime cette valeur lors de l'enregistrement ; LibreOffice doit alors résoudre la référence pour de vrai, échoue, écrit #NAME? et supprime tous les liens. recalc.py refuse de s'exécuter dans cet état — copiez les valeurs de ces cellules hors de l'original avant de sauvegarder par-dessus (--force le remplace et accepte la perte).

Choisir des formules qui survivent à la vérification

LibreOffice implémente moins de fonctions qu'Excel, et celle qu'il ne peut pas évaluer devient un littéral #NAME? cuit dans le fichier que vous livrez.

  • Privilégiez les fonctions de l'ère Excel 2007 — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — qui n'ont besoin d'aucun préfixe.
  • Six fonctions post-2007 fonctionnent, mais seulement avec un préfixe _xlfn. , car openpyxl écrit votre formule textuellement dans le XML et Excel stocke les noms post-2007 préfixés (son interface cache le préfixe) : _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. Écrites nues, chacune produit #NAME?.
  • N'utilisez jamais XLOOKUP, XMATCH, SORT, FILTER, UNIQUE ou SEQUENCE. Le moteur d'exécution de LibreOffice ne peut pas les évaluer sous aucun préfixe. Les versions plus récentes les évaluent, mais ce sont des fonctions de tableau débordantes et un fichier écrit par openpyxl n'a pas de métadonnées de débordement, donc seule la cellule en haut à gauche de la plage obtient une valeur — et recalc.py signale total_errors: 0 sur le résultat tronqué. Utilisez INDEX/MATCH pour les recherches, et triez, filtrez et dédupliquez en Python avant d'écrire les cellules.
  • Une formule que LibreOffice n'a pas pu analyser est réécrite en minuscules — un indicateur rapide à côté d'un #NAME?.

Pièges d'openpyxl

  • Lire un modèle nécessite deux chargements. data_only=True donne les valeurs en cache avec les formules disparues ; la valeur par défaut donne les chaînes de formules sans valeurs. Un seul passage ne peut pas fournir les deux.
  • data_only=True est destructeur si vous enregistrez. Ce classeur n'a plus de formules, donc l'enregistrement remplace chacune par un littéral — définitivement.
  • data_only=True sur un fichier qu'openpyxl vient d'écrire renvoie None partout — exécutez recalc.py d'abord. (Une formule dont le résultat est "" se relit aussi comme None.)
  • Cellules fusionnées : écrivez uniquement l'ancre en haut à gauche. Chaque autre cellule dans la plage est un MergedCell dont .value est en lecture seule.
  • .xlsm perd ses macros sauf si vous passez keep_vba=True à load_workbook.
  • Un nom de feuille contenant un espace doit être cité dans une référence inter-feuille : ='Hypothèses Entrées'!$B$5. Sans guillemets, elle s'évalue en #VALUE!.

Modèles financiers

Sauf indication contraire de l'utilisateur, ou si le fichier existant fait déjà autre chose.

Couleur : texte bleu (0,0,255) pour les entrées codées en dur et les leviers de scénario · noir pour les formules · vert (0,128,0) pour les liens vers une autre feuille · rouge (255,0,0) pour les liens vers un autre fichier · remplissage jaune (255,255,0) pour les hypothèses clés et les cellules que l'utilisateur doit remplir.

Nombres : devise $#,##0, avec l'unité nommée dans l'en-tête (Revenus ($mm)) · les zéros s'affichent comme -, y compris dans les pourcentages ($#,##0;($#,##0);-) · négatifs entre parenthèses · pourcentages 0.0%, stockés sous forme de fractions (0.15 affiche 15.0% ; stocker 15 affiche 1500.0%) · multiples de valorisation 0.0x · années sous forme de texte ("2024", jamais 2 024).

Structure : chaque hypothèse dans sa propre cellule étiquetée, référencée par les formules qui l'utilisent (=B5*(1+$B$6), jamais =B5*1.05) · formules cohérentes sur chaque période de projection, car une seule cellule éditée au milieu d'une ligne est l'erreur silencieuse la plus courante · protégez les dénominateurs qui peuvent être nuls.

Dépendances

openpyxl, pandas, markitdown (pip, préinstallés — installez seulement si une importation échoue ou si la commande est manquante) · LibreOffice (soffice, auto-configuré pour les environnements sandboxés 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.

Skills associés