Communitygithub.com

Narrador de Datos

Convierte datos y gráficos en una historia narrativa que impulsa decisiones, estructurada como hallazgo principal, tendencia, implicación y acción recomendada, con títulos de gráficos basados en hallazgos, contexto para cada número, guía de anotaciones y banderas honestas sobre cualquier conclusión que los datos no puedan respaldar.

¿Qué es Narrador de Datos?

Esta habilidad transforma tablas y gráficos crudos en una narrativa persuasiva diseñada para guiar decisiones. A diferencia de un simple resumen ejecutivo o un análisis exploratorio, el Narrador de Datos se enfoca en encontrar la historia dentro de los números y presentarla de manera que la audiencia recuerde la conclusión clave, no la hoja de cálculo. Funciona mejor cuando un usuario pregunta 'convierte estos números en una historia' o 'ayúdame a presentar estos resultados a la dirección', pero no debe usarse para comprimir documentos largos ni para ejecutar el análisis subyacente (para eso están las habilidades executive-summary y eda-playbook respectivamente). El proceso sigue una estructura de cuatro partes: hallazgo principal (con una cifra contundente), la tendencia o patrón, la implicación para el negocio, y la acción recomendada. Cada gráfico debe tener un título que sea un hallazgo en sí mismo, no una etiqueta descriptiva, y todos los números deben incluir contexto (línea base, período de comparación). La habilidad aplica reglas estrictas contra falacias (como correlación igual a causalidad), redondea para facilitar la lectura, y recomienda usar solo tres números clave por presentación. También exige honestidad sobre las limitaciones: las muestras pequeñas (<30) se tratan como ruido, y cualquier conclusión que los datos no respalden completamente se señala explícitamente. Está diseñada para plataformas como Claude Code, Cursor y Codex, y su documentación original (SKILL.md) proporciona pautas detalladas sobre cómo encontrar la historia, presentar números, evitar anti-patrones y cumplir con un estándar de calidad alto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/data-story

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Narrador de Datos?

Conviertes números y gráficos en una historia que impulsa una decisión. Los datos por sí solos no persuaden; la narrativa que los rodea sí lo hace. Tu trabajo es encontrar el "y qué" y contarlo.

Principio fundamental

Cada conjunto de datos tiene una historia, pero hay que encontrarla y enmarcarla. Lidera con la idea clave, respáldala con los datos, no al revés. Una audiencia recuerda la conclusión, no la hoja de cálculo.

Proceso

  1. Obtén los datos/gráficos más el contexto: la audiencia, la decisión en juego y lo que creen inicialmente.
  2. Encuentra el hallazgo que más importa. Interroga los datos: ¿qué cambió?, ¿qué es sorprendente?, ¿cuál es el valor atípico?, ¿cuál es la tendencia?
  3. Construye la narrativa: titular → evidencia → implicación → acción.

La estructura de cuatro partes

  1. Hallazgo principal - la conclusión más importante, expresada como una oración con un número. "Las suscripciones móviles superaron a las de escritorio este trimestre, alcanzando el 58%." Esta es la historia; todo lo demás la respalda.
  2. La tendencia / patrón - la forma de los datos a lo largo del tiempo o entre segmentos. Muestra dirección y magnitud. ¿Se está acelerando?, ¿revirtiendo?, ¿concentrando?
  3. La implicación - lo que significa para el negocio/lector. Conecta el número con consecuencias que les importen.
  4. El y qué / acción - qué hacer al respecto. Una historia de datos que no cambia una decisión es trivial.

Cómo encontrar la historia

  • Busca: cambio a lo largo del tiempo, comparaciones (vs. referencia, segmento, expectativa), valores atípicos, correlaciones y puntos de inflexión.
  • Pregunta "¿comparado con qué?" - un número no tiene sentido sin un punto de referencia.
  • Cuidado con patrones espurios: la correlación no es causalidad, las muestras pequeñas engañan y el sesgo de selección se oculta. Anota las limitaciones con honestidad.
  • Trata los porcentajes de muestras pequeñas con sospecha: por debajo de aproximadamente n = 30 un porcentaje es ruido disfrazado de hallazgo, y por debajo de n = 100 muestra los conteos brutos junto a él ("7 de 45 usuarios", no "15.6%").

Cómo presentar números

  • Un gráfico, un mensaje. Cada visual debe hacer un solo punto; titula el gráfico con ese punto ("El móvil superó al escritorio en el Q2"), no con una etiqueta ("Suscripciones por plataforma"). Un lector debe captar el punto del gráfico solo con el título en unos cinco segundos; si no puede, el gráfico está haciendo análisis, no narración.
  • Redondea para facilitar la lectura. Dos cifras significativas es el máximo para algo dicho en voz alta o en un titular - "aproximadamente 6 de cada 10" o "58%" es mejor que "58.34%"; mantén la precisión completa solo donde sea crítica (un umbral contractual, un límite legal).
  • Raciona los números. Una audiencia retiene aproximadamente tres números de una presentación. Elige los tres que cuentan la historia y degrada el resto a apéndice o nota al pie.
  • Contexto para cada número. Cambio porcentual, línea base, período de tiempo.
  • Resalta el punto - anota el gráfico, atenúa el resto, dirige la mirada a lo que importa.

Reglas de escritura

  • Lidera con la idea clave, no con la metodología.
  • Traduce las estadísticas a lenguaje llano y consecuencias humanas.
  • Usa comparaciones y analogías para hacer sentir las magnitudes ("suficiente para llenar el recinto dos veces").
  • Sé honesto sobre la incertidumbre y las limitaciones - la credibilidad es el punto central.
  • No hagas cherry-picking; cuenta la historia real, incluyendo los datos incómodos.

Anti-patrones

  • Volcar cada métrica y dejar que el lector encuentre el punto.
  • Gráficos titulados con etiquetas en lugar de hallazgos.
  • Números sin comparación ni contexto.
  • Reclamar causalidad exagerada a partir de correlación.
  • Enterrar la conclusión principal bajo la metodología.

Estándar de calidad

  • El hallazgo principal es una oración que contiene un número y podría ser la historia completa por sí sola.
  • Cada título de gráfico expresa un hallazgo, no una etiqueta, y supera la prueba de los cinco segundos.
  • Cada número tiene un punto de comparación (línea base, referencia o período anterior) y un período de tiempo.
  • Ninguna afirmación causal se basa solo en correlación, y cada porcentaje de muestra pequeña muestra sus conteos brutos.
  • La acción recomendada nombra una decisión que alguien en la audiencia pueda tomar realmente.

Resultado

Entrega la historia de datos: hallazgo principal al inicio, luego la tendencia de respaldo, la implicación y la acción recomendada. Para cada gráfico, da un título basado en el hallazgo y señala qué resaltar. Marca cualquier conclusión que los datos no puedan respaldar completamente para que no se exagere.

Individual skills in this repo

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

SkillMedev/skills

Designs REST API surfaces - resource naming, HTTP method and status-code semantics, error shapes, pagination, and filtering - and delivers an endpoint spec a consumer can build against without asking questions. Use when someone asks "how should I name this endpoint", "what status code should this return", "should this be PUT or PATCH", "how do I paginate this list", or is reviewing an API before it ships to external consumers. Do NOT use for planning breaking-change rollouts and deprecation windows - use api-versioning-strategist instead; for GraphQL type and resolver design - use graphql-schema instead; for generating client SDKs from an existing spec - use api-client-generator instead; for designing inbound webhook endpoints - use webhook-receiver-hardener instead.

SkillMedev/skills

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video's audio - transcribing or aligning to the voiceover script, timing cues to speech, and enforcing line-length and reading-speed rules so captions are readable and in sync. Use when someone says "generate captions", "make subtitles from the audio", "transcribe and caption this", "export an SRT or VTT", "the captions are out of sync", or "the subtitles flash by too fast to read". Do NOT use to burn-in, style, reframe, or position an existing caption track for a platform (9:16, brand styling, safe areas) - that is social-video-formatter; do NOT use to animate text word-by-word as a motion graphic - that is kinetic-typography; do NOT use to write the spoken script in the first place - that is narration-script.

SkillMedev/skills

Use when a task needs live or historical money data - "convert USD to EUR", "current/past exchange rate", "FX rate on this date / over this range", or "current price of Bitcoin/Ethereum, market cap, 24h change". Frankfurter (ECB reference rates, no key) is the FX default; CoinGecko's free keyless tier covers crypto. Do NOT use for stock quotes or equities - no keyless stock API survives verification, say so instead of guessing; do NOT use for country economic indicators like GDP or inflation series - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Builds a driver-based FP&A operating model linking business inputs to P&L, balance sheet, and cash flow outputs. Use when building an annual plan, preparing investor materials, running scenario analysis, or stress-testing the business.

SkillMedev/skills

Use when a task needs live geographic lookups - "geocode this address", "what's at these coordinates" (reverse geocoding), "lat/lon for this city", "which country/state is this ZIP or postal code in", or "country facts: capital, currency, population, flag". Nominatim (OpenStreetMap) is the geocoding default; Zippopotam for postal codes; APICountries for country facts. All keyless. Do NOT use for weather at a location - use weather-climate instead; do NOT use for country-level statistics over time (GDP, population trends) - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Runs the full Getting Things Done loop - capture, clarify, organize, reflect, engage - building a trusted system of context lists, a projects list with defined next actions, and a weekly review habit. Use when someone says "I'm overwhelmed and things are slipping through the cracks", "set up GTD for me", "help me do a brain dump and organize it", or "my to-do list is a mess". Do NOT use for just running the weekly review ritual itself - use weekly-review instead - or for clearing an email backlog - use inbox-zero.

SkillMedev/skills

Processes any email backlog to zero using the 4Ds - Delete, Delegate, Defer, Do - with a mass-archive strategy for the obvious, a touch-each-email-once discipline, and a keep-it-clear system of batched processing windows, ruthless unsubscribing, filters, and a minimal folder setup. Use when someone says "I have 5,000 unread emails", "help me get to inbox zero", "email is eating my whole day", or treats their inbox as a to-do list. Do NOT use for drafting the reply emails themselves or prioritization rules for an ongoing support queue - use email-triage instead - or for protecting focus time around the email windows - use deep-work-planner instead.

SkillMedev/skills

Write landing-page copy section by section - hero, social proof, features-as-benefits, objections, CTA - leading with one promise and proving it down the page. Use when someone asks "write my landing page", "improve my hero headline", "what should the homepage say", "turn these features into benefits", or is shipping a new page for a launch or campaign. Do NOT use for testing and optimizing an existing page's conversion rate - use landing-page-cro instead; for the one-line claim itself use positioning-statement; for the full message ladder use messaging-hierarchy.

SkillMedev/skills

Improves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer instead.

SkillMedev/skills

Runs structured coaching sessions using values clarification and the GROW model, ending every session with one committed action, a deadline, and an if-then plan for the likely obstacle. Use when someone says "I feel stuck in my life", "help me figure out what I want", "hold me accountable to my goals", or "coach me through this decision". Do NOT use for building a stress toolkit - use stress-management instead - or a journaling practice - use journal-framework; for a standing goal-tracking system, use goals-accountability. Coaching, not therapy: signs of clinical distress route to a licensed professional.

SkillMedev/skills

Adapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.

SkillMedev/skills

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says "build a 20-second product demo video", "animate a feature walkthrough", "write the Remotion code for this marketing clip", or wants a scene-by-scene composition they can scrub in Studio. Do NOT use for rendering, iterating, or batching the finished MP4 - use remotion-render instead - or for installing and scaffolding the project - use remotion-setup instead.

SkillMedev/skills

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just "make product videos with Claude.

SkillMedev/skills

Classifies incident severity (SEV1-4) using impact, scope, and urgency signals and decides who to page. Use when an alert fires or a report comes in and a severity call must be made quickly.

SkillMedev/skills

Use the Skill Me catalog from inside any conversation - discover, install, and manage Claude skills through the Skill Me MCP, and load installed skills automatically each session.

SkillMedev/skills

Write one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.

SkillMedev/skills

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says "make this vertical", "crop to 9:16", "format for TikTok/Reels/Shorts", "add captions/subtitles", "why is my video cut off on mobile", "resize for Instagram", or "export for social". Do NOT use when the question is about the storyboard or shot order before any video exists (use video-storyboard); the animation craft of how elements move (use motion-design-principles); animated word-by-word caption styling (use kinetic-typography); palette, contrast, or lighting (use motion-color-and-light); directing the product-demo content and screen choreography (use product-demo-director); or scoring, beat-syncing, or audio (use sound-and-music-sync) - this is the craft layer that decides WHAT to format for the feed, then hands a concrete spec to remotion-compo...

SkillMedev/skills

Writes and tunes PySpark jobs - join strategy and broadcast size limits, shuffle-partition sizing, skew diagnosis and salting, UDF avoidance, caching, and output file layout - with concrete size and skew thresholds. Use when someone asks "why is my Spark job slow", "should I broadcast this join", "one task takes forever while the rest finish", "my job OOMs during a join", or is writing a new PySpark ETL job. Do NOT use for Kafka topic, consumer-group, or streaming-pipeline design - use kafka-pipelines instead; do NOT use for single-machine dataframe work that fits in memory - use pandas-expert instead.

SkillMedev/skills

Builds clean, performant, accessible SwiftUI views with correct state ownership, scoped invalidation, and smooth list scrolling, and reviews existing SwiftUI code against a concrete frame-time and re-render budget. Use when someone asks "why does my SwiftUI list stutter", "should this be @State or @Observable", "my whole screen re-renders when one row changes", "how do I animate this transition", or wants a SwiftUI view built or refactored. Do NOT use for cross-platform React Native apps - use react-native-pro instead; do NOT use for Flutter widget trees - use flutter-widget-architect instead; do NOT use for Android Compose UIs - use jetpack-compose-builder instead.

Skills relacionados