Home
cd ../playbooks
Data & ReportingIntermediate

Performance Report

Generate performance reports.

15 minutes
By communitySource
#performance#report

Marketing teams lose hours to ad-hoc, inconsistent performance report work — Generate performance reports. Use when: tracking KPIs, trend analysis, anomaly detection, and actionable recommendations. This playbook turns the process into a repeatable, brand-aware workflow.

Who it's for: marketing analysts, growth analysts, BI leads

Example

"Run /performance-report for our brand" → Performance Report workflow output with brand context, structured inputs captured, process steps executed, and a complete deliverable ready for review.

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Performance Report

# /dm:performance-report

## Purpose

Generate a structured marketing performance report that transforms raw data into insights. Covers KPI tracking, trend analysis, anomaly detection, and prioritized recommendations for optimization.

## Input Required

The user must provide (or will be prompted for):

- **Reporting period**: Date range for the report
- **Channels to cover**: Which marketing channels to include (all, or specific ones)
- **Data source**: Raw data (paste, CSV, or connected platform)
- **KPIs of interest**: Specific metrics to focus on (or use defaults for the channel)
- **Comparison period**: Previous period, YoY, or custom benchmark
- **Audience**: Who will read the report (executive summary vs. tactical detail)

## Process

1. **Load brand context**: Read `~/.claude-marketing/brands/_active-brand.json` for the active slug, then load `~/.claude-marketing/brands/{slug}/profile.json`. Apply brand voice, compliance rules for target markets (`skills/context-engine/compliance-rules.md`), and industry context. **Also check for guidelines** at `~/.claude-marketing/brands/{slug}/guidelines/_manifest.json` — if present, load restrictions and relevant category files. Check for custom templates at `~/.claude-marketing/brands/{slug}/templates/`. Check for agency SOPs at `~/.claude-marketing/sops/`. If no brand exists, ask: "Set up a brand first (/dm:brand-setup)?" — or proceed with defaults.
2. Ingest and validate the provided performance data
3. Calculate core KPIs per channel: traffic, conversions, revenue, ROAS, CPA, engagement, growth
4. Run trend analysis: period-over-period changes, trajectory, seasonality adjustments
5. Detect anomalies: significant spikes or drops with likely root causes
6. Benchmark against industry averages and brand targets
7. Generate insights: what worked, what underperformed, and why
8. Produce prioritized recommendations for the next period
9. Format report for the specified audience (executive vs. tactical)

## Output

A structured performance report containing:

- Executive summary with headline metrics and overall assessment
- Channel-by-channel KPI dashboard with period-over-period comparison
- Trend analysis with visualizable data points
- Anomaly alerts with root cause hypotheses
- Top wins and underperformers with context
- Actionable recommendations ranked by expected impact
- Next period goals and focus areas

## Agents Used

- **analytics-analyst** — Data analysis, KPI calculation, trend detection, anomaly identification, recommendations
README.md

What This Does

Generate a structured marketing performance report that transforms raw data into insights. Covers KPI tracking, trend analysis, anomaly detection, and prioritized recommendations for optimization.


Quick Start

Step 1: Create a Project Folder

Create a dedicated folder for this workflow (e.g. ~/marketing/performance-report).

Step 2: Download the Template

Click Download above and save the file as CLAUDE.md in that folder.

Step 3: Run the Workflow

Open the folder in Claude Code and describe your goal. Claude will prompt you for any missing inputs, follow the structured process, and produce a complete deliverable.


Inputs You'll Need

The user must provide (or will be prompted for):

  • Reporting period: Date range for the report
  • Channels to cover: Which marketing channels to include (all, or specific ones)
  • Data source: Raw data (paste, CSV, or connected platform)
  • KPIs of interest: Specific metrics to focus on (or use defaults for the channel)
  • Comparison period: Previous period, YoY, or custom benchmark
  • Audience: Who will read the report (executive summary vs. tactical detail)

How It Works

  1. Load brand context: Read ~/.claude-marketing/brands/_active-brand.json for the active slug, then load ~/.claude-marketing/brands/{slug}/profile.json. Apply brand voice, compliance rules for target markets (skills/context-engine/compliance-rules.md), and industry context. Also check for guidelines at ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json — if present, load restrictions and relevant category files. Check for custom templates at ~/.claude-marketing/brands/{slug}/templates/. Check for agency SOPs at ~/.claude-marketing/sops/. If no brand exists, ask: "Set up a brand first (/dm:brand-setup)?" — or proceed with defaults.
  2. Ingest and validate the provided performance data
  3. Calculate core KPIs per channel: traffic, conversions, revenue, ROAS, CPA, engagement, growth
  4. Run trend analysis: period-over-period changes, trajectory, seasonality adjustments
  5. Detect anomalies: significant spikes or drops with likely root causes
  6. Benchmark against industry averages and brand targets
  7. Generate insights: what worked, what underperformed, and why
  8. Produce prioritized recommendations for the next period
  9. Format report for the specified audience (executive vs. tactical)

What You Get

A structured performance report containing:

  • Executive summary with headline metrics and overall assessment
  • Channel-by-channel KPI dashboard with period-over-period comparison
  • Trend analysis with visualizable data points
  • Anomaly alerts with root cause hypotheses
  • Top wins and underperformers with context
  • Actionable recommendations ranked by expected impact
  • Next period goals and focus areas

$Related Playbooks

Data & Reporting

Natural Language SQL Writer

Write optimized SQL queries from plain English across multiple database dialects

10 minutes
Intermediate
Data & Reporting

Roi Calculator

Calculate marketing ROI.

15 minutes
Intermediate
Data & Reporting

Automated Report Generator

Generate professional data reports with charts, tables, and visualizations

10 minutes
Intermediate
Data & Reporting

SaaS Metrics Dashboard

SaaS business metrics analysis - MRR, ARR, Churn, LTV, CAC, cohort analysis, and investor reporting

10 minutes
Advanced
Data & Reporting

Scientific Exploratory Data Analysis

Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats. This skill should be used when analyzing any scientific data file to understand its structure, content, quality, and characteristics. Automatically ...

10 minutes
Intermediate
Data & Reporting

Scientific Geomaster

Comprehensive geospatial science skill covering remote sensing, GIS, spatial analysis, machine learning for earth observation, and 30+ scientific domains. Supports satellite imagery processing (Sentinel, Landsat, MODIS, SAR, hyperspectral), vector...

5 minutes
Beginner
Data & Reporting

Scientific Geopandas

Python library for working with geospatial vector data including shapefiles, GeoJSON, and GeoPackage files. Use when working with geographic data for spatial analysis, geometric operations, coordinate transformations, spatial joins, overlay operat...

10 minutes
Intermediate
Data & Reporting

Scientific Hypogenic

Automated LLM-driven hypothesis generation and testing on tabular datasets. Use when you want to systematically explore hypotheses about patterns in empirical data (e.g., deception detection, content analysis). Combines literature insights with da...

15 minutes
Advanced
Data & Reporting

Scientific Infographics

'Create professional infographics using Nano Banana Pro AI with smart iterative refinement. Uses Gemini 3 Pro for quality review. Integrates research-lookup and web search for accurate data. Supports 10 infographic types, 8 industry styles, and co...

10 minutes
Intermediate
Data & Reporting

Scientific Matplotlib

Low-level plotting library for full customization. Use when you need fine-grained control over every plot element, creating novel plot types, or integrating with specific scientific workflows. Export to PNG/PDF/SVG for publication. For quick stati...

5 minutes
Beginner
Data & Reporting

Scientific Networkx

Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python. Use when working with network/graph data structures, analyzing relationships between entities, computing graph algorithms (shortest paths, centra...

10 minutes
Intermediate
Data & Reporting

Scientific Plotly

Interactive visualization library. Use when you need hover info, zoom, pan, or web-embeddable charts. Best for dashboards, exploratory analysis, and presentations. For static publication figures use matplotlib or scientific-visualization.

5 minutes
Beginner

Browse all Data & Reporting playbooks →