@brainpilot/skills 0.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +28 -0
- package/dist/index.js.map +1 -0
- package/package.json +35 -0
- package/skills/01_Meta-Skills/contribute-skill/SKILL.md +277 -0
- package/skills/01_Meta-Skills/contribute-skills-via-pr/SKILL.md +163 -0
- package/skills/01_Meta-Skills/paper-to-skill/SKILL.md +435 -0
- package/skills/01_Meta-Skills/paper-to-skill/references/extraction-guide.md +286 -0
- package/skills/01_Meta-Skills/paper-to-skill/references/skill-template.md +250 -0
- package/skills/01_Meta-Skills/repo-to-skill/SKILL.md +289 -0
- package/skills/01_Meta-Skills/share-case/SKILL.md +253 -0
- package/skills/01_Meta-Skills/share-usage/README.md +63 -0
- package/skills/01_Meta-Skills/share-usage/SKILL.md +395 -0
- package/skills/01_Meta-Skills/verify-skill/SKILL.md +331 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/SKILL.md +194 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/effect-sizes.md +352 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/sample-size-guide.md +407 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-statistics/SKILL.md +361 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-statistics/references/common-analyses.md +517 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-visualization/SKILL.md +292 -0
- package/skills/02_Cross-Domain_Foundation/cogsci-visualization/references/plot-recipes.md +709 -0
- package/skills/02_Cross-Domain_Foundation/research-literacy/SKILL.md +286 -0
- package/skills/02_Cross-Domain_Foundation/research-literacy/references/common-assumptions.md +320 -0
- package/skills/02_Cross-Domain_Foundation/research-literacy/references/planning-template.md +143 -0
- package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/SKILL.md +197 -0
- package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/references/instruction-templates.md +60 -0
- package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/SKILL.md +246 -0
- package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/classic-paradigms.md +435 -0
- package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/design-principles.md +256 -0
- package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/SKILL.md +270 -0
- package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/references/lavaan-templates.md +172 -0
- package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/SKILL.md +238 -0
- package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/references/scoring-rubric.md +143 -0
- package/skills/03_Cognitive_Psychology/drift-diffusion-model/SKILL.md +203 -0
- package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/fitting-guide.md +571 -0
- package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/model-variants.md +427 -0
- package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/SKILL.md +310 -0
- package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/references/ez-diffusion-formulas.md +137 -0
- package/skills/03_Cognitive_Psychology/signal-detection-analysis/SKILL.md +300 -0
- package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/application-guide.md +278 -0
- package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/sdt-formulas.md +318 -0
- package/skills/03_Cognitive_Psychology/visual-search-array-generator/SKILL.md +283 -0
- package/skills/03_Cognitive_Psychology/visual-search-array-generator/references/array-generation-parameters.yaml +111 -0
- package/skills/04_Psycholinguistics/reading-time-analysis/SKILL.md +301 -0
- package/skills/04_Psycholinguistics/reading-time-analysis/references/measure-computation-guide.md +195 -0
- package/skills/04_Psycholinguistics/self-paced-reading-designer/SKILL.md +257 -0
- package/skills/04_Psycholinguistics/self-paced-reading-designer/references/analysis-guide.md +356 -0
- package/skills/04_Psycholinguistics/self-paced-reading-designer/references/region-segmentation.md +266 -0
- package/skills/04_Psycholinguistics/sentence-stimulus-norming/SKILL.md +346 -0
- package/skills/04_Psycholinguistics/sentence-stimulus-norming/references/lexical-databases-guide.md +184 -0
- package/skills/05_EEG_ERP/eeg-paradigm-designer/SKILL.md +226 -0
- package/skills/05_EEG_ERP/eeg-paradigm-designer/references/component-paradigm-map.md +276 -0
- package/skills/05_EEG_ERP/eeg-paradigm-designer/references/timing-parameters.md +244 -0
- package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/SKILL.md +367 -0
- package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/references/parameter-lookup-tables.md +138 -0
- package/skills/05_EEG_ERP/erp-analysis/SKILL.md +185 -0
- package/skills/05_EEG_ERP/erp-analysis/references/erp-components.md +447 -0
- package/skills/05_EEG_ERP/erp-analysis/references/preprocessing-pipeline.md +277 -0
- package/skills/05_EEG_ERP/erp-analysis/references/statistical-approaches.md +351 -0
- package/skills/05_EEG_ERP/mne-python-guide/SKILL.md +174 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/decoding.md +178 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/io_formats.md +160 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/preprocessing.md +259 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/simulation.md +173 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/source_localization.md +234 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/statistics.md +196 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/time_frequency.md +165 -0
- package/skills/05_EEG_ERP/mne-python-guide/references/visualization.md +175 -0
- package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/SKILL.md +317 -0
- package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
- package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/SKILL.md +296 -0
- package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/design-matrix-guide.md +214 -0
- package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/statistical-inference.md +288 -0
- package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/SKILL.md +274 -0
- package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/quality-control.md +336 -0
- package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/step-by-step-pipeline.md +380 -0
- package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/SKILL.md +264 -0
- package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/references/design-optimization-examples.md +114 -0
- package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/SKILL.md +273 -0
- package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/decoding-methods.md +170 -0
- package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/rsa-guide.md +266 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/SKILL.md +123 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/database-subjects.md +179 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/dataset-types.md +208 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/freesurfer-fmriprep.md +162 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mapping-transforms.md +181 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mni-utils.md +207 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/surface-analysis.md +219 -0
- package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/visualization.md +251 -0
- package/skills/07_Computational_Modeling/act-r-model-builder/SKILL.md +297 -0
- package/skills/07_Computational_Modeling/act-r-model-builder/references/model-patterns.md +197 -0
- package/skills/07_Computational_Modeling/act-r-model-builder/references/parameter-table.yaml +204 -0
- package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/SKILL.md +294 -0
- package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/diagnostics-checklist.md +351 -0
- package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/prior-selection-guide.md +241 -0
- package/skills/07_Computational_Modeling/parameter-recovery-checker/SKILL.md +269 -0
- package/skills/07_Computational_Modeling/parameter-recovery-checker/references/recovery-diagnostics.md +207 -0
- package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/SKILL.md +317 -0
- package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
- package/skills/08_Computational_Neuroscience/neural-decoding-analysis/SKILL.md +273 -0
- package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/decoding-methods.md +170 -0
- package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/rsa-guide.md +266 -0
- package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/SKILL.md +305 -0
- package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/data-requirements.md +60 -0
- package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/method-comparison.md +151 -0
- package/skills/08_Computational_Neuroscience/spiking-network-model-builder/SKILL.md +376 -0
- package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/hh-parameters.md +117 -0
- package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/network-regimes.md +130 -0
- package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/SKILL.md +258 -0
- package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/indicator-parameters.md +242 -0
- package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/pipeline-details.md +211 -0
- package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/SKILL.md +261 -0
- package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/opsin-catalog.md +124 -0
- package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/stimulation-parameters.md +304 -0
- package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/SKILL.md +367 -0
- package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/disconnection-guide.md +152 -0
- package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/vlsm-pipeline.md +182 -0
- package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/SKILL.md +250 -0
- package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/deficit-profiles.md +302 -0
- package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/test-catalog.md +304 -0
- package/skills/11_Developmental_Cognition/infant-looking-time-designer/SKILL.md +345 -0
- package/skills/11_Developmental_Cognition/infant-looking-time-designer/references/age-parameters.yaml +186 -0
- package/skills/12_Social_Cognition/tom-task-selector/SKILL.md +379 -0
- package/skills/12_Social_Cognition/tom-task-selector/references/task-database.md +317 -0
- package/skills/13_Visualization/nature-figure/README.md +442 -0
- package/skills/13_Visualization/nature-figure/SKILL.md +60 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-01-bar-charts.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-02-line-trends.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-03-heatmaps.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-04-scatter-bubble.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-05-radar-polar.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-06-distributions.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-07-forest-interval.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-08-area-stacked.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-09-image-plates.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-10-network-matrix.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_motivation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation_distillation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_contrastive.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_CEDAR.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_IEDB.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_schematic.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/RNAGenScape_schematic.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/ablation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/comparison.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_ablation.py +86 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_comparison.py +109 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/diffusion_swiss_roll.py +97 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/diffusion_swiss_roll.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.pdf +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.pdf +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.pdf +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Ablation.py +64 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_GeneRegulatory.py +74 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Trajectory.py +74 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/idea.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/illustration.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_idea.py +76 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_illustration.py +404 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/figures/freq_prior.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/plot_freq_prior.py +146 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_Cancer.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_IEDB.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_Cancer.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_IEDB.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/plot_bars.py +216 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/raw_data.py +125 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold_holes.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_optimization.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_speed.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_sweep.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_comparison.py +228 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_hole_manifold.py +82 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_manifold.py +61 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_sweep.py +77 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_posttraining.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_radar.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_comparison_radar.py +173 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_posttraining.py +82 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/brute_force.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_category.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_subcategory.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/rewriting.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/selfcorrection_math.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_brute_force.py +248 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_category.py +132 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_subcategory.py +131 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_rewriting.py +105 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_selfcorrection_math.py +99 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/composition_heatmap.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/trend_by_month.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_composition.py +81 -0
- package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_trend.py +125 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig1-material-mechanism-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig2-spatial-imaging-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig3-in-vivo-efficacy-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig4-single-cell-systems-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/assets/gallery/fig5-validation-perturbation-rich.png +0 -0
- package/skills/13_Visualization/nature-figure/evals/evals.json +37 -0
- package/skills/13_Visualization/nature-figure/manifest.yaml +57 -0
- package/skills/13_Visualization/nature-figure/references/api.md +428 -0
- package/skills/13_Visualization/nature-figure/references/backend-selection.md +100 -0
- package/skills/13_Visualization/nature-figure/references/chart-types.md +281 -0
- package/skills/13_Visualization/nature-figure/references/common-patterns.md +350 -0
- package/skills/13_Visualization/nature-figure/references/demos.md +65 -0
- package/skills/13_Visualization/nature-figure/references/design-theory.md +436 -0
- package/skills/13_Visualization/nature-figure/references/figure-contract.md +93 -0
- package/skills/13_Visualization/nature-figure/references/nature-2026-observations.md +112 -0
- package/skills/13_Visualization/nature-figure/references/qa-contract.md +119 -0
- package/skills/13_Visualization/nature-figure/references/r-template-index.md +66 -0
- package/skills/13_Visualization/nature-figure/references/r-workflow.md +161 -0
- package/skills/13_Visualization/nature-figure/references/tutorials.md +251 -0
- package/skills/13_Visualization/nature-figure/static/core/contract.md +29 -0
- package/skills/13_Visualization/nature-figure/static/core/stance.md +37 -0
- package/skills/13_Visualization/nature-figure/static/fragments/backend/python.md +37 -0
- package/skills/13_Visualization/nature-figure/static/fragments/backend/r.md +44 -0
- package/skills/14_Writing/markdown-report-writing/SKILL.md +306 -0
- package/skills/14_Writing/markdown-report-writing/references/compatibility-matrix.md +72 -0
- package/skills/14_Writing/markdown-report-writing/references/templates.md +299 -0
- package/skills/15_Others/neuroimaging-power-guide/SKILL.md +324 -0
- package/skills/15_Others/neuroimaging-power-guide/references/effect-size-lookup-tables.md +102 -0
- package/skills/15_Others/neuroimaging-sample-size-calculator/SKILL.md +330 -0
- package/skills/15_Others/neuroimaging-sample-size-calculator/references/worked-examples.md +220 -0
|
@@ -0,0 +1,331 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "verify-skill"
|
|
3
|
+
description: "Interactive skill verification — assess accuracy of parameters, citations, and methodology through structured expert review"
|
|
4
|
+
domain: "meta-skill"
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
review_status: "ai-generated"
|
|
7
|
+
dependencies:
|
|
8
|
+
required:
|
|
9
|
+
- research-literacy
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Verify Skill
|
|
13
|
+
|
|
14
|
+
## Purpose
|
|
15
|
+
|
|
16
|
+
This meta-skill guides domain experts through a structured verification of any skill in this repository. It produces a detailed verification report that records the expert's assessment of parameters, citations, and methodology — then submits the report to GitHub Discussions for community knowledge building.
|
|
17
|
+
|
|
18
|
+
Verification is the **highest-impact contribution** a domain expert can make. Every skill starts as `ai-generated` and needs human verification to progress to `community-reviewed` or `expert-verified`.
|
|
19
|
+
|
|
20
|
+
## When to Use This Skill
|
|
21
|
+
|
|
22
|
+
Activate when the user:
|
|
23
|
+
|
|
24
|
+
- Says "verify a skill", "验证这个 skill", "review this skill's accuracy"
|
|
25
|
+
- Wants to check whether a skill's parameters and citations are correct
|
|
26
|
+
- Has domain expertise and wants to contribute a verification
|
|
27
|
+
- Is reviewing a skill before using it in their research
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Research Planning Protocol
|
|
32
|
+
|
|
33
|
+
Before starting the verification process, you MUST:
|
|
34
|
+
|
|
35
|
+
1. **Identify the target skill** — Which skill will be verified? Read its SKILL.md.
|
|
36
|
+
2. **Assess the reviewer's qualifications** — What is their domain expertise and experience level?
|
|
37
|
+
3. **Define verification scope** — Will this be a full verification or focused on specific sections?
|
|
38
|
+
4. **Note inherent limitations** — Verification without lab replication cannot confirm all claims; flag what can and cannot be verified from literature alone.
|
|
39
|
+
5. **Present the verification plan to the user and WAIT for confirmation** before proceeding.
|
|
40
|
+
|
|
41
|
+
For detailed methodology guidance, see `skills/research-literacy/SKILL.md`.
|
|
42
|
+
|
|
43
|
+
## ⚠️ Verification Notice
|
|
44
|
+
|
|
45
|
+
This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please [open an issue](https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/issues).
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## Prerequisites
|
|
50
|
+
|
|
51
|
+
Before running this skill, verify:
|
|
52
|
+
|
|
53
|
+
1. **`gh` CLI is installed and authenticated**
|
|
54
|
+
|
|
55
|
+
Run: `gh auth status`
|
|
56
|
+
|
|
57
|
+
If not authenticated, tell the user:
|
|
58
|
+
> To submit verification reports, you need the GitHub CLI. Install it from https://cli.github.com/ and run `gh auth login`.
|
|
59
|
+
> Alternatively, I can save the report as a local markdown file.
|
|
60
|
+
|
|
61
|
+
2. **The target skill exists** — The skill directory must exist under `skills/` in the repository.
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## Interactive Flow (6 Phases)
|
|
66
|
+
|
|
67
|
+
### Progress Tracking (Required)
|
|
68
|
+
|
|
69
|
+
**At the start of the verification, you MUST create a task list** (using TodoWrite or equivalent) with these items:
|
|
70
|
+
|
|
71
|
+
- [ ] Phase 1: Cognitive Alignment
|
|
72
|
+
- [ ] Phase 2: Experience Collection
|
|
73
|
+
- [ ] Phase 3: Test Scenario Construction
|
|
74
|
+
- [ ] Phase 4: Item-by-Item Assessment
|
|
75
|
+
- [ ] Phase 5: Apply Corrections to Skill
|
|
76
|
+
- [ ] Phase 6: Generate Report and Submit to GitHub Discussions ← **DO NOT SKIP**
|
|
77
|
+
|
|
78
|
+
**Mark each item as you complete it.** Do NOT consider the verification complete until ALL items are checked, especially Phase 6 (GitHub submission).
|
|
79
|
+
|
|
80
|
+
### Phase 1 — Cognitive Alignment
|
|
81
|
+
|
|
82
|
+
**Goal:** Ensure the reviewer understands what the skill does before assessing it.
|
|
83
|
+
|
|
84
|
+
1. **Read the target skill's SKILL.md** in full.
|
|
85
|
+
|
|
86
|
+
2. **Present a summary to the reviewer:**
|
|
87
|
+
- What this skill does (purpose and domain)
|
|
88
|
+
- Typical use scenarios (when it triggers)
|
|
89
|
+
- Key parameters and claims it makes (list the specific numbers and citations)
|
|
90
|
+
- What verification means in this context
|
|
91
|
+
|
|
92
|
+
3. **Ask the reviewer:** "Does this summary match your understanding of the skill? Anything to clarify before we proceed?"
|
|
93
|
+
|
|
94
|
+
4. **Wait for confirmation** before moving to Phase 2.
|
|
95
|
+
|
|
96
|
+
> **Next → Phase 2: Experience Collection** (4 remaining phases until GitHub submission)
|
|
97
|
+
|
|
98
|
+
### Phase 2 — Experience Collection
|
|
99
|
+
|
|
100
|
+
**Goal:** Understand the reviewer's domain knowledge to calibrate the verification.
|
|
101
|
+
|
|
102
|
+
Present these questions:
|
|
103
|
+
|
|
104
|
+
**Q1: How familiar are you with this domain?** (1-5)
|
|
105
|
+
- 1 = Heard of it
|
|
106
|
+
- 2 = Read about it
|
|
107
|
+
- 3 = Studied it formally
|
|
108
|
+
- 4 = Use it in my research
|
|
109
|
+
- 5 = I am a specialist in this area
|
|
110
|
+
|
|
111
|
+
**Q2: Have you used these methods in your research?**
|
|
112
|
+
- Yes, I use them regularly (describe briefly)
|
|
113
|
+
- Yes, I have used them before (describe context)
|
|
114
|
+
- No, but I know the literature well
|
|
115
|
+
- No, I am learning about this area
|
|
116
|
+
|
|
117
|
+
**Q3: For the key parameters listed in Phase 1, what values do you typically use?**
|
|
118
|
+
- Present each key parameter from the skill and ask the reviewer what value they use or expect
|
|
119
|
+
- This is a per-parameter question — iterate through the most important parameters
|
|
120
|
+
- Accept "I don't know" as a valid answer
|
|
121
|
+
|
|
122
|
+
**Q4: What pitfalls have you encountered that this skill should mention?**
|
|
123
|
+
- Free text — any practical warnings from experience
|
|
124
|
+
|
|
125
|
+
> **Next → Phase 3: Test Scenario Construction** (3 remaining phases until GitHub submission)
|
|
126
|
+
|
|
127
|
+
### Phase 3 — Test Scenario Construction
|
|
128
|
+
|
|
129
|
+
**Goal:** Test the skill against a realistic scenario to evaluate its practical advice.
|
|
130
|
+
|
|
131
|
+
1. **Ask the reviewer to describe a scenario:**
|
|
132
|
+
> "Describe a real or realistic dataset and research question where you would use the methods covered by this skill. Include: modality, sample size, conditions, and what you are trying to find."
|
|
133
|
+
|
|
134
|
+
2. **Run the target skill** against this scenario (simulate how the skill would respond to the described research question).
|
|
135
|
+
|
|
136
|
+
3. **Present the skill's recommendations** for this scenario.
|
|
137
|
+
|
|
138
|
+
4. **Ask the reviewer to evaluate:**
|
|
139
|
+
- Did the skill give appropriate recommendations for this scenario?
|
|
140
|
+
- Were there any incorrect suggestions?
|
|
141
|
+
- What important advice was missing?
|
|
142
|
+
|
|
143
|
+
> **Next → Phase 4: Item-by-Item Assessment** (2 remaining phases until GitHub submission)
|
|
144
|
+
|
|
145
|
+
### Phase 4 — Item-by-Item Assessment
|
|
146
|
+
|
|
147
|
+
**Goal:** Systematic parameter-by-parameter verification with structured scoring.
|
|
148
|
+
|
|
149
|
+
For each key claim in the skill (parameters, thresholds, citations, methodological recommendations), present a table row and ask the reviewer to assess:
|
|
150
|
+
|
|
151
|
+
**Assessment format:**
|
|
152
|
+
|
|
153
|
+
| # | Parameter | Skill Says | Citation | Your Verdict | Notes |
|
|
154
|
+
|---|-----------|-----------|----------|-------------|-------|
|
|
155
|
+
| 1 | [param name] | [value from skill] | [cited source] | ✅ / ⚠️ / ❌ / ❓ | [reviewer's explanation] |
|
|
156
|
+
| 2 | ... | ... | ... | ... | ... |
|
|
157
|
+
|
|
158
|
+
**Verdict options:**
|
|
159
|
+
- ✅ **Confirmed** — The value and citation are correct
|
|
160
|
+
- ⚠️ **Context-dependent** — Correct in some contexts but not universally; needs qualification
|
|
161
|
+
- ❌ **Incorrect** — The value or citation is wrong (reviewer provides the correct information)
|
|
162
|
+
- ❓ **Cannot verify** — The reviewer does not have enough expertise or resources to confirm
|
|
163
|
+
|
|
164
|
+
**Process each parameter interactively** — present 3-5 parameters at a time, get the reviewer's verdicts, then continue with the next batch.
|
|
165
|
+
|
|
166
|
+
After all parameters are assessed, collect **overall ratings** (1-5 stars each):
|
|
167
|
+
|
|
168
|
+
1. **Parameter accuracy** — Are the numerical values and thresholds correct?
|
|
169
|
+
2. **Completeness** — Does the skill cover all important aspects of this methodology?
|
|
170
|
+
3. **Practical usefulness** — Would this skill actually help a researcher do better work?
|
|
171
|
+
4. **Pitfall awareness** — Does the skill warn about common mistakes and edge cases?
|
|
172
|
+
|
|
173
|
+
> **⚠️ CRITICAL: Do NOT stop here. Next → Phase 5: Apply Corrections, then Phase 6: Submit to GitHub Discussions. The verification is NOT complete without submission.**
|
|
174
|
+
|
|
175
|
+
### Phase 5 — Apply Corrections
|
|
176
|
+
|
|
177
|
+
**Goal:** Update the skill based on verification findings.
|
|
178
|
+
|
|
179
|
+
If Phase 4 produced any ❌ (Incorrect) or ⚠️ (Context-dependent) verdicts:
|
|
180
|
+
|
|
181
|
+
1. **List all corrections needed** — Summarize what parameters, citations, or methodology need updating based on the reviewer's verdicts.
|
|
182
|
+
|
|
183
|
+
2. **Apply corrections to the skill's SKILL.md:**
|
|
184
|
+
- Fix incorrect parameter values (replace with reviewer-provided values and citations)
|
|
185
|
+
- Add missing caveats or context qualifications for ⚠️ items
|
|
186
|
+
- Update citations where the reviewer identified errors
|
|
187
|
+
- Add pitfalls and warnings from the reviewer's experience (Phase 2 Q4)
|
|
188
|
+
|
|
189
|
+
3. **Update the skill's `review_status`** in the YAML frontmatter:
|
|
190
|
+
- If the reviewer's familiarity was 4-5 → set to `"expert-verified"`
|
|
191
|
+
- If the reviewer's familiarity was 2-3 → set to `"community-reviewed"`
|
|
192
|
+
- If the reviewer's familiarity was 1 → keep as `"ai-generated"`
|
|
193
|
+
|
|
194
|
+
4. **Commit the changes** with a descriptive message, e.g.: `fix: update [skill-name] parameters per expert verification`
|
|
195
|
+
|
|
196
|
+
5. **Present the diff to the reviewer** for confirmation.
|
|
197
|
+
|
|
198
|
+
If Phase 4 produced NO corrections needed (all ✅), skip to Phase 6 but still update `review_status` if appropriate.
|
|
199
|
+
|
|
200
|
+
> **⚠️ CRITICAL: You are NOT done. You MUST proceed to Phase 6 to submit the verification report to GitHub Discussions.**
|
|
201
|
+
|
|
202
|
+
### Phase 6 — Report Generation and Submission
|
|
203
|
+
|
|
204
|
+
**Goal:** Generate a structured verification report and submit it to GitHub Discussions.
|
|
205
|
+
|
|
206
|
+
1. **Generate the verification report** using the format below.
|
|
207
|
+
|
|
208
|
+
2. **Present the complete report** to the reviewer. Present options:
|
|
209
|
+
- **Approve all** — Submit as shown
|
|
210
|
+
- **Delete sections** — Remove specific sections
|
|
211
|
+
- **Anonymize** — Replace identifying information (name, institution) with generic descriptions
|
|
212
|
+
- **Save locally only** — Save without submitting to GitHub
|
|
213
|
+
- **Abort** — Cancel without saving
|
|
214
|
+
|
|
215
|
+
3. **Wait for explicit confirmation** before submitting.
|
|
216
|
+
|
|
217
|
+
4. **Submit to GitHub Discussions** in the "Verification" category.
|
|
218
|
+
|
|
219
|
+
**Submission command:**
|
|
220
|
+
|
|
221
|
+
```bash
|
|
222
|
+
gh api graphql -f query='
|
|
223
|
+
mutation {
|
|
224
|
+
createDiscussion(input: {
|
|
225
|
+
repositoryId: "REPO_ID",
|
|
226
|
+
categoryId: "VERIFICATION_CATEGORY_ID",
|
|
227
|
+
title: "Verification Report: SKILL_NAME",
|
|
228
|
+
body: "REPORT_BODY_HERE"
|
|
229
|
+
}) {
|
|
230
|
+
discussion {
|
|
231
|
+
url
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
}'
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
**To get the required IDs:**
|
|
238
|
+
|
|
239
|
+
```bash
|
|
240
|
+
gh api graphql -f query='
|
|
241
|
+
{
|
|
242
|
+
repository(owner: "HaoxuanLiTHUAI", name: "awesome_cognitive_and_neuroscience_skills") {
|
|
243
|
+
id
|
|
244
|
+
discussionCategories(first: 10) {
|
|
245
|
+
nodes {
|
|
246
|
+
id
|
|
247
|
+
name
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
}'
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
After successful submission, display the Discussion URL to the reviewer.
|
|
255
|
+
|
|
256
|
+
**If submission fails:** Save the report to `~/.cache/awesome-neuro-skills/pending-verifications/YYYY-MM-DD-skill-name.md` and provide manual submission instructions.
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
## Verification Report Format
|
|
261
|
+
|
|
262
|
+
```markdown
|
|
263
|
+
## Verification Report: [skill-name]
|
|
264
|
+
|
|
265
|
+
### Reviewer Profile
|
|
266
|
+
- **Domain**: [e.g., "cognitive neuroscience"]
|
|
267
|
+
- **Experience**: [e.g., "5 years EEG research"]
|
|
268
|
+
- **Familiarity with this topic**: [1-5 from Q1]
|
|
269
|
+
- **Context**: [e.g., "currently running oddball paradigm study"]
|
|
270
|
+
|
|
271
|
+
### Verification Scenario
|
|
272
|
+
> [Description of the test scenario used in Phase 3]
|
|
273
|
+
|
|
274
|
+
### Skill Evaluation Against Scenario
|
|
275
|
+
> [Summary of how well the skill performed on the test scenario]
|
|
276
|
+
|
|
277
|
+
### Parameter Review
|
|
278
|
+
| # | Parameter | Skill Says | Citation | Verdict | Notes |
|
|
279
|
+
|---|-----------|-----------|----------|---------|-------|
|
|
280
|
+
| 1 | [param] | [value] | [citation] | ✅/⚠️/❌/❓ | [explanation] |
|
|
281
|
+
|
|
282
|
+
### Expert Insights
|
|
283
|
+
> [Reviewer's professional knowledge that supplements or corrects the skill — from Q3, Q4, and Phase 3 feedback]
|
|
284
|
+
|
|
285
|
+
### Overall Scores
|
|
286
|
+
| Dimension | Score |
|
|
287
|
+
|-----------|-------|
|
|
288
|
+
| Parameter accuracy | [1-5 stars] |
|
|
289
|
+
| Completeness | [1-5 stars] |
|
|
290
|
+
| Practical usefulness | [1-5 stars] |
|
|
291
|
+
| Pitfall awareness | [1-5 stars] |
|
|
292
|
+
|
|
293
|
+
### Suggested Improvements
|
|
294
|
+
- [Concrete suggestions for updates to the skill]
|
|
295
|
+
|
|
296
|
+
---
|
|
297
|
+
*Submitted via the `verify-skill` meta-skill.*
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
---
|
|
301
|
+
|
|
302
|
+
## Verification Depth Guidance
|
|
303
|
+
|
|
304
|
+
### What CAN be verified from literature
|
|
305
|
+
|
|
306
|
+
- Whether a cited paper exists and the citation is correct
|
|
307
|
+
- Whether the cited paper actually recommends the stated parameter value
|
|
308
|
+
- Whether the methodology matches current field consensus
|
|
309
|
+
- Whether important caveats or alternatives are mentioned
|
|
310
|
+
|
|
311
|
+
### What CANNOT be verified without lab work
|
|
312
|
+
|
|
313
|
+
- Whether specific parameter values are optimal for all datasets
|
|
314
|
+
- Whether the pipeline actually produces valid results on real data
|
|
315
|
+
- Whether edge cases and failure modes are exhaustively covered
|
|
316
|
+
|
|
317
|
+
Flag this distinction clearly in the report.
|
|
318
|
+
|
|
319
|
+
---
|
|
320
|
+
|
|
321
|
+
## Completion Checklist
|
|
322
|
+
|
|
323
|
+
**Before considering this verification COMPLETE, you MUST confirm ALL of the following:**
|
|
324
|
+
|
|
325
|
+
- [ ] Skill SKILL.md has been updated with corrections (if any ❌/⚠️ verdicts in Phase 4)
|
|
326
|
+
- [ ] `review_status` has been updated in the skill's YAML frontmatter
|
|
327
|
+
- [ ] Changes have been committed to git
|
|
328
|
+
- [ ] Verification report has been submitted to GitHub Discussions (or saved locally if `gh` is unavailable)
|
|
329
|
+
- [ ] Discussion URL (or local file path) has been shown to the reviewer
|
|
330
|
+
|
|
331
|
+
**If any item above is unchecked, GO BACK and complete it now. Do NOT end the conversation.**
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "cogsci-power-analysis"
|
|
3
|
+
description: "Domain-specific statistical power analysis guidance for cognitive and neuroscience research, encoding effect size priors and sample size recommendations by modality"
|
|
4
|
+
domain: "research-methods"
|
|
5
|
+
version: "1.0.0"
|
|
6
|
+
papers:
|
|
7
|
+
- "Brysbaert, 2019"
|
|
8
|
+
- "Lakens, 2022"
|
|
9
|
+
- "Button et al., 2013"
|
|
10
|
+
- "Marek et al., 2022"
|
|
11
|
+
- "Boudewyn et al., 2018"
|
|
12
|
+
dependencies:
|
|
13
|
+
required:
|
|
14
|
+
- research-literacy
|
|
15
|
+
review_status: "ai-generated"
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
# Cognitive Science Power Analysis
|
|
19
|
+
|
|
20
|
+
## Purpose
|
|
21
|
+
|
|
22
|
+
This skill encodes domain-specific knowledge for planning adequately powered studies in cognitive science and neuroscience. It provides:
|
|
23
|
+
|
|
24
|
+
- **Effect size priors** calibrated to specific paradigms and modalities (behavioral, EEG/ERP, fMRI, clinical/developmental)
|
|
25
|
+
- **Sample size recommendations** grounded in empirical meta-analyses rather than arbitrary conventions
|
|
26
|
+
- **Power analysis workflow guidance** tailored to the design complexities of cognitive neuroscience (repeated measures, multilevel, neuroimaging-specific tools)
|
|
27
|
+
|
|
28
|
+
An AI agent needs this because generic power analysis advice (e.g., "use G*Power with d = 0.5") fails to capture the enormous variability in effect sizes across cognitive science paradigms, and because neuroimaging modalities have unique statistical considerations.
|
|
29
|
+
|
|
30
|
+
## When to Use This Skill
|
|
31
|
+
|
|
32
|
+
- A researcher is designing a new behavioral, EEG, or fMRI experiment and needs sample size justification
|
|
33
|
+
- A grant proposal requires a power analysis section
|
|
34
|
+
- A preregistration document needs effect size justification and sample size rationale
|
|
35
|
+
- Someone asks "how many participants do I need?" for a cognitive/neuroscience study
|
|
36
|
+
- Reviewing whether a published study was adequately powered
|
|
37
|
+
|
|
38
|
+
## Research Planning Protocol
|
|
39
|
+
|
|
40
|
+
Before executing the domain-specific steps below, you MUST:
|
|
41
|
+
|
|
42
|
+
1. **State the research question** — What study is being planned and what effect is being powered for?
|
|
43
|
+
2. **Justify the method choice** — Why this design and analysis approach? What alternatives were considered?
|
|
44
|
+
3. **Declare expected outcomes** — What is the smallest effect size of interest (SESOI)?
|
|
45
|
+
4. **Note assumptions and limitations** — What assumptions does this power analysis make? Where could it mislead?
|
|
46
|
+
5. **Present the plan to the user and WAIT for confirmation** before proceeding.
|
|
47
|
+
|
|
48
|
+
For detailed methodology guidance, see the `research-literacy` skill.
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
## ⚠️ Verification Notice
|
|
52
|
+
|
|
53
|
+
This skill was generated by AI from academic literature. All parameters, thresholds, and citations require independent verification before use in research. If you find errors, please [open an issue](https://github.com/HaoxuanLiTHUAI/awesome_cognitive_and_neuroscience_skills/issues).
|
|
54
|
+
|
|
55
|
+
## Core Workflow
|
|
56
|
+
|
|
57
|
+
### Step 1: Identify the Research Modality and Design
|
|
58
|
+
|
|
59
|
+
Determine which modality and design type apply:
|
|
60
|
+
|
|
61
|
+
| Modality | Common Designs | Key Consideration |
|
|
62
|
+
|----------|---------------|-------------------|
|
|
63
|
+
| Behavioral | Between-groups, within-subjects, mixed | Effect sizes vary enormously by paradigm |
|
|
64
|
+
| EEG/ERP | Within-subjects repeated measures | Trial count matters as much as participant count |
|
|
65
|
+
| fMRI (task) | Within-subjects block/event-related | Whole-brain vs. ROI analysis affects power |
|
|
66
|
+
| fMRI (individual differences) | Correlational, between-subjects | Requires much larger N than task contrasts |
|
|
67
|
+
| Clinical/Developmental | Case-control, longitudinal | Recruitment constraints often limit N; adjust design |
|
|
68
|
+
|
|
69
|
+
### Step 2: Obtain an Effect Size Prior
|
|
70
|
+
|
|
71
|
+
**Do not use generic benchmarks** (Cohen's "small/medium/large"). Instead:
|
|
72
|
+
|
|
73
|
+
1. **Best option**: Use a meta-analytic estimate for the specific paradigm. See `references/effect-sizes.md` for a curated library organized by modality.
|
|
74
|
+
2. **Second option**: Use the smallest effect size of interest (SESOI) — the minimum effect that would be theoretically or practically meaningful (Lakens, 2022).
|
|
75
|
+
3. **Third option**: Use pilot data, but apply shrinkage correction — pilot studies systematically overestimate effect sizes (Albers & Lakens, 2018).
|
|
76
|
+
4. **Last resort**: Use the modality-specific median effect sizes from large-scale meta-analyses (see below).
|
|
77
|
+
|
|
78
|
+
**Modality-level median effect sizes (use only when paradigm-specific estimates are unavailable):**
|
|
79
|
+
|
|
80
|
+
| Modality | Median Effect Size | Source |
|
|
81
|
+
|----------|--------------------|--------|
|
|
82
|
+
| Behavioral (cognitive psychology) | d = 0.40 | Brysbaert, 2019 |
|
|
83
|
+
| EEG/ERP component differences | d = 0.50 - 1.00 | Boudewyn et al., 2018; Clayson et al., 2019 |
|
|
84
|
+
| fMRI task activation | d = 0.75 - 1.00 (within-subject) | Poldrack et al., 2017 |
|
|
85
|
+
| fMRI brain-behavior correlation | r = 0.10 - 0.20 | Marek et al., 2022 |
|
|
86
|
+
| Clinical group differences | d = 0.30 - 0.80 | Leucht et al., 2015; Button et al., 2013 |
|
|
87
|
+
|
|
88
|
+
> **Critical warning**: The median statistical power in neuroscience has been estimated at only **21%** (Button et al., 2013, Nature Reviews Neuroscience). Many published effect sizes are inflated by publication bias. Always apply skepticism to effect sizes from underpowered, unreplicated studies.
|
|
89
|
+
|
|
90
|
+
### Step 3: Conduct the Power Analysis
|
|
91
|
+
|
|
92
|
+
Choose method based on design complexity:
|
|
93
|
+
|
|
94
|
+
#### Simple Designs (t-test, one-way ANOVA, correlation)
|
|
95
|
+
|
|
96
|
+
Use **analytic solutions** via G*Power or pwr (R):
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
Target: 80% power (minimum) or 90% power (recommended)
|
|
100
|
+
Alpha: 0.05 (two-tailed unless directional hypothesis is justified)
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
- Two-sample t-test: `pwr.t.test(d = effect_size, power = 0.80, sig.level = 0.05, type = "two.sample")`
|
|
104
|
+
- Within-subjects t-test: `pwr.t.test(d = effect_size_dz, power = 0.80, sig.level = 0.05, type = "paired")`
|
|
105
|
+
- Correlation: `pwr.r.test(r = effect_size, power = 0.80, sig.level = 0.05)`
|
|
106
|
+
|
|
107
|
+
#### Complex Designs (mixed ANOVA, multilevel, mediation)
|
|
108
|
+
|
|
109
|
+
Use **simulation-based power analysis**:
|
|
110
|
+
|
|
111
|
+
- **simr** (R package): For linear mixed-effects models (Green & MacLeod, 2016)
|
|
112
|
+
- **Superpower** (R/Shiny): For factorial ANOVA designs (Lakens & Caldwell, 2021)
|
|
113
|
+
- **Monte Carlo simulation**: For non-standard designs — simulate data under the expected effect, run analysis, repeat 10,000+ times
|
|
114
|
+
|
|
115
|
+
#### Neuroimaging-Specific
|
|
116
|
+
|
|
117
|
+
- **fMRIpower**: Power for fMRI group analyses (Mumford & Nichols, 2008)
|
|
118
|
+
- **NeuroPowerTools**: Web-based fMRI power calculator (Durnez et al., 2016)
|
|
119
|
+
- **For EEG/ERP**: No standard tool; use simulation with expected component amplitudes and noise levels. See `references/sample-size-guide.md` for worked examples.
|
|
120
|
+
|
|
121
|
+
### Step 4: Apply Modality-Specific Rules of Thumb
|
|
122
|
+
|
|
123
|
+
Use these as **sanity checks**, not replacements for formal power analysis:
|
|
124
|
+
|
|
125
|
+
| Modality | Minimum N (per group/condition) | Basis |
|
|
126
|
+
|----------|-------------------------------|-------|
|
|
127
|
+
| Behavioral (medium effect, d ≈ 0.5) | n = 30-50 per group | Brysbaert, 2019 |
|
|
128
|
+
| Behavioral (small effect, d ≈ 0.2) | n = 80-100 per group | Brysbaert, 2019 |
|
|
129
|
+
| Behavioral (within-subjects, d_z ≈ 0.4) | n = 50-65 | Brysbaert, 2019 |
|
|
130
|
+
| EEG/ERP (within-subjects) | n = 25-40 | Boudewyn et al., 2018 |
|
|
131
|
+
| fMRI (task activation, within-subjects) | n = 30-50 | Cremers et al., 2017; Poldrack et al., 2017 |
|
|
132
|
+
| fMRI (individual differences / brain-behavior) | n = 100+ (ideally 200+) | Marek et al., 2022 |
|
|
133
|
+
| fMRI (clinical group comparison) | n = 30-50 per group | Button et al., 2013 |
|
|
134
|
+
| Clinical/patient studies | n = 20-30 per group (minimum) | Leucht et al., 2015 |
|
|
135
|
+
| Developmental (cross-sectional age groups) | n = 25-40 per age group | Mills & Tamnes, 2014 |
|
|
136
|
+
|
|
137
|
+
### Step 5: Document and Report
|
|
138
|
+
|
|
139
|
+
For preregistration and manuscripts, the power analysis section must include:
|
|
140
|
+
|
|
141
|
+
1. **Effect size used** and its source (meta-analysis, pilot, SESOI)
|
|
142
|
+
2. **Power analysis method** (analytic, simulation-based, tool used)
|
|
143
|
+
3. **Target power level** (80% or 90%) and alpha level
|
|
144
|
+
4. **Resulting sample size** and any adjustments (attrition, exclusion rate)
|
|
145
|
+
5. **Sensitivity analysis**: What is the minimum detectable effect at the planned N?
|
|
146
|
+
|
|
147
|
+
Template language:
|
|
148
|
+
|
|
149
|
+
> "Based on the meta-analytic effect size of d = [X] reported by [Author, Year], a power analysis using [tool] indicated that N = [X] participants per group would be needed to detect this effect with [80/90]% power at alpha = .05 (two-tailed). Anticipating a [X]% attrition/exclusion rate, we plan to recruit N = [adjusted X]."
|
|
150
|
+
|
|
151
|
+
## Common Pitfalls
|
|
152
|
+
|
|
153
|
+
1. **Using Cohen's generic benchmarks as effect size priors**: Cohen (1988) himself warned these were rough guidelines. Cognitive science effects range from d = 0.1 to d = 3.0+ depending on the paradigm. Always use paradigm-specific estimates (Brysbaert, 2019).
|
|
154
|
+
|
|
155
|
+
2. **Ignoring the distinction between d and d_z**: Between-subjects Cohen's d and within-subjects d_z are not interchangeable. Within-subjects designs typically yield larger d_z due to reduced error variance. Confusing them leads to incorrect sample size estimates (Lakens, 2013).
|
|
156
|
+
|
|
157
|
+
3. **Powering for whole-brain fMRI but reporting ROI results (or vice versa)**: Whole-brain analyses with multiple comparison correction require larger effects to survive thresholding. Power calculations must match the planned analysis (Mumford & Nichols, 2008).
|
|
158
|
+
|
|
159
|
+
4. **Treating pilot effect sizes as population estimates**: Pilot studies with N = 10-20 produce wildly variable effect size estimates. Apply a correction factor or use the lower bound of the CI (Albers & Lakens, 2018).
|
|
160
|
+
|
|
161
|
+
5. **Ignoring trial count in EEG/ERP power**: For ERP analyses, both participant N and trial count per condition affect statistical power. Insufficient trials per condition reduces signal-to-noise ratio regardless of participant count (Boudewyn et al., 2018; Luck, 2014).
|
|
162
|
+
|
|
163
|
+
6. **Assuming brain-behavior correlations are large**: Marek et al. (2022) demonstrated that brain-wide association studies require thousands of participants for reliable effects. Planning an fMRI individual-differences study with N = 30 is almost certainly underpowered.
|
|
164
|
+
|
|
165
|
+
## Quick Reference Decision Table
|
|
166
|
+
|
|
167
|
+
| Question | Answer | Recommended Action |
|
|
168
|
+
|----------|--------|--------------------|
|
|
169
|
+
| "How many subjects for a Stroop study?" | Within-subjects Stroop effect is very large (d ≈ 1.0-1.5) | N = 15-25 likely sufficient (Brysbaert, 2019) |
|
|
170
|
+
| "How many for an ERP study of N400?" | N400 semantic violation effect d ≈ 0.8-1.5 | N = 20-30 (Boudewyn et al., 2018) |
|
|
171
|
+
| "How many for fMRI brain-behavior correlation?" | True r likely 0.10-0.20 | N = 200+ minimum (Marek et al., 2022) |
|
|
172
|
+
| "How many for a patient vs. control comparison?" | Effects vary widely (d ≈ 0.3-0.8) | N = 30-80 per group depending on expected effect |
|
|
173
|
+
| "Can I use my pilot N=12 effect size?" | Pilot effect is unreliable | Use meta-analytic estimate instead; if unavailable, use lower CI bound of pilot |
|
|
174
|
+
|
|
175
|
+
## References
|
|
176
|
+
|
|
177
|
+
- Albers, C., & Lakens, D. (2018). When power analyses based on pilot data are biased. *Journal of Experimental Social Psychology*, 74, 187-195.
|
|
178
|
+
- Boudewyn, M. A., Luck, S. J., Farrens, J. L., & Kappenman, E. S. (2018). How many trials does it take to get a significant ERP effect? *Psychophysiology*, 55(6), e13049.
|
|
179
|
+
- Brysbaert, M. (2019). How many participants do we really need? *Journal of Cognition*, 2(1), 16.
|
|
180
|
+
- Button, K. S., Ioannidis, J. P. A., Mokrysz, C., Nosek, B. A., Flint, J., Robinson, E. S. J., & Munafo, M. R. (2013). Power failure: Why small sample size undermines the reliability of neuroscience. *Nature Reviews Neuroscience*, 14(5), 365-376.
|
|
181
|
+
- Clayson, P. E., Carbine, K. A., Baldwin, S. A., & Larson, M. J. (2019). Methodological reporting behavior, sample sizes, and statistical power in studies of event-related potentials. *Psychophysiology*, 56(11), e13437.
|
|
182
|
+
- Cremers, H. R., Wager, T. D., & Yarkoni, T. (2017). The relation between statistical power and inference in fMRI. *PLoS ONE*, 12(11), e0184923.
|
|
183
|
+
- Green, P., & MacLeod, C. J. (2016). SIMR: An R package for power analysis of generalized linear mixed models by simulation. *Methods in Ecology and Evolution*, 7(4), 493-498.
|
|
184
|
+
- Lakens, D. (2013). Calculating and reporting effect sizes to facilitate cumulative science. *Frontiers in Psychology*, 4, 863.
|
|
185
|
+
- Lakens, D. (2022). Sample size justification. *Collabra: Psychology*, 8(1), 33267.
|
|
186
|
+
- Lakens, D., & Caldwell, A. R. (2021). Simulation-based power analysis for factorial ANOVA designs. *Advances in Methods and Practices in Psychological Science*, 4(1).
|
|
187
|
+
- Leucht, S., Hierl, S., Kissling, W., Dold, M., & Davis, J. M. (2015). Putting the efficacy of psychiatric and general medicine medication into perspective. *British Journal of Psychiatry*, 200(2), 97-106.
|
|
188
|
+
- Luck, S. J. (2014). *An Introduction to the Event-Related Potential Technique* (2nd ed.). MIT Press.
|
|
189
|
+
- Marek, S., Tervo-Clemmens, B., Calabro, F. J., et al. (2022). Reproducible brain-wide association studies require thousands of individuals. *Nature*, 603, 654-660.
|
|
190
|
+
- Mills, K. L., & Tamnes, C. K. (2014). Methods and considerations for longitudinal structural brain imaging analysis across development. *Developmental Cognitive Neuroscience*, 9, 172-190.
|
|
191
|
+
- Mumford, J. A., & Nichols, T. E. (2008). Power calculation for group fMRI studies accounting for arbitrary design and temporal autocorrelation. *NeuroImage*, 39(1), 261-268.
|
|
192
|
+
- Poldrack, R. A., Baker, C. I., Durnez, J., et al. (2017). Scanning the horizon: Towards transparent and reproducible neuroimaging research. *Nature Reviews Neuroscience*, 18(2), 115-126.
|
|
193
|
+
|
|
194
|
+
See `references/effect-sizes.md` for the full effect size reference library and `references/sample-size-guide.md` for detailed sample size guidance by modality.
|