gen-data-dict

Generate a JSON data dictionary describing variables in merged CSV, TSV, or Parquet datasets.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/bcmcpher/my-skills --skill gen-data-dict
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gen-data-dict
Source: https://github.com/bcmcpher/my-skills/tree/main/plugins/stat-analysis/skills/gen-data-dict
Command: npx skills add https://github.com/bcmcpher/my-skills --skill gen-data-dict

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool automatically generates a standardized, human-readable data dictionary for every variable in a merged or analysis-ready dataset, enabling consistent metadata documentation and sharing in BIDS-style formats.

Core Features & Use Cases

  • Annotates each column with a descriptive label, data type, cardinality, sample values, and null fraction.
  • Produces a JSON data dictionary named <input_stem>_data_dictionary.json that can be used for data governance, reproducibility, and data sharing.
  • Useful when preparing merged TSV/CSV or Parquet files for neuroimaging, clinical, or analytics projects, or when documenting a dataset for publication.

Quick Start

Provide a merged input file (e.g., merged.tsv) to generate the data dictionary in the same directory.

Frequently Asked Questions about gen-data-dict

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a data dictionary for a CSV or TSV dataset?▼

You can generate a data dictionary by providing a merged CSV, TSV, or Parquet file, which produces a JSON file annotating each variable with type, cardinality, sample values, and null fraction.

What is a BIDS-style data dictionary and when do I need one?▼

A BIDS-style data dictionary is a standardized JSON metadata file describing dataset variables. You need one for consistent data governance, sharing, and reproducibility in neuroimaging or clinical projects.

Does generating a data dictionary modify my original dataset file?▼

Generating a data dictionary does not modify your original file. It creates a separate JSON output named <input_stem>_data_dictionary.json in the same directory, leaving the source data untouched.

Can I use this tool to document a Parquet file for data governance?▼

Yes, you can document a Parquet file for data governance. The tool reads common tabular formats like Parquet and outputs a JSON dictionary with descriptive labels and null fractions for every column.

What metadata does an automated data dictionary capture for each column?▼

An automated data dictionary captures descriptive labels, data types, cardinality, sample values, and null fractions for each column, providing a comprehensive overview of your merged dataset's schema.

What happens if my merged dataset schema evolves after generating the dictionary?▼

If your merged dataset schema evolves, you can re-run the tool on the updated file to regenerate the JSON data dictionary, ensuring your metadata documentation stays synchronized with the current data structure.