jaechang-hits/exploratory-data-analysis
>- Methodology for exploratory data analysis on scientific files. Decision frameworks by data type (tabular, sequence, image, spectral, structural, omics), quality assessment, report generation, format detection across 200+ formats. Use when given a data file for initial exploration or to pick an analysis before a pipeline.
npx skills add https://github.com/jaechang-hits/SciAgent-Skills --skill exploratory-data-analysis
Exploratory data analysis (EDA) is the systematic examination of scientific data files to understand their structure, content, quality, and characteristics before formal analysis. This knowhow covers methodology for detecting file types, selecting appropriate analysis approaches, assessing data quality, and generating comprehensive reports across all major scientific data domains.
| Category | Common Formats | Typical Analysis | Key Libraries |
|----------|---------------|-----------------|---------------|
| Tabular | CSV, TSV, XLSX, Parquet | Summary statistics, distributions, correlations, missing values | pandas, polars |
| Sequence | FASTA, FASTQ, SAM/BAM | Length distribution, quality scores, GC content, alignment stats | BioPython, pysam |
| Image/Microscopy | TIFF, ND2, CZI, DICOM | Dimensions (XYZCT), intensity stats, metadata, calibration | tifffile, aicsimageio, nd2reader |
| Spectral | mzML, SPC, JCAMP, FID | Peak detection, baseline, S/N ratio, resolution | pymzml, nmrglue, pyteomics |
| Structural | PDB, CIF, MOL, SDF | Atom counts, bond validation, B-factors, completeness | BioPython, RDKit, MDAnalysis |
| Array/Tensor | NPY, HDF5, Zarr, NetCDF | Shape, dtype, value range, NaN/Inf check, chunk structure | numpy, h5py, zarr, xarray |
| Omics | H5AD, MTX, VCF, BED | Feature/sample counts, sparsity, annotation completeness | scanpy, pyranges, cyvcf2 |
\x89HDF, GZIP: \x1f\x8b).ome.tiff, .nii.gz, .tar.gz by checking from the rightmost extension inwardData file received
├── What is the file type?
│ ├── Known extension → Look up in format reference
│ ├── Unknown extension → Magic bytes / content sniffing
│ └── Directory (e.g., .d, .zarr) → Check internal structure
│
├── What category does it belong to?
│ ├── Tabular → Summary stats, distributions, correlations
│ ├── Sequence → Length/quality distributions, composition
│ ├── Image → Dimensions, channels, intensity, metadata
│ ├── Spectral → Peaks, baseline, resolution, S/N
│ ├── Structural → Atom/bond validation, geometry checks
│ ├── Array → Shape, dtype, value range, sparsity
│ └── Omics → Feature counts, sample QC, annotation check
│
├── How large is the file?
│ ├── Small (<100 MB) → Load fully, comprehensive analysis
│ ├── Medium (100 MB–1 GB) → Sample or lazy evaluation
│ └── Large (>1 GB) → Stream/chunk, representative sampling
│
└── What is the analysis goal?
├── Pre-pipeline QC → Focus on completeness, format compliance
├── Data understanding → Statistics, distributions, patterns
├── Troubleshooting → Compare against expected format/values
└── Documentation → Full report with recommendations
| Data Type | First Check | Core Analysis | Visualization |
|-----------|------------|---------------|---------------|
| Tabular | dtypes, shape, nulls | describe(), correlations, outliers | histograms, scatter, heatmap |
| Sequence | record count, format | length dist., quality, composition | quality plots, length histogram |
| Image | dimensions, bit depth | intensity stats, channel info | thumbnail, histogram |
| Spectral | scan count, m/z range | peak detection, TIC, baseline | spectrum plot, TIC chromatogram |
| Structural | atom/residue count | B-factors, missing residues | Ramachandran, contact map |
| Array | shape, dtype | statistics, NaN check | slice visualization |
| Omics | genes × cells matrix | sparsity, QC metrics | violin plots, PCA |
pl.scan_parquet(), h5py dataset slicing, pysam indexed access prevent memory overflows10. Handle vendor-specific formats carefully — many instruments produce proprietary formats (.nd2, .czi, .raw). Document which reader library and version was used, as format support varies
pd.read_csv(engine='python') for robustness; check encoding with chardetNA, NaN, -999, empty string, #N/A, .. *How to avoid*: Specify na_values parameter; check for sentinel values in numeric columns10. Not checking for duplicates — duplicate records are common in merged datasets and database exports. *How to avoid*: Check for exact and near-duplicates early; report the duplication rate
.ome.tiff, .nii.gz)pip install command)Generate a structured markdown report containing:
Save as {original_filename}_eda_report.md.
references/file_format_reference.md — Quick-reference catalog of the most common scientific file formats across all 6 categories (bioinformatics, chemistry, microscopy, spectroscopy, proteomics/metabolomics, general), with extension, description, Python library, and key EDA approach for each formatNot migrated from original: The 6 category-specific format catalog files (3,616 lines total) contained detailed entries for 200+ formats. The bundled reference consolidates the ~50 most commonly encountered formats. For rare or vendor-specific formats, consult official library documentation.
Take jaechang-hits/exploratory-data-analysis from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference pip.
Without those the skill loads but fails at the first command.