Skip to content
cccskills
FreePublished on GitHub

codexkit-data-story-builder

Turn business data, KPI movement, or experiment results into a clear narrative using the what-so what-now what structure, audience calibration, and action-oriented insight. Use when leaders need a data-backed brief, dashboard storyline, or metric interpretation. Do not use for raw statistical modeling with no communication deliverable.

The English summary is being prepared. Showing the original description.

See how to install

Files included (5)

  • SKILL.md3.4 KB
  • agents/openai.yaml179 B
  • examples/common-mistakes.md799 B
  • examples/good-output.md1.2 KB
  • verification/checklist.md1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Data Story Builder

Purpose

Make analytics usable by giving the numbers a decision-oriented narrative.

When to use

  • A dashboard or KPI movement needs interpretation.
  • Experiment results or trend shifts must be explained to leadership.
  • A team needs a data-backed narrative, not a raw chart dump.

When not to use

  • The task is purely technical modeling with no stakeholder communication output.
  • The available data is too weak to support any claims and the user refuses caveats.

Inputs

  • business question and target audience
  • data points, charts, or KPI movement
  • baseline, target, or expected benchmark
  • context events that may explain the movement

Procedure

  1. Start from the business question, not the chart.
  2. Separate signal, uncertainty, and noise.
  3. Structure the story as what happened, why it matters, and what to do next.
  4. Translate numbers into plain-language implications for the chosen audience.
  5. Recommend the next decision, experiment, or investigation.
  6. State confidence limits and missing data.

Output

  • headline insight
  • what changed
  • why it matters
  • likely drivers or interpretations
  • recommended next actions
  • caveats and confidence notes

Definition of done

  • The audience can act on the analysis.
  • The narrative separates evidence from interpretation.
  • Caveats are present where the data is weak.

Examples

  • "Turn this KPI dashboard into a narrative for the monthly business review."
  • "Explain these A/B test results for a non-technical leadership team."

Quality Criteria

  • The story starts from a business question, not from chart narration.
  • Evidence, interpretation, and recommendation are clearly separated.
  • Every claim is supported by a data point, comparison, or stated assumption.
  • The "so what" explains business consequence, not just metric movement.
  • Caveats and confidence limits are included when data is incomplete or noisy.

Verification (4C)

CheckQuestion
CorrectnessDo the numbers, comparisons, and causal language match the underlying data?
CompletenessDoes the story include what changed, why it matters, likely drivers, actions, and caveats?
Context-fitIs the narrative useful for the audience's actual decision or operating review?
ConsequenceWhat wrong action might a stakeholder take if the story overstates certainty?

Edge Cases

  • Correlation mistaken for causation — Use causal language only when the design supports it; otherwise state "may be associated with."
  • Metric definition changed — Split the story before and after the definition change.
  • Executive audience with little time — Lead with the decision implication, then supporting evidence.
  • Weak or missing baseline — Mark confidence as low and recommend the next analysis step.

Changelog

  • v1.1.0 — Added data-story-specific quality gates and consequence checks.
  • v1.0.0 — Initial release

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Design rigorous A/B test plans with hypothesis, sample size calculation, Minimum Detectable Effect (MDE), randomization strategy, and decision rules. Includes guardrail metrics and rollout playbook. Use when planning product experiments, conversion optimization, or data-driven feature decisions.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Review REST and GraphQL API designs for consistency, usability, and best practices. Covers naming conventions, versioning strategy, error format, pagination, authentication patterns, and breaking change detection. Use when reviewing API specs, designing new APIs, or auditing existing endpoints.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Write Architecture Decision Records (ADRs) following the Michael Nygard format. Captures context, options considered, decision rationale, and consequences. Use when making technology choices, framework selections, or any architectural decision that future developers need to understand.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Assess organizational readiness for financial audits (internal or external). Map assertions to account balances, check evidence completeness, score readiness using a Red/Amber/Green framework, and generate a remediation timeline. Aligned with SOX, IFRS, and GAAP audit standards. Use before scheduled audits or when preparing for first-time compliance.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Design safe recurring Codex automations with clear prompts, outputs, schedules, and gating rules.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

Refine Product Backlog Items to meet INVEST criteria. Write User Stories with Acceptance Criteria in Given/When/Then format, estimate with Story Points, and flag dependencies. Use before sprint planning when backlog items need grooming. Do not use to prioritize the backlog — that is the Product Owner's decision.

The English summary is being prepared. Showing the original description.

hoavdc/CodexKit25Updated Oct 11, 2026

See all skills by hoavdc

Report a problem with this skill