bids-specification

Validate neuroimaging and behavioral dataset organization against BIDS layout and naming conventions.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/MarvinCui/NeuroForge --skill bids-specification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bids-specification
Source: https://github.com/MarvinCui/NeuroForge/tree/main/NeuroForge/skills/bids-specification
Command: npx skills add https://github.com/MarvinCui/NeuroForge --skill bids-specification

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The bids-specification skill helps you determine whether a neuro/behavioral dataset is organized and described according to BIDS conventions, so you can reduce downstream mistakes in preprocessing, derivatives, and quality control.

Core Features & Use Cases

  • BIDS layout & naming guidance: Check how subjects/sessions/modality folders, filenames, entities, and extensions should be structured.
  • Metadata completeness & consistency: Assess whether required sidecars and key metadata (e.g., dataset_description, events, participants, derivatives conventions) are present and coherent.
  • Modality-aware routing & planning: Use the skill to route an analysis question toward the right tool family and identify what references to consult first.

Quick Start

Use the bids-specification skill to audit your BIDS dataset layout and metadata completeness for a specific modality by describing the folder structure and filenames you have.

Frequently Asked Questions about bids-specification

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

FAQPage Schema
How do I validate BIDS dataset structure and metadata for neuroimaging files?

BIDS dataset validation involves checking folder layouts, filename entities, and extensions for structural compliance. It also requires verifying that required metadata sidecars and key files like participants.tsv and events.tsv are present and coherent.

What metadata files are required for a valid BIDS dataset?

Required BIDS metadata includes the dataset_description.json file for global context, participants.tsv for subject listings, and events.tsv for behavioral task timing. These files must be present and consistent to ensure downstream preprocessing accuracy.

How do I name and organize derivatives in a BIDS compliant dataset?

BIDS derivatives should be organized using provenance and naming conventions that align with the source dataset structure. This involves applying modality-aware routing to maintain consistent entity ordering and metadata relationships across processed outputs.

Can I use BIDS specification guidance for EEG and MEG data organization?

Yes, BIDS specification guidance supports modality-aware routing for EEG, MEG, fMRI, DWI, and behavioral experiments. It helps route analysis questions toward the correct tool family and identifies the right references for each specific neuroimaging modality.

When do I need to perform a BIDS dataset audit before preprocessing?

You need a BIDS dataset audit when planning safe data processing to prevent downstream mistakes in quality control. It validates metadata completeness and structural organization, ensuring safety guardrails are met before heavy processing begins.