Skip to main content
Skills/Data & Analytics/analytics-report-writer

Analytics Report Writer Skill

Generates structured analytics reports from raw metrics, surfacing insights and actionable recommendations.

A reusable skill package for Claude Code and Cowork.

When to use this skill

  • Writing weekly or monthly analytics reports from raw metrics
  • Structuring KPI summaries for stakeholders
  • Turning dashboard data into narrative insights
  • Building repeatable reporting templates

What this skill does

Takes raw metrics, KPIs, or dashboard data and structures them into a narrative report with executive summary, trend analysis, anomaly callouts, and prioritized recommendations. Adapts tone and depth to the audience (executive, product team, or technical).

How it works

  1. 1Ingest metrics and clarify reporting period, audience, and goal
  2. 2Identify key trends, anomalies, and period-over-period changes
  3. 3Structure report: executive summary, trend analysis, deep dives, and recommendations
  4. 4Tailor tone and detail level to the audience (exec, PM, or engineering)

Full Skill Definition

---
name: analytics-report-writer
description: "Generates structured analytics reports from raw metrics, surfacing insights and actionable recommendations."
---

# Analytics Report Writer

## Overview

You are a BI specialist focused on designing actionable dashboards and meaningful KPI frameworks.

## Purpose

Help teams build dashboards that drive decisions, not just display data. Focus on the right metrics at the right level of detail.

## When to Use

When a user needs to design a dashboard, define KPIs for a team or product, or make an existing report more actionable.

## Dashboard Design Process

## Step 1: Define the Audience, Questions & Objectives

Who will use this dashboard? What decisions will it inform? What questions should it answer at a glance? Clarify the business objectives upfront so every metric has a reason to exist.

## Step 2: Select Metrics

Choose leading and lagging indicators. Define each metric precisely: calculation, data source, refresh frequency, and targets.

## Step 3: Design Layout

Organize with visual hierarchy: summary KPIs at top, trend charts in middle, detail tables at bottom. Use consistent color coding for status.

## Step 4: Add Interactivity & Validate

Include date range filters, drill-down capabilities, and comparison views (period-over-period, segment-by-segment). Share the dashboard with stakeholders for feedback and iterate on metric selection and layout before finalizing.

## Error Handling

## Vanity Metrics

Challenge metrics that look good but do not drive decisions. Ask "what would you do differently if this number changed?"

## BI Tool Unknown

Ask which BI platform (Looker, Metabase, Tableau, etc.) is in use before generating specific configurations.

## Data Freshness

Always display the last-updated timestamp on dashboards. Stale data presented without context leads to bad decisions.

Summary

Generates structured analytics reports from raw metrics, surfacing insights and actionable recommendations. Install this skill by placing the package in ~/.claude/skills/analytics-report-writer/ for personal use, or .claude/skills/analytics-report-writer/ for project-specific use.

FAQs

What data formats does it accept?

CSV exports, pasted tables, JSON, or plain metric descriptions. It works with whatever format you can share.

Does it create visualizations?

It describes charts and tables in Markdown. For actual visualizations, pair it with a BI tool or the data-pipeline-builder skill.

Can it build repeatable templates?

Yes. Ask it to produce a report template with placeholder sections that your team can fill in each reporting cycle.

Download & install

Install paths

Claude Code — personal (all projects)

~/.claude/skills/analytics-report-writer/SKILL.md

Claude Code — project-specific

.claude/skills/analytics-report-writer/SKILL.md

Cowork — skill plugin

Upload .skill.zip via Cowork plugin manager

Compatible with Claude Code, Cowork, and any SKILL.md-compatible agent platform.

Skills in the registry are community starter templates provided as-is. skill.design and Designless do not guarantee accuracy, completeness, or fitness for any purpose. Always review, customize, and validate skills for your specific use case before deploying to production. You are responsible for the behavior of skills you install and use.