Communitygithub.com

David-Li0406/meta-skill-evloving

Creación, edición y análisis completo de hojas de cálculo con soporte para fórmulas, formato, análisis de datos y visualización. Para cuando Claude necesite trabajar con hojas de cálculo (.xlsx, .xlsm, .csv, .tsv, etc.) creando nuevas con fórmulas y formato, leyendo o analizando datos, modificando existentes preservando fórmulas, realizando análisis y visualización, o recalculando fórmulas.

¿Qué es meta-skill-evloving?

Este skill especializa a Claude en el manejo de hojas de cálculo de Excel, proporcionando un conjunto completo de herramientas y prácticas para crear, modificar y analizar archivos .xlsx, .xlsm, .csv y .tsv. Está diseñado para desarrolladores y analistas que necesitan automatizar tareas de hoja de cálculo con inteligencia artificial, garantizando que los resultados sean dinámicos y libres de errores. El skill se apoya en bibliotecas de Python como `openpyxl` para manejar fórmulas y formato avanzado, y `pandas` para análisis y manipulación de datos, y requiere el uso de LibreOffice para recalcular fórmulas. Incluye estándares rigurosos, como la codificación de colores para modelos financieros (azul para entradas, negro para fórmulas, etc.), formato de números con reglas precisas (moneda, porcentajes, ceros como guiones), y una verificación exhaustiva de errores como #REF!, #DIV/0! y #VALOR!. El workflow principal sugiere usar `openpyxl` para crear o editar archivos, recalcular con un script `recalc.py`, y verificar errores, evitando siempre valores calculados en Python en favor de fórmulas de Excel para mantener la hoja dinámica y actualizable.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Requisitos para las Salidas

Todos los archivos Excel

Cero errores de fórmula

  • Cada modelo de Excel DEBE entregarse con CERO errores de fórmula (#REF!, #DIV/0!, #VALOR!, #N/A, #¿NOMBRE?)

Preservar plantillas existentes (al actualizar plantillas)

  • Estudiar y COINCIDIR EXACTAMENTE con el formato, estilo y convenciones existentes al modificar archivos
  • Nunca imponer formato estandarizado en archivos con patrones establecidos
  • Las convenciones de la plantilla existente SIEMPRE anulan estas pautas

Modelos Financieros

Estándares de Codificación de Colores

A menos que el usuario o la plantilla existente indiquen lo contrario

Convenciones de Color Estándar de la Industria

  • Texto azul (RGB: 0,0,255): Entradas codificadas manualmente y números que los usuarios cambiarán para escenarios
  • Texto negro (RGB: 0,0,0): TODAS las fórmulas y cálculos
  • Texto verde (RGB: 0,128,0): Enlaces que extraen datos de otras hojas dentro del mismo libro
  • Texto rojo (RGB: 255,0,0): Enlaces externos a otros archivos
  • Fondo amarillo (RGB: 255,255,0): Suposiciones clave que necesitan atención o celdas que deben actualizarse

Estándares de Formato de Números

Reglas de Formato Obligatorias

  • Años: Formatear como cadenas de texto (ej., "2024" no "2,024")
  • Moneda: Usar formato $#,##0; ESPECIFICAR SIEMPRE las unidades en los encabezados ("Ingresos ($mm)")
  • Ceros: Usar formato numérico para que todos los ceros aparezcan como "-", incluyendo porcentajes (ej., "$#,##0;($#,##0);-")
  • Porcentajes: Por defecto en formato 0.0% (un decimal)
  • Múltiplos: Formatear como 0.0x para múltiplos de valoración (EV/EBITDA, P/E)
  • Números negativos: Usar paréntesis (123) no signo menos -123

Reglas de Construcción de Fórmulas

Ubicación de Suposiciones

  • Colocar TODAS las suposiciones (tasas de crecimiento, márgenes, múltiplos, etc.) en celdas de suposición separadas
  • Usar referencias de celda en lugar de valores codificados en las fórmulas
  • Ejemplo: Usar =B5*(1+$B$6) en lugar de =B5*1.05

Prevención de Errores en Fórmulas

  • Verificar que todas las referencias de celda sean correctas
  • Revisar errores de desfase en rangos
  • Asegurar fórmulas consistentes en todos los períodos de proyección
  • Probar con casos extremos (valores cero, números negativos)
  • Verificar que no haya referencias circulares no intencionadas

Requisitos de Documentación para Valores Fijos

  • Comentar o escribir al lado de las celdas (si es al final de la tabla). Formato: "Fuente: [Sistema/Documento], [Fecha], [Referencia Específica], [URL si aplica]"
  • Ejemplos:
    • "Fuente: 10-K de la Compañía, FY2024, Página 45, Nota de Ingresos, [URL de SEC EDGAR]"
    • "Fuente: 10-Q de la Compañía, Q2 2025, Anexo 99.1, [URL de SEC EDGAR]"
    • "Fuente: Bloomberg Terminal, 15/08/2025, AAPL US Equity"
    • "Fuente: FactSet, 20/08/2025, Pantalla de Estimaciones de Consenso"

Creación, edición y análisis de XLSX

Resumen

Un usuario puede pedirte crear, editar o analizar el contenido de un archivo .xlsx. Tienes diferentes herramientas y flujos de trabajo disponibles para diferentes tareas.

Requisitos Importantes

LibreOffice Necesario para Recalcular Fórmulas: Puedes asumir que LibreOffice está instalado para recalcular valores de fórmulas usando el script recalc.py. El script configura automáticamente LibreOffice en la primera ejecución.

Leer y analizar datos

Análisis de datos con pandas

Para análisis de datos, visualización y operaciones básicas, usa pandas, que proporciona capacidades potentes de manipulación de datos:

import pandas as pd

# Leer Excel
df = pd.read_excel('file.xlsx')  # Predeterminado: primera hoja
todas_las_hojas = pd.read_excel('file.xlsx', sheet_name=None)  # Todas las hojas como diccionario

# Analizar
df.head()      # Vista previa de datos
df.info()      # Información de columnas
df.describe()  # Estadísticas

# Escribir Excel
df.to_excel('output.xlsx', index=False)

Flujo de Trabajo con Archivos Excel

CRÍTICO: Usar Fórmulas, No Valores Fijos

Usa siempre fórmulas de Excel en lugar de calcular valores en Python y fijarlos. Esto asegura que la hoja de cálculo siga siendo dinámica y actualizable.

❌ INCORRECTO - Fijar Valores Calculados

# Mal: Calcular en Python y fijar el resultado
total = df['Ventas'].sum()
hoja['B10'] = total  # Fija 5000

# Mal: Calcular tasa de crecimiento en Python
crecimiento = (df.iloc[-1]['Ingresos'] - df.iloc[0]['Ingresos']) / df.iloc[0]['Ingresos']
hoja['C5'] = crecimiento  # Fija 0.15

# Mal: Cálculo de promedio en Python
promedio = sum(valores) / len(valores)
hoja['D20'] = promedio  # Fija 42.5

✅ CORRECTO - Usar Fórmulas de Excel

# Bien: Deja que Excel calcule la suma
hoja['B10'] = '=SUMA(B2:B9)'

# Bien: Tasa de crecimiento como fórmula de Excel
hoja['C5'] = '=(C4-C2)/C2'

# Bien: Promedio usando función de Excel
hoja['D20'] = '=PROMEDIO(D2:D19)'

Esto aplica a TODOS los cálculos: totales, porcentajes, ratios, diferencias, etc. La hoja de cálculo debe poder recalcular cuando los datos de origen cambien.

Flujo de Trabajo Común

  1. Elegir herramienta: pandas para datos, openpyxl para fórmulas/formato
  2. Crear/Cargar: Crear nuevo libro o cargar archivo existente
  3. Modificar: Añadir/editar datos, fórmulas y formato
  4. Guardar: Escribir en archivo
  5. Recalcular fórmulas (OBLIGATORIO SI SE USAN FÓRMULAS): Usar el script recalc.py
    python recalc.py output.xlsx
    
  6. Verificar y corregir cualquier error:
    • El script devuelve JSON con detalles del error
    • Si status es errors_found, revisa error_summary para tipos y ubicaciones específicos
    • Corrige los errores identificados y recalcula nuevamente
    • Errores comunes a corregir:
      • #REF!: Referencias de celda inválidas
      • #DIV/0!: División por cero
      • #VALOR!: Tipo de dato incorrecto en la fórmula
      • #¿NOMBRE?: Nombre de fórmula no reconocido

Creación de nuevos archivos Excel

# Usando openpyxl para fórmulas y formato
from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill, Alignment

wb = Workbook()
hoja = wb.active

# Añadir datos
hoja['A1'] = 'Hola'
hoja['B1'] = 'Mundo'
hoja.append(['Fila', 'de', 'datos'])

# Añadir fórmula
hoja['B2'] = '=SUMA(A1:A10)'

# Formato
hoja['A1'].font = Font(bold=True, color='FF0000')
hoja['A1'].fill = PatternFill('solid', start_color='FFFF00')
hoja['A1'].alignment = Alignment(horizontal='center')

# Ancho de columna
hoja.column_dimensions['A'].width = 20

wb.save('output.xlsx')

Edición de archivos Excel existentes

# Usando openpyxl para preservar fórmulas y formato
from openpyxl import load_workbook

# Cargar archivo existente
wb = load_workbook('existente.xlsx')
hoja = wb.active  # o wb['NombreHoja'] para una hoja específica

# Trabajar con múltiples hojas
for nombre_hoja in wb.sheetnames:
    hoja = wb[nombre_hoja]
    print(f"Hoja: {nombre_hoja}")

# Modificar celdas
hoja['A1'] = 'Nuevo Valor'
hoja.insert_rows(2)  # Insertar fila en posición 2
hoja.delete_cols(3)  # Eliminar columna 3

# Añadir nueva hoja
nueva_hoja = wb.create_sheet('NuevaHoja')
nueva_hoja['A1'] = 'Datos'

wb.save('modificado.xlsx')

Recalcular fórmulas

Los archivos Excel creados o modificados por openpyxl contienen fórmulas como cadenas de texto, pero no valores calculados. Usa el script recalc.py proporcionado para recalcular fórmulas:

python recalc.py <archivo_excel> [segundos_tiempo_espera]

Ejemplo:

python recalc.py output.xlsx 30

El script:

  • Configura automáticamente la macro de LibreOffice en la primera ejecución
  • Recalcula todas las fórmulas en todas las hojas
  • Escanea TODAS las celdas en busca de errores de Excel (#REF!, #DIV/0!, etc.)
  • Devuelve JSON con ubicaciones y conteos detallados de errores
  • Funciona tanto en Linux como en macOS

Lista de Verificación de Fórmulas

Verificaciones rápidas para asegurar que las fórmulas funcionen correctamente:

Verificación Esencial

  • Probar 2-3 referencias de muestra: Verificar que tomen los valores correctos antes de construir el modelo completo
  • Mapeo de columnas: Confirmar que las columnas de Excel coincidan (ej., columna 64 = BL, no BK)
  • Desfase de filas: Recordar que las filas de Excel comienzan en 1 (DataFrame fila 5 = Excel fila 6)

Errores Comunes

  • Manejo de NaN: Verificar valores nulos con pd.notna()
  • Columnas lejanas a la derecha: Los datos de año fiscal a menudo están en columnas 50+
  • Múltiples coincidencias: Buscar todas las ocurrencias, no solo la primera
  • División por cero: Verificar denominadores antes de usar / en fórmulas (#DIV/0!)
  • Referencias incorrectas: Verificar que todas las referencias de celda apunten a las celdas previstas (#REF!)
  • Referencias entre hojas: Usar el formato correcto (Hoja1!A1) para enlazar hojas

Estrategia de Prueba de Fórmulas

  • Empezar pequeño: Probar fórmulas en 2-3 celdas antes de aplicarlas ampliamente
  • Verificar dependencias: Revisar que todas las celdas referenciadas en las fórmulas existan
  • Probar casos extremos: Incluir valores cero, negativos y muy grandes

Interpretación de la Salida de recalc.py

El script devuelve JSON con detalles del error:

{
  "status": "success",           // o "errors_found"
  "total_errors": 0,              // Conteo total de errores
  "total_formulas": 42,           // Número de fórmulas en el archivo
  "error_summary": {              // Solo presente si se encontraron errores
    "#REF!": {
      "count": 2,
      "locations": ["Hoja1!B5", "Hoja1!C10"]
    }
  }
}

Mejores Prácticas

Selección de Biblioteca

  • pandas: Mejor para análisis de datos, operaciones masivas y exportación simple de datos
  • openpyxl: Mejor para formato complejo, fórmulas y características específicas de Excel

Trabajar con openpyxl

  • Los índices de celda comienzan en 1 (fila=1, columna=1 se refiere a la celda A1)
  • Usar data_only=True para leer valores calculados: load_workbook('file.xlsx', data_only=True)
  • Advertencia: Si se abre con data_only=True y se guarda, las fórmulas se reemplazan con valores y se pierden permanentemente
  • Para archivos grandes: Usar read_only=True para lectura o write_only=True para escritura
  • Las fórmulas se preservan pero no se evalúan - usar recalc.py para actualizar valores

Trabajar con pandas

  • Especificar tipos de datos para evitar problemas de inferencia: pd.read_excel('file.xlsx', dtype={'id': str})
  • Para archivos grandes, leer columnas específicas: pd.read_excel('file.xlsx', usecols=['A', 'C', 'E'])
  • Manejar fechas correctamente: pd.read_excel('file.xlsx', parse_dates=['columna_fecha'])

Pautas de Estilo de Código

IMPORTANTE: Al generar código Python para operaciones de Excel:

  • Escribir código Python mínimo y conciso sin comentarios innecesarios
  • Evitar nombres de variables verbosos y operaciones redundantes
  • Evitar declaraciones print innecesarias

Para los propios archivos Excel:

  • Añadir comentarios a celdas con fórmulas complejas o suposiciones importantes
  • Documentar las fuentes de datos para valores fijos
  • Incluir notas para cálculos clave y secciones del modelo

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

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

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

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".

Skills relacionados