Agent skill

Data Narrative Builder

by nimrodfisher in nimrodfisher/data-analytics-skills

Build compelling data-driven narratives. An agent skill from nimrodfisher/data-analytics-skills.

MITAuto-check passedWriting & Content

Install Data Narrative Builder

skills CLI
$ npx skills add nimrodfisher/data-analytics-skills --skill data-narrative-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nimrodfisher/data-analytics-skills data-narrative-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nimrodfisher/data-analytics-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/04-data-storytelling-visualization/data-narrative-builder .claude/skills/data-narrative-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
data-narrative-builder
GitHub stars
465
Token cost
~744 tokens
SKILL.md length
378 words
Files
4 (incl. references, assets)
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Build compelling data-driven narratives. An agent skill from nimrodfisher/data-analytics-skills.

  • Works in 6 steps: Identify the central message — write the… → Choose a narrative framework — select… → Assign an emotional arc — map each… → …
  • Presenting analysis results
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Creating stakeholder reports

What it does

Data Narrative Builder is an agent skill from nimrodfisher/data-analytics-skills. Build compelling data-driven narratives. Use when presenting analysis results, creating stakeholder reports, or transforming a set of findings into a story that drives a specific decision or action.

Its SKILL.md is about 740 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files and assets (for example `assets/narrative_template.md`, `references/data_writing_guide.md` and `references/narrative_frameworks.md`).

It sits in Writing & Content, covering Storytelling. The repository describes itself as: A comprehensive list of Claude & Codex skills for a wide range of data analytics tasks. The licence is MIT.

When your agent uses it

  • Presenting analysis results
  • Creating stakeholder reports
  • Transforming a set of findings into a story that drives a specific decision

Example prompts

  • “/data-narrative-builder”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Identify the central message — write the single most important thing the audience should know and do after seeing this. Everything else is…
  2. Choose a narrative framework — select the structure that fits the context. Situation–Complication–Resolution works for most…
  3. Assign an emotional arc — map each section to an intended emotional state: establish comfort (Situation), introduce tension…
  4. Draft each section with data woven in — apply the pyramid principle: lead with the conclusion, then support it with evidence. Numbers must…
  5. Plan the visual sequence — assign one key chart or visual to each narrative beat. The visual should reinforce the spoken or written…
  6. Write the opening hook and closing call to action — the hook must earn attention in under 10 seconds (a surprising stat, a question, or a…

What it can do on your machine

Read from SKILL.md and the folder at commit 9449d36. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Data Narrative Builder loads about 744 tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 378 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~744
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nimrodfisher/data-analytics-skills at commit 9449d36, republished under its MIT licence (© nimrodfisher). 378 words, ~744 tokens.

Download SKILL.mdSave it as .claude/skills/data-narrative-builder/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
data-narrative-builder
description
Build compelling data-driven narratives. Use when presenting analysis results, creating stakeholder reports, or transforming a set of findings into a story that drives a specific decision or action.

Data Narrative Builder

When to use

  • A presentation exists but feels like a data dump rather than a story
  • The analysis has a clear finding but the team doesn't know how to make it compelling
  • The audience is senior and will not read more than 5 slides
  • A decision needs to be made and the data needs to make a clear, emotion-aware argument
  • A recurring report needs to be restructured around a narrative rather than a metric list

Process

  1. Identify the central message — write the single most important thing the audience should know and do after seeing this. Everything else is supporting material. If there's more than one message, there are multiple presentations.
  2. Choose a narrative framework — select the structure that fits the context. Situation–Complication–Resolution works for most problem/solution stories. Before–After–Bridge is strong for demonstrating impact. See references/narrative_frameworks.md for all patterns with examples.
  3. Assign an emotional arc — map each section to an intended emotional state: establish comfort (Situation), introduce tension (Complication), offer confidence (Resolution). Tone and data emphasis should match the intended emotion at each stage.
  4. Draft each section with data woven in — apply the pyramid principle: lead with the conclusion, then support it with evidence. Numbers must serve the narrative, not interrupt it. Round large numbers for recall; humanise by expressing impact in terms the audience cares about.
  5. Plan the visual sequence — assign one key chart or visual to each narrative beat. The visual should reinforce the spoken or written message, not repeat it. See references/data_writing_guide.md for annotation and emphasis techniques.
  6. Write the opening hook and closing call to action — the hook must earn attention in under 10 seconds (a surprising stat, a question, or a contrast). The CTA must name a specific decision, person, and deadline. Complete assets/narrative_template.md.
Show full SKILL.md (82 more words)Show less

Inputs the skill needs

  • The central finding or insight to be communicated
  • The audience (role, knowledge level, what they care about most)
  • The desired action or decision at the end of the presentation
  • All supporting data and charts already prepared
  • Format and time constraints (slides, report, 5-minute presentation, 30-page doc)

Output

  • references/narrative_frameworks.md — SCR, BAB, hero journey, and sparklines patterns with data storytelling examples
  • references/data_writing_guide.md — pyramid principle, number formatting, annotation, plain-language techniques
  • assets/narrative_template.md — fill-in-the-blank narrative structure: hook, situation, complication, resolution, call to action

© nimrodfisher, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references, assets) in 04-data-storytelling-visualization/data-narrative-builder of nimrodfisher/data-analytics-skills.

  • SKILL.md
  • assets/narrative_template.md
  • references/data_writing_guide.md
  • references/narrative_frameworks.md

Open the folder on GitHubat commit 9449d36

Compare with similar skills

Data Narrative Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Data Narrative Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Data Narrative Builder this skillnimrodfisher/data-analytics-skills465—~744Automated safety check: PassMIT
Data Storytellingynulihao/AgentSkillOS61716 repos~2.8kAutomated safety check: PassNone
Chinese Novel Writing Systemleenbj/novel-creator-skill667—~3.9kAutomated safety check: PassNone
Chinese Novelist Chapter WriterPenglongHuang/chinese-novelist-skill3.3k—~491Automated safety check: WarnMIT
Liu Run Style Business Column Writerliangdabiao/liurun-bookwriter-skills274—~1.8kAutomated safety check: PassMIT
Business Insight Essay Writerliangdabiao/liurun-bookwriter-skills274—~2.5kAutomated safety check: PassMIT

Similar skills

  • Data Storytelling

    ynulihao/AgentSkillOS

    Transform data into compelling narratives using visualization, context, and persuasive structure.

    617 GitHub starsUsed in 16 repos~2.8k tokens
    Writing & ContentAuto-check passed
  • Chinese Novel Writing System

    leenbj/novel-creator-skill

    Guides long-form Chinese novel writing from a rough idea through outlines, chapter drafts and quality gates, with file-based memory for a story meant to reach 300万字.

    667 GitHub stars~3.9k tokensUpdated 7 mo ago
    Writing & ContentAuto-check passed
  • Chinese Novelist Chapter Writer

    PenglongHuang/chinese-novelist-skill

    Writes long Chinese novels chapter by chapter through guided questions, outlining, drafting with cliffhangers and automatic validation, with resumable projects.

    3.3k GitHub stars~491 tokensUpdated 2 days ago
    Writing & ContentAuto-check: warnings
  • Liu Run Style Business Column Writer

    liangdabiao/liurun-bookwriter-skills

    Writes long-form Chinese business commentary in Liu Run's voice, using his eight writing principles, three structures, and SCQA logic patterns.

    274 GitHub stars~1.8k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Business Insight Essay Writer

    liangdabiao/liurun-bookwriter-skills

    Drafts Chinese business-insight essays, short audio scripts and year-end speeches in a specific public commentator's rhythm, built from his books, talks and broadcasts.

    274 GitHub stars~2.5k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Shakespeare Writing Studio

    ZCZHAO-1999/shakespeare-writing-studio

    Produce publish-ready Chinese and English writing packages across WeChat articles, Medium/Substack essays, research notes, founder memos, op-eds, speeches, data storytelling, statistical graphics…

    178 GitHub stars~1.5k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed

More from nimrodfisher/data-analytics-skills

All 31 skills in this repo
  • Ab Test Analysis

    nimrodfisher/data-analytics-skills

    Rigorous A/B test statistical analysis. An agent skill from nimrodfisher/data-analytics-skills.

    465 GitHub stars~708 tokensUpdated 13 days ago
    Auto-check passed
  • Analysis Assumptions Log

    nimrodfisher/data-analytics-skills

    Track and document analytical assumptions and decisions. An agent skill from nimrodfisher/data-analytics-skills.

    465 GitHub stars~578 tokensUpdated 13 days ago
    Auto-check passed
  • Analysis QA Checklist

    nimrodfisher/data-analytics-skills

    Pre-delivery quality assurance for analysis work. An agent skill from nimrodfisher/data-analytics-skills.

    465 GitHub stars~470 tokensUpdated 13 days ago
    Auto-check passed
  • Business Metrics Calculator

    nimrodfisher/data-analytics-skills

    Standard business metric calculation with industry benchmarks.

    465 GitHub stars~668 tokensUpdated 13 days ago
    Auto-check passed
  • Cohort Analysis

    nimrodfisher/data-analytics-skills

    Time-based cohort analysis with retention and behaviour tracking.

    465 GitHub stars~660 tokensUpdated 13 days ago
    Auto-check passed
  • Context Packager

    nimrodfisher/data-analytics-skills

    Efficiently package context for AI-assisted analysis. An agent skill from nimrodfisher/data-analytics-skills.

    465 GitHub stars~500 tokensUpdated 13 days ago
    Auto-check passed

Questions about Data Narrative Builder

What does Data Narrative Builder do?

Build compelling data-driven narratives. An agent skill from nimrodfisher/data-analytics-skills. Data Narrative Builder is an agent skill from nimrodfisher/data-analytics-skills. Build compelling data-driven narratives.

When should I use Data Narrative Builder?

Data Narrative Builder fits situations like: presenting analysis results; creating stakeholder reports; transforming a set of findings into a story that drives a specific decision.

How do I install Data Narrative Builder in Claude Code?

Run `npx skills add nimrodfisher/data-analytics-skills --skill data-narrative-builder -a claude-code`. Or copy the skill folder (04-data-storytelling-visualization/data-narrative-builder in nimrodfisher/data-analytics-skills) into .claude/skills/data-narrative-builder in your project. Claude Code loads it when a task matches its description.

How do I install Data Narrative Builder in Codex?

Run `npx skills add nimrodfisher/data-analytics-skills --skill data-narrative-builder -a codex`. Or copy the skill folder (04-data-storytelling-visualization/data-narrative-builder in nimrodfisher/data-analytics-skills) into .agents/skills/data-narrative-builder in your project. Codex loads it when a task matches its description.

Can I use Data Narrative Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nimrodfisher/data-analytics-skills --skill data-narrative-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/data-narrative-builder, .gemini/skills/data-narrative-builder, .github/skills/data-narrative-builder and .opencode/skills/data-narrative-builder in your project.

What does Data Narrative Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Data Narrative Builder is instructions for the agent only.

Does Data Narrative Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Data Narrative Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Data Narrative Builder use?

Data Narrative Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Data Narrative Builder use?

About 744 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.

What are the alternatives to Data Narrative Builder?

Skills that share tags, products or a category with Data Narrative Builder: Data Storytelling (ynulihao/AgentSkillOS, 617 stars), Chinese Novel Writing System (leenbj/novel-creator-skill, 667 stars), Chinese Novelist Chapter Writer (PenglongHuang/chinese-novelist-skill, 3.3k stars) and Liu Run Style Business Column Writer (liangdabiao/liurun-bookwriter-skills, 274 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Data Narrative Builder?

nimrodfisher (a GitHub user) maintains it in nimrodfisher/data-analytics-skills, which has 465 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on September 25, 2026.

Source: nimrodfisher/data-analytics-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.