bids

Organize neuroscience and biomedical data into BIDS-compliant directory structures.

Updated May 24, 2026
One-click install
npx skills add https://github.com/Estrella-231/Mathematical_modeling_tongmeng --skill bids-estrella-231
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bids
Source: https://github.com/Estrella-231/Mathematical_modeling_tongmeng/tree/main/.agents/skills/bids
Command: npx skills add https://github.com/Estrella-231/Mathematical_modeling_tongmeng --skill bids-estrella-231

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

BIDS reduces friction in sharing, searching, and processing neuroscience/biomedical datasets by enforcing a consistent directory structure and metadata conventions; this skill helps you validate compliance, query layouts, convert DICOM to BIDS, and manage derivatives.

Core Features & Use Cases

  • BIDS-compliant dataset structuring: Create or reorganize data using the required sub-*/datatype directory hierarchy and standardized filenames.
  • Query and metadata access: Use PyBIDS layout indexing to retrieve files by subject/session/task/run and read JSON sidecar metadata (with inheritance).
  • Validation and conversion: Run BIDS validation and convert DICOM to BIDS using common toolchains (HeuDiConv, dcm2bids, BIDScoin), including sidecar handling and derivatives setup.
  • Derivatives management: Produce and describe processed outputs under derivatives/ with correct dataset_description.json.

Quick Start

Use the bids skill to validate that your dataset at /path/to/bids_dataset follows the BIDS specification and report any compliance issues.

Frequently Asked Questions about bids

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

FAQPage Schema
How do I convert DICOM files to BIDS format for neuroimaging datasets?▼

To convert DICOM to BIDS, you can use common toolchains like HeuDiConv, dcm2bids, or BIDScoin to organize data into the required sub-* directory hierarchy while handling JSON metadata sidecars.

What is BIDS validation and how does it check dataset compliance?▼

BIDS validation checks your dataset's compliance with the BIDS specification by enforcing the correct directory hierarchy, standardized filenames, and required root-level dataset_description.json metadata.

How do I query and access BIDS metadata using PyBIDS?▼

PyBIDS layout indexing allows you to retrieve files by subject, session, task, or run parameters and read JSON sidecar metadata while respecting the inheritance principle across the dataset.

How do I organize processed neuroimaging outputs as BIDS derivatives?▼

To manage BIDS derivatives, place processed outputs under the derivatives/ directory and describe them with a correct dataset_description.json file to ensure proper downstream sharing and analysis.

Can I use BIDS to organize multiple neuroimaging modalities like MRI, EEG, and PET?▼

Yes, BIDS supports organizing common modalities including MRI, EEG, MEG, PET, microscopy, and behavioral records by enforcing a consistent directory structure and metadata conventions across all data types.

Why does my BIDS dataset fail validation when checking metadata sidecars?▼

BIDS validation fails when the dataset lacks correct root-level dataset_description metadata, violates the sub-* directory hierarchy, or contains JSON sidecar inheritance errors that do not match the specification.