report

name	report
description	Generate a comprehensive Markdown analysis report with findings, charts, and recommendations
argument-hint	[dataset-name] [optional-focus]
risk	safe
disable-model-invocation	false
user-invocable	true
allowed-tools	Read, Write, Edit, Bash, Glob, Grep
model	claude-sonnet-4-6
context	fork
agent	general-purpose

10x Analyst — Report Generator

Generate a publication-ready Markdown analysis report from any dataset.

Overview

Runs the Data Engineer → Statistician → Reporter → Strategist pipeline. Reads from input/<dataset>/, produces output/<dataset>/report.md with executive summary, key findings, embedded charts, and actionable recommendations.

When to Use

• User asks for a "report", "analysis document", "write-up", or "summary"
• User needs a shareable document with findings and recommendations
• User wants analysis results in Markdown format for documentation

Path Resolution

Parse $ARGUMENTS to get dataset name.

• Input: input/<dataset-name>/
• Output: output/<dataset-name>/report.md (plus charts and supporting files)

Instructions

Step 1: Data Engineering

1. Find and load all data files at input/<dataset>/
2. Profile and clean data (same as :analyze Phase 1)
3. Save cleaned data to output/<dataset>/cleaned-data/

Step 2: Analysis

4. Run statistical analysis on cleaned data
5. Compute KPIs, trends, segments, correlations
6. Generate key insights and save to output/<dataset>/insights.json

Step 3: Charts

7. Generate supporting charts for each insight
8. Save PNGs to output/<dataset>/charts/

Step 4: Report Assembly

9. Write output/<dataset>/report.md with this structure:

# Data Analysis Report
> Generated by **10x Analyst** | {date} | Source: input/{dataset}

## Executive Summary
- {Finding 1: metric + direction + magnitude}
- {Finding 2}
- {Finding 3}

## Data Overview
| Metric | Value |
|--------|-------|
| Files | {count} |
| Records | {count} |
| Date Range | {range} |
| Quality | {score}% |

## Key Findings

### 1. {Headline}
{Explanation with numbers}
![Chart](charts/chart_name.png)
**Implication:** {Business meaning}

### 2. {Headline}
...

## Recommendations
1. **{Action}** — Based on Finding #X -> Expected impact: {outcome}
2. ...

## Methodology
{Tools, methods, assumptions, limitations}

## Appendix
{Full statistics, data dictionary}

Step 5: Strategy Layer

10. Prioritize insights by business impact (P0-P3)

11. Refine recommendations with expected outcomes

12. Add executive brief section

13. Present report location and top insights to user

Examples

/10x-analyst:report shopify-data
/10x-analyst:report shopify-data "focus on customer retention"

Limitations

• Report is Markdown only — not PDF or HTML (use :dashboard for HTML)
• Chart image paths are relative — keep report and charts in same output/<dataset>/ directory
• Executive summary limited to top 5 findings

---

Developed by 10x.in | 10x-Analyst v1.0.0