Home / cuhk-aim-group / neurodiscovery · skills/freesurfer-tool/SKILL.md · GitHub

freesurfer-tool skillA

freesurfer-tool is agent-read markdown (skill) from cuhk-aim-group/neurodiscovery: Use this skill whenever the user wants to process structural MRI data (T1w, T2w, FLAIR, etc.) with FreeSurfer, especially for cortical/subcortical segmentation, surface reconstruction, parcellation, cortical thickness, volume statistics, or full recon-all pipeline. Triggers include: 'freesurfer', 'recon-all', 'segment MRI', 'FreeSurfer processing', 'cortical segmentation', 'subcortical segmentation', 'run recon-all', 'freesurfer T1', 'process brain MRI with freesurfer', 'aseg aparc', or any requ.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# FreeSurfer Tool

## Overview

FreeSurfer is the gold-standard open-source suite for automated reconstruction of the brain’s cortical surface from structural MRI, including skull-stripping, intensity normalization, Talairach registration, cortical parcellation (Desikan-Killiany / Destrieux atlases), subcortical segmentation (`aseg`), surface mesh generation, cortical thickness estimation, and statistics.

This skill serves as the **NeuroClaw interface-layer wrapper** for FreeSurfer and strictly follows the hierarchical design:

1. Check whether FreeSurfer is installed (`recon-all --version`, `$FREESURFER_HOME` environment variable).  
2. If not found → immediately invoke `dependency-planner` to plan and (after user confirmation) install the latest stable FreeSurfer release + license setup.  
3. Collect and confirm: input NIfTI file(s), subject ID, output `SUBJECTS_DIR`, desired stages/flags (e.g. `-all`, `-autorecon1..3`, `-T2`, `-FLAIR`, `-parallel`).  
4. Generate a clear, numbered execution plan including exact shell commands.  
5. Present plan, estimated runtime, disk/RAM requirements, and risks → wait for explicit user confirmation (“YES” / “execute” / “proceed”).
…

Read the whole file at its exact version.

How to install

Latest version
mdr add cuhk-aim-group/neurodiscovery/freesurfer-tool@git:20260506.86420c0
Exact content
mdr add cuhk-aim-group/neurodiscovery/freesurfer-tool@sha256:f0c7f0cb3ba914f1

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mffov2s6w6wuqk6l.svg)](https://markdownregistry.com/a/art_mffov2s6w6wuqk6l)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260506.86420c0 latest2026-05-06 86420c0 12,789 BA view · diff
git:20260505.e9ddd222026-05-05 e9ddd22 12,798 BA view · diff
git:20260505.1bbc12b2026-05-05 1bbc12b 12,741 BA view · diff
git:20260404.fa7f3542026-04-04 fa7f354 11,981 BA view · diff
git:20260328.891ed932026-03-28 891ed93 10,312 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12789 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cuhk-aim-group/neurodiscovery · 91 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mffov2s6w6wuqk6l
GET https://markdownregistry.com/api/v1/resolve?ref=cuhk-aim-group/neurodiscovery/freesurfer-tool
GET https://markdownregistry.com/api/v1/blob/f0c7f0cb3ba914f1ca677ff539885b92d0237d331f7480eac350295a3ff53eca

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from cuhk-aim-group/neurodiscovery

abcd-skill skill
cuhk-aim-group/neurodiscovery · skills/abcd-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the ABCD Study dataset, including controlled access…
git:20260825.f7533a2 · audit A · 91 stars
abide-skill skill
cuhk-aim-group/neurodiscovery · skills/abide-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the ABIDE (Autism Brain Imaging Data Exchange)…
git:20260505.e9ddd22 · audit A · 91 stars
academic-research-hub skill
cuhk-aim-group/neurodiscovery · skills/academic-research-hub/SKILL.md · Use this skill when users need to search academic papers, download research documents, extract citations, or gather…
git:20260506.86420c0 · audit A · 91 stars
adhd200-skill skill
cuhk-aim-group/neurodiscovery · skills/adhd200-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the ADHD-200 dataset, including download, BIDS…
git:20260505.e9ddd22 · audit A · 91 stars
adni-skill skill
cuhk-aim-group/neurodiscovery · skills/adni-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for ADNI or ADNI-DOD data, including controlled LONI IDA…
git:20260825.f7533a2 · audit A · 91 stars
aibl-skill skill
cuhk-aim-group/neurodiscovery · skills/aibl-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the AIBL (Australian Imaging, Biomarkers and…
git:20260506.f8d0216 · audit A · 91 stars
aomic-skill skill
cuhk-aim-group/neurodiscovery · skills/aomic-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the AOMIC (Amsterdam Open MRI Collection) dataset…
git:20260506.f8d0216 · audit A · 91 stars
asl-skill skill
cuhk-aim-group/neurodiscovery · skills/asl-skill/SKILL.md · Use this skill whenever the user wants to process Arterial Spin Labeling (ASL) perfusion MRI data including CBF…
git:20260506.f8d0216 · audit A · 91 stars
beautiful-log skill
cuhk-aim-group/neurodiscovery · skills/beautiful-log/SKILL.md · Use this skill after a conversation or task is completed when the user wants a clean, beautiful HTML chat log. It keeps…
git:20260506.86420c0 · audit A · 91 stars
bids-organizer skill
cuhk-aim-group/neurodiscovery · skills/bids-organizer/SKILL.md · Use this skill whenever the user wants to automatically organize raw neuroimaging data (DICOM, NIfTI, EEG, etc.) into a…
git:20260506.86420c0 · audit A · 91 stars
bnt skill
cuhk-aim-group/neurodiscovery · skills/bnt/SKILL.md · Use this model doc whenever the user wants to run BrainNetworkTransformer for fMRI phenotype prediction, including data…
git:20260515.bfd8dae · audit A · 91 stars
bold5000-skill skill
cuhk-aim-group/neurodiscovery · skills/bold5000-skill/SKILL.md · Use this skill whenever the user wants an end-to-end workflow for the BOLD5000 dataset, including download, BIDS…
git:20260505.e9ddd22 · audit A · 91 stars

Every file in cuhk-aim-group/neurodiscovery

Browse by kind, by grade A, or by owner.