Claude Data Analysis Assistant

September 29, 2025 · View on GitHub

A modern, intelligent data analysis platform built with Claude Code's sub-agents, slash-commands, and hooks. Transform your data analysis workflow with AI-powered assistance.

🚀 Quick Start

1. Set Up Your Data

Place your dataset in the data_storage/ directory:

cp your_data.csv ./data_storage/

2. Start Analysis

Use intuitive slash commands to analyze your data:

# Basic exploratory analysis
/analyze user_behavior_sample.csv exploratory

# Create visualizations
/visualize user_behavior_sample.csv all

# Generate analysis code
/generate python data-cleaning

# Create comprehensive report
/report user_behavior_sample.csv complete markdown

🎯 Key Features

Intelligent Sub-Agents

data-explorer: Expert statistical analysis and pattern discovery
visualization-specialist: Beautiful, insightful charts and graphs
code-generator: Production-ready analysis code
report-writer: Comprehensive analysis reports
quality-assurance: Data validation and quality control
hypothesis-generator: Research hypothesis and insights

Intuitive Slash Commands

/analyze [dataset] [type] - Perform data analysis
/visualize [dataset] [type] - Create visualizations
/generate [language] [type] - Generate analysis code
/report [dataset] [format] - Generate reports
/quality [dataset] [action] - Quality assurance
/hypothesis [dataset] [domain] - Generate hypotheses

Automated Workflows

Data Validation: Automatic quality checks on data upload
Smart Context: Project-aware analysis suggestions
Reproducible Analysis: Complete documentation and code generation

📊 Usage Examples

User Behavior Analysis

# Complete analysis workflow
/analyze user_behavior.csv exploratory
/visualize user_behavior.csv trends
/quality user_behavior.csv clean
/report user_behavior.csv complete html
/generate python user-segmentation

Sales Data Analysis

# Sales performance analysis
/analyze sales_data.csv statistical
/visualize sales_data.csv trends
/generate sql revenue-analysis
/report sales_data.csv executive pdf

Customer Analytics

# Customer segmentation
/analyze customer_data.csv predictive
/visualize customer_data.csv distribution
/generate r clustering-analysis
/hypothesis customer_data churn-prediction

🛠️ Project Structure

claude-data-analysis/
├── .claude/
│   ├── agents/          # Sub-agent configurations
│   ├── commands/        # Slash command definitions
│   ├── hooks/          # Automation scripts
│   └── settings.json   # Claude Code settings
├── data_storage/       # Your data files
├── visualizations/     # Generated charts
├── generated_code/     # Analysis code
├── analysis_reports/   # Analysis reports
├── examples/          # Example datasets and workflows
└── docs/             # Documentation

🎨 Sample Data

The project includes sample data to get you started:

user_behavior_sample.csv: Sample user behavior data with user actions, devices, locations, and revenue
Field descriptions: user_id, session_id, timestamp, action, page_url, device_type, location, revenue