Exploratory Data Analysis — Claude Code skill: profile a dataset
A skill that walks the agent through first-pass dataset analysis: profiling, distributions, correlations and outlier checks in Python. Useful before you build a model.
npx skills add aj-geddes/useful-ai-prompts --skill exploratory-data-analysis -a claude-codeWhat Exploratory Data Analysis does
The skill sets an order for working with a new dataset: profile first, plots second. It ships ready Python blocks built on pandas, numpy, matplotlib and seaborn — table shape, column types, missing values, duplicates, describe(), histograms, box plots, a correlation heatmap and pairplot.
Then comes the part people usually skip: skewness and kurtosis per numeric column, percentiles, groupby breakdowns, feature correlation against the target, IQR-based outlier detection and an automated insights pass. The skill also lists common pitfalls — over-reading patterns in small samples, ignoring domain context, not writing findings down.
The examples import pandas, numpy, matplotlib and seaborn, so those need to be in your environment. Output is a set of artifacts: a data quality report, summary statistics with charts, a list of anomalies and hypotheses to test. That is a reason to hold off on feeding a raw table straight into a model.
What it helps with
- understand an unfamiliar dataset before modeling
- spot missing values and duplicate rows
- inspect distributions of numeric columns
- flag outliers with the IQR rule
- collect hypotheses worth testing later
Example prompts for the agent
- Run EDA on
customer_data.csv: profile, distributions, correlations - Find outliers and missing values in this dataset and suggest what to do
- Build a data quality report with charts for stakeholders
How to install Exploratory Data Analysis
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill exploratory-data-analysis -a claude-code2Manually: put the files in place
~/.claude/skills/exploratory-data-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/exploratory-data-analysis/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill exploratory-data-analysis -a codex2Manually: put the files in place
.agents/skills/exploratory-data-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill exploratory-data-analysis -a cursor2Manually: put the files in place
.cursor/skills/exploratory-data-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aj-geddes/useful-ai-prompts exploratory-data-analysis2Manually: put the files in place
.github/skills/exploratory-data-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill exploratory-data-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/aj-geddes/useful-ai-prompts --path skills/exploratory-data-analysisManually: put the files in place
.devin/skills/exploratory-data-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill exploratory-data-analysis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about Exploratory Data Analysis
How do I install Exploratory Data Analysis in Claude?
Run npx skills add aj-geddes/useful-ai-prompts --skill exploratory-data-analysis -a claude-code. The skill lands in ~/.claude/skills/exploratory-data-analysis/SKILL.md.
What does this skill do?
It guides the agent through exploratory analysis steps: table profiling, distributions, correlations, outliers and hypothesis generation in Python.
What do I need for it to work?
The examples use pandas, numpy, matplotlib and seaborn, so those libraries have to be available in your environment.
Source text
SKILL.md · MIT
---
name: Exploratory Data Analysis
description: Discover patterns, distributions, and relationships in data through visualization, summary statistics, and hypothesis generation for exploratory data analysis, data profiling, and initial insights
---
# Exploratory Data Analysis (EDA)
## Overview
Exploratory Data Analysis (EDA) is the critical first step in data science projects, systematically examining datasets to understand their characteristics, identify patterns, and assess data quality before formal modeling.
## Core Concepts
- **Data Profiling**: Understanding basic statistics and data types
- **Distribution Analysis**: Examining how variables are distributed
- **Relationship Discovery**: Identifying patterns between variables
- **Anomaly Detection**: Finding outliers and unusual patterns
- **Data Quality Assessment**: Evaluating completeness and consistency
## When to Use
- Starting a new dataset analysis
- Understanding data before modeling
- Identifying data quality issues
- Generating hypotheses for testing
- Communicating insights to stakeholders
## Implementation with Python
```python
import pandas as pd
import numpy as np
import matplotlib.pyplot as plt
import seaborn as sns
# Load and explore data
df = pd.read_csv('customer_data.csv')
# Basic profiling
print(f"Shape: {df.shape}")
print(f"Data types:\n{df.dtypes}")
print(f"Missing values:\n{df.isnull().sum()}")
print(f"Duplicates: {df.duplicated().sum()}")
# Statistical summary
print(df.describe())
print(df.describe(include='object'))
# Distribution analysis - numerical columns
fig, axes = plt.subplots(2, 2, figsize=(12, 8))
df['age'].hist(bins=30, ax=axes[0, 0])
axes[0, 0].set_title('Age Distribution')
df['income'].hist(bins=30, ax=axes[0, 1])
axes[0, 1].set_title('Income Distribution')
# Box plots for outlier detection
df.boxplot(column='age', by='region', ax=axes[1, 0])
axes[1, 0].set_title('Age by Region')
# Categorical analysis
df['category'].value_counts().plot(kind='bar', ax=axes[1, 1])
axes[1, 1].set_title('Category Distribution')
plt.tight_layout()
plt.show()
# Correlation analysis
numeric_df = df.select_dtypes(include=[np.number])
correlation_matrix = numeric_df.corr()
plt.figure(figsize=(10, 8))
sns.heatmap(correlation_matrix, annot=True, cmap='coolwarm', center=0)
plt.title('Correlation Matrix')
plt.show()
# Multivariate relationships
sns.pairplot(df[['age', 'income', 'education_years']], diag_kind='hist')
plt.show()
# Skewness and kurtosis
print("\nSkewness:")
print(numeric_df.skew())
print("\nKurtosis:")
print(numeric_df.kurtosis())
# Percentile analysis
print("\nPercentiles for Age:")
print(df['age'].quantile([0.25, 0.5, 0.75, 0.95, 0.99]))
# Missing data patterns
missing_pct = (df.isnull().sum() / len(df) * 100)
missing_pct[missing_pct > 0].sort_values(ascending=False)
# Value count analysis
print("\nCustomer Types Distribution:")
print(df['customer_type'].value_counts(normalize=True))
# Advanced EDA: Groupby analysis
print("\nGroupBy Analysis:")
print(df.groupby('region')[['age', 'income']].agg(['mean', 'median', 'std']))
# Correlation with target variable
if 'target' in df.columns:
target_corr = df.corr()['target'].sort_values(ascending=False)
print("\nFeature Correlation with Target:")
print(target_corr)
# Data type breakdown
print("\nData Type Summary:")
print(df.dtypes.value_counts())
# Unique value count
print("\nUnique Value Counts:")
print(df.nunique().sort_values(ascending=False))
# Variance analysis
print("\nVariance per Feature:")
numeric_cols = df.select_dtypes(include=[np.number]).columns
for col in numeric_cols:
variance = df[col].var()
print(f" {col}: {variance:.2f}")
# Distribution patterns
for col in df.select_dtypes(include=[np.number]).columns:
skew = df[col].skew()
kurt = df[col].kurtosis()
print(f"{col} - Skew: {skew:.2f}, Kurtosis: {kurt:.2f}")
# Bivariate analysis
fig, axes = plt.subplots(1, 2, figsize=(12, 4))
df.groupby('region')['income'].mean().plot(kind='bar', ax=axes[0])
axes[0].set_title('Average Income by Region')
df.groupby('category')['age'].mean().plot(kind='bar', ax=axes[1])
axes[1].set_title('Average Age by Category')
plt.tight_layout()
plt.show()
# Summary statistics profile
print("\nComprehensive Data Profile:")
profile = {
'Variable': df.columns,
'Type': df.dtypes,
'Non-Null Count': df.count(),
'Null Count': df.isnull().sum(),
'Unique Values': df.nunique(),
}
profile_df = pd.DataFrame(profile)
print(profile_df)
```
## Advanced EDA Techniques
```python
# Step 15: Interaction analysis
import itertools
numeric_cols = df.select_dtypes(include=[np.number]).columns
interaction_strengths = []
for col1, col2 in itertools.combinations(numeric_cols[:5], 2):
interaction_score = abs(df[col1].corr(df[col2]))
interaction_strengths.append({
'Pair': f"{col1} × {col2}",
'Correlation': interaction_score,
})
interaction_df = pd.DataFrame(interaction_strengths).sort_values('Correlation', ascending=False)
print("\nTop Interactions:")
print(interaction_df.head())
# Step 16: Outlier summary
for col in numeric_cols:
Q1, Q3 = df[col].quantile([0.25, 0.75])
IQR = Q3 - Q1
outliers = df[(df[col] < Q1 - 1.5*IQR) | (df[col] > Q3 + 1.5*IQR)]
if len(outliers) > 0:
print(f"\n{col}: {len(outliers)} outliers detected ({len(outliers)/len(df)*100:.1f}%)")
# Step 17: Generate automated insights
print("\n" + "="*60)
print("AUTOMATED DATA INSIGHTS")
print("="*60)
for col in numeric_cols:
skewness = df[col].skew()
mean_val = df[col].mean()
median_val = df[col].median()
if abs(skewness) > 1:
direction = "right" if skewness > 0 else "left"
print(f"{col}: Highly {direction}-skewed distribution")
if abs(mean_val - median_val) > 0.1 * median_val:
print(f"{col}: Mean and median differ significantly")
print("="*60)
```
## Key Questions to Ask
1. What are the data dimensions and types?
2. How are key variables distributed?
3. What patterns exist between variables?
4. Are there obvious data quality issues?
5. What outliers or anomalies exist?
6. What hypotheses can we generate?
## Best Practices
- Start with data profiling before visualization
- Check data types and missing values early
- Visualize distributions before jumping to analysis
- Document interesting findings and anomalies
- Create summaries for stakeholder communication
- Use domain knowledge to interpret patterns
## Common Pitfalls
- Skipping data quality checks
- Over-interpreting patterns in small datasets
- Ignoring domain context
- Insufficient data visualization
- Not documenting findings systematically
## Deliverables
- Data quality report with missing values and duplicates
- Summary statistics and distribution charts
- Correlation and relationship visualizations
- List of notable patterns and anomalies
- Hypotheses for further investigation
- Data cleaning recommendations
© aj-geddes · MIT · aj-geddes/useful-ai-prompts