Claude Code Skills · 论文 · 数据分析

results-analysis

Results Analysis 是一个面向论文实验数据分析的 Claude Code 技能。它读取 CSV、JSON、TensorBoard 日志等格式的数据,做均值、标准差、置信区间等统计摘要,并运行 t 检验、ANOVA 等显著性检验。输出包括结果文本与可直接用于论文的图表。适用于做完模型对比实验后整理数据、生成 Results 章节初稿。

Use when analyzing experimental results, validating comparisons, generating paper-ready results text, or turning model-evaluation outputs into figures, tables, and defensible claims.

Repo
Chanw-research/claude-code-paper-writing
Slug
results-analysis

SKILL.md

Results Analysis for ML/AI Research

A systematic experimental results analysis workflow connecting experimental data to paper writing.

Core Features

This skill provides three core capabilities:

  1. Experimental Data Analysis - Read and analyze experimental data in various formats
  2. Statistical Validation - Perform statistical significance tests and performance comparisons
  3. Paper Content Generation - Generate text and visualizations for the Results section

When to Use

Use this skill when you need to:

  • Analyze experimental results (CSV, JSON, TensorBoard logs)
  • Generate the Results section of a paper
  • Compare performance across multiple models
  • Perform statistical significance tests
  • Create publication-quality visualizations
  • Validate the reliability of experimental results

Workflow

Standard Analysis Pipeline

Data Loading → Data Validation → Statistical Analysis → Visualization → Writing → Quality Check

Step 1: Data Loading and Validation

Supported Data Formats:

  • CSV files - Tabular data
  • JSON files - Structured results
  • TensorBoard logs - Training curves
  • Python pickle - Complex objects

Data Validation Checks:

  • Completeness check - Missing values, outliers
  • Consistency check - Data format, units
  • Reproducibility check - Random seeds, version info

Select appropriate tools for data loading and preliminary validation based on data format.

Step 2: Statistical Analysis

Basic Statistics:

  • Mean
  • Standard Deviation
  • Standard Error
  • Confidence Interval

Significance Tests:

  • t-test - Two-group comparison
  • ANOVA - Multi-group comparison
  • Wilcoxon test - Non-parametric test
  • Bonferroni correction - Multiple comparison correction

Select appropriate statistical tests based on data characteristics.

Key Principles:

  • Report complete statistical information (mean ± std/SE)
  • Specify the test method and significance level used
  • Report p-values and effect sizes
  • Consider multiple comparison issues

See references/statistical-methods.md for the complete statistical methods guide.

Step 3: Model Performance Comparison

Comparison Dimensions:

  • Accuracy/Performance metrics
  • Training time/Inference speed
  • Model complexity/Parameter count
  • Robustness/Generalization ability

Comparison Methods:

  • Baseline comparison - Compare with existing methods
  • Ablation study - Validate component contributions
  • Cross-dataset validation - Test generalization

Systematically compare performance across different methods, ensuring fair comparison.

Step 4: Visualization

Publication-Quality Visualization Requirements:

  • Vector format (PDF/EPS)
  • Colorblind-friendly palette
  • Clear labels and legends
  • Appropriate error bars
  • Readable in black-and-white print

Common Chart Types:

  • Line chart - Training curves, trend analysis
  • Bar chart - Performance comparison
  • Box plot - Distribution display
  • Heatmap - Correlation analysis
  • Scatter plot - Relationship display

Use appropriate visualization tools to generate publication-quality figures.

See references/visualization-best-practices.md for the visualization guide.

Step 5: Writing the Results Section

Results Section Structure:

## Results

### Overview of Main Findings
[1-2 paragraphs summarizing core results]

### Experimental Setup
[Brief description of experimental configuration; details in appendix]

### Performance Comparison
[Comparison with baseline methods, including tables and figures]

### Ablation Study
[Validate contributions of each component]

### Statistical Significance
[Report statistical test results]

### Qualitative Analysis
[Case studies, visualization examples]

Writing Principles:

  • Clearly state the hypothesis each experiment validates
  • Guide readers to observe key phenomena: "Figure X shows..."
  • Report complete statistical information
  • Honestly report limitations

See references/results-writing-guide.md for the complete writing guide.

Step 6: Quality Check

Checklist:

  • All values include error bars/confidence intervals
  • Statistical test methods are specified
  • Figures are clear and readable (including black-and-white print)
  • Hyperparameter search ranges are reported
  • Computational resources are specified (GPU type, time)
  • Random seed settings are specified
  • Results are reproducible (code/data available)

Common Mistakes and Pitfalls

Statistical Errors

Wrong approach:

  • Reporting only the best results (cherry-picking)
  • Confusing standard deviation and standard error
  • Not reporting statistical significance
  • Not correcting for multiple comparisons

Correct approach:

  • Report all experimental results
  • Clearly specify whether standard deviation or standard error is used
  • Perform appropriate statistical tests
  • Use Bonferroni or similar correction methods

Visualization Errors

Wrong approach:

  • Using non-colorblind-friendly palettes
  • Y-axis not starting from 0 (exaggerating differences)
  • Missing error bars
  • Overly complex figures

Correct approach:

  • Use Okabe-Ito or Paul Tol palettes
  • Set reasonable axis ranges
  • Include error bars and confidence intervals
  • Keep figures clean and clear

Writing Errors

Wrong approach:

  • Over-interpreting results
  • Not describing experimental setup
  • Hiding negative results
  • Missing statistical information

Correct approach:

  • Objectively describe observed phenomena
  • Provide sufficient experimental details
  • Honestly report all results
  • Report complete statistical information

See references/common-pitfalls.md for the complete error patterns and fixes.

Integration with Paper Writing

Collaboration with Writing Skills

This skill focuses on experimental results analysis and works in tandem with the writing skills in this repository:

results-analysis handles:

  • Data analysis and statistical tests
  • Visualization generation
  • Results interpretation

scientific-writing or conference-paper-writing handle:

  • Complete paper structure
  • Citation integration
  • Venue-specific framing and formatting

Workflow Integration:

Experiments complete → results-analysis analyzes
    ↓
Generate analysis report and visualizations
    ↓
scientific-writing or conference-paper-writing integrates into paper
    ↓
Complete Results section

Output Format

After analysis, the following are generated:

  1. Analysis Report (analysis-report.md)

    • Statistical summary
    • Key findings
    • Suggested figures
  2. Visualization Files (figures/)

    • PDF format figures
    • Standalone figure captions
  3. Results Draft (results-draft.md)

    • Text ready for direct use in the paper
    • Includes figure references

Examples and Templates

Example Files

Refer to the examples/ directory for complete examples:

  • example-analysis-report.md - Complete analysis report example
  • example-results-section.md - Paper Results section example

Workflow Overview

The complete analysis pipeline includes:

  1. Data Loading - Read results from experiment output files
  2. Statistical Analysis - Compute basic statistics and perform significance tests
  3. Visualization - Create publication-quality figures
  4. Report Generation - Integrate analysis results and visualizations

See the guides in the references/ directory for detailed methods and best practices.

Reference Resources

Detailed Guides

  • references/statistical-methods.md - Complete statistical methods guide
  • references/results-writing-guide.md - Results section writing standards
  • references/visualization-best-practices.md - Visualization best practices
  • references/common-pitfalls.md - Common errors and fixes

External Resources

同一分类的其他项