@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.
Files changed (229) hide show
  1. package/dist/index.d.ts +6 -0
  2. package/dist/index.d.ts.map +1 -0
  3. package/dist/index.js +28 -0
  4. package/dist/index.js.map +1 -0
  5. package/package.json +35 -0
  6. package/skills/01_Meta-Skills/contribute-skill/SKILL.md +277 -0
  7. package/skills/01_Meta-Skills/contribute-skills-via-pr/SKILL.md +163 -0
  8. package/skills/01_Meta-Skills/paper-to-skill/SKILL.md +435 -0
  9. package/skills/01_Meta-Skills/paper-to-skill/references/extraction-guide.md +286 -0
  10. package/skills/01_Meta-Skills/paper-to-skill/references/skill-template.md +250 -0
  11. package/skills/01_Meta-Skills/repo-to-skill/SKILL.md +289 -0
  12. package/skills/01_Meta-Skills/share-case/SKILL.md +253 -0
  13. package/skills/01_Meta-Skills/share-usage/README.md +63 -0
  14. package/skills/01_Meta-Skills/share-usage/SKILL.md +395 -0
  15. package/skills/01_Meta-Skills/verify-skill/SKILL.md +331 -0
  16. package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/SKILL.md +194 -0
  17. package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/effect-sizes.md +352 -0
  18. package/skills/02_Cross-Domain_Foundation/cogsci-power-analysis/references/sample-size-guide.md +407 -0
  19. package/skills/02_Cross-Domain_Foundation/cogsci-statistics/SKILL.md +361 -0
  20. package/skills/02_Cross-Domain_Foundation/cogsci-statistics/references/common-analyses.md +517 -0
  21. package/skills/02_Cross-Domain_Foundation/cogsci-visualization/SKILL.md +292 -0
  22. package/skills/02_Cross-Domain_Foundation/cogsci-visualization/references/plot-recipes.md +709 -0
  23. package/skills/02_Cross-Domain_Foundation/research-literacy/SKILL.md +286 -0
  24. package/skills/02_Cross-Domain_Foundation/research-literacy/references/common-assumptions.md +320 -0
  25. package/skills/02_Cross-Domain_Foundation/research-literacy/references/planning-template.md +143 -0
  26. package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/SKILL.md +197 -0
  27. package/skills/03_Cognitive_Psychology/alternative-uses-task-designer/references/instruction-templates.md +60 -0
  28. package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/SKILL.md +246 -0
  29. package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/classic-paradigms.md +435 -0
  30. package/skills/03_Cognitive_Psychology/cognitive-paradigm-design/references/design-principles.md +256 -0
  31. package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/SKILL.md +270 -0
  32. package/skills/03_Cognitive_Psychology/creativity-self-efficacy-mediation/references/lavaan-templates.md +172 -0
  33. package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/SKILL.md +238 -0
  34. package/skills/03_Cognitive_Psychology/divergent-thinking-scoring/references/scoring-rubric.md +143 -0
  35. package/skills/03_Cognitive_Psychology/drift-diffusion-model/SKILL.md +203 -0
  36. package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/fitting-guide.md +571 -0
  37. package/skills/03_Cognitive_Psychology/drift-diffusion-model/references/model-variants.md +427 -0
  38. package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/SKILL.md +310 -0
  39. package/skills/03_Cognitive_Psychology/evidence-accumulation-selector/references/ez-diffusion-formulas.md +137 -0
  40. package/skills/03_Cognitive_Psychology/signal-detection-analysis/SKILL.md +300 -0
  41. package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/application-guide.md +278 -0
  42. package/skills/03_Cognitive_Psychology/signal-detection-analysis/references/sdt-formulas.md +318 -0
  43. package/skills/03_Cognitive_Psychology/visual-search-array-generator/SKILL.md +283 -0
  44. package/skills/03_Cognitive_Psychology/visual-search-array-generator/references/array-generation-parameters.yaml +111 -0
  45. package/skills/04_Psycholinguistics/reading-time-analysis/SKILL.md +301 -0
  46. package/skills/04_Psycholinguistics/reading-time-analysis/references/measure-computation-guide.md +195 -0
  47. package/skills/04_Psycholinguistics/self-paced-reading-designer/SKILL.md +257 -0
  48. package/skills/04_Psycholinguistics/self-paced-reading-designer/references/analysis-guide.md +356 -0
  49. package/skills/04_Psycholinguistics/self-paced-reading-designer/references/region-segmentation.md +266 -0
  50. package/skills/04_Psycholinguistics/sentence-stimulus-norming/SKILL.md +346 -0
  51. package/skills/04_Psycholinguistics/sentence-stimulus-norming/references/lexical-databases-guide.md +184 -0
  52. package/skills/05_EEG_ERP/eeg-paradigm-designer/SKILL.md +226 -0
  53. package/skills/05_EEG_ERP/eeg-paradigm-designer/references/component-paradigm-map.md +276 -0
  54. package/skills/05_EEG_ERP/eeg-paradigm-designer/references/timing-parameters.md +244 -0
  55. package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/SKILL.md +367 -0
  56. package/skills/05_EEG_ERP/eeg-preprocessing-pipeline-guide/references/parameter-lookup-tables.md +138 -0
  57. package/skills/05_EEG_ERP/erp-analysis/SKILL.md +185 -0
  58. package/skills/05_EEG_ERP/erp-analysis/references/erp-components.md +447 -0
  59. package/skills/05_EEG_ERP/erp-analysis/references/preprocessing-pipeline.md +277 -0
  60. package/skills/05_EEG_ERP/erp-analysis/references/statistical-approaches.md +351 -0
  61. package/skills/05_EEG_ERP/mne-python-guide/SKILL.md +174 -0
  62. package/skills/05_EEG_ERP/mne-python-guide/references/decoding.md +178 -0
  63. package/skills/05_EEG_ERP/mne-python-guide/references/io_formats.md +160 -0
  64. package/skills/05_EEG_ERP/mne-python-guide/references/preprocessing.md +259 -0
  65. package/skills/05_EEG_ERP/mne-python-guide/references/simulation.md +173 -0
  66. package/skills/05_EEG_ERP/mne-python-guide/references/source_localization.md +234 -0
  67. package/skills/05_EEG_ERP/mne-python-guide/references/statistics.md +196 -0
  68. package/skills/05_EEG_ERP/mne-python-guide/references/time_frequency.md +165 -0
  69. package/skills/05_EEG_ERP/mne-python-guide/references/visualization.md +175 -0
  70. package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/SKILL.md +317 -0
  71. package/skills/06_fMRI_Neuroimaging/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
  72. package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/SKILL.md +296 -0
  73. package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/design-matrix-guide.md +214 -0
  74. package/skills/06_fMRI_Neuroimaging/fmri-glm-analysis-guide/references/statistical-inference.md +288 -0
  75. package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/SKILL.md +274 -0
  76. package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/quality-control.md +336 -0
  77. package/skills/06_fMRI_Neuroimaging/fmri-preprocessing-pipeline-guide/references/step-by-step-pipeline.md +380 -0
  78. package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/SKILL.md +264 -0
  79. package/skills/06_fMRI_Neuroimaging/fmri-task-design-guide/references/design-optimization-examples.md +114 -0
  80. package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/SKILL.md +273 -0
  81. package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/decoding-methods.md +170 -0
  82. package/skills/06_fMRI_Neuroimaging/neural-decoding-analysis/references/rsa-guide.md +266 -0
  83. package/skills/06_fMRI_Neuroimaging/pycortex-guide/SKILL.md +123 -0
  84. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/database-subjects.md +179 -0
  85. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/dataset-types.md +208 -0
  86. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/freesurfer-fmriprep.md +162 -0
  87. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mapping-transforms.md +181 -0
  88. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/mni-utils.md +207 -0
  89. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/surface-analysis.md +219 -0
  90. package/skills/06_fMRI_Neuroimaging/pycortex-guide/references/visualization.md +251 -0
  91. package/skills/07_Computational_Modeling/act-r-model-builder/SKILL.md +297 -0
  92. package/skills/07_Computational_Modeling/act-r-model-builder/references/model-patterns.md +197 -0
  93. package/skills/07_Computational_Modeling/act-r-model-builder/references/parameter-table.yaml +204 -0
  94. package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/SKILL.md +294 -0
  95. package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/diagnostics-checklist.md +351 -0
  96. package/skills/07_Computational_Modeling/bayesian-cognitive-model-builder/references/prior-selection-guide.md +241 -0
  97. package/skills/07_Computational_Modeling/parameter-recovery-checker/SKILL.md +269 -0
  98. package/skills/07_Computational_Modeling/parameter-recovery-checker/references/recovery-diagnostics.md +207 -0
  99. package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/SKILL.md +317 -0
  100. package/skills/08_Computational_Neuroscience/brain-connectivity-modeler/references/method-implementation-guide.md +116 -0
  101. package/skills/08_Computational_Neuroscience/neural-decoding-analysis/SKILL.md +273 -0
  102. package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/decoding-methods.md +170 -0
  103. package/skills/08_Computational_Neuroscience/neural-decoding-analysis/references/rsa-guide.md +266 -0
  104. package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/SKILL.md +305 -0
  105. package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/data-requirements.md +60 -0
  106. package/skills/08_Computational_Neuroscience/neural-population-analysis-guide/references/method-comparison.md +151 -0
  107. package/skills/08_Computational_Neuroscience/spiking-network-model-builder/SKILL.md +376 -0
  108. package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/hh-parameters.md +117 -0
  109. package/skills/08_Computational_Neuroscience/spiking-network-model-builder/references/network-regimes.md +130 -0
  110. package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/SKILL.md +258 -0
  111. package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/indicator-parameters.md +242 -0
  112. package/skills/09_Cellular_Molecular_Neuroscience/calcium-imaging-analysis-guide/references/pipeline-details.md +211 -0
  113. package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/SKILL.md +261 -0
  114. package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/opsin-catalog.md +124 -0
  115. package/skills/09_Cellular_Molecular_Neuroscience/optogenetics-protocol-designer/references/stimulation-parameters.md +304 -0
  116. package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/SKILL.md +367 -0
  117. package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/disconnection-guide.md +152 -0
  118. package/skills/10_Clinical_Neuropsychology/lesion-symptom-mapping-guide/references/vlsm-pipeline.md +182 -0
  119. package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/SKILL.md +250 -0
  120. package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/deficit-profiles.md +302 -0
  121. package/skills/10_Clinical_Neuropsychology/neuropsych-battery-selector/references/test-catalog.md +304 -0
  122. package/skills/11_Developmental_Cognition/infant-looking-time-designer/SKILL.md +345 -0
  123. package/skills/11_Developmental_Cognition/infant-looking-time-designer/references/age-parameters.yaml +186 -0
  124. package/skills/12_Social_Cognition/tom-task-selector/SKILL.md +379 -0
  125. package/skills/12_Social_Cognition/tom-task-selector/references/task-database.md +317 -0
  126. package/skills/13_Visualization/nature-figure/README.md +442 -0
  127. package/skills/13_Visualization/nature-figure/SKILL.md +60 -0
  128. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-01-bar-charts.png +0 -0
  129. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-02-line-trends.png +0 -0
  130. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-03-heatmaps.png +0 -0
  131. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-04-scatter-bubble.png +0 -0
  132. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-05-radar-polar.png +0 -0
  133. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-06-distributions.png +0 -0
  134. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-07-forest-interval.png +0 -0
  135. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-08-area-stacked.png +0 -0
  136. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-09-image-plates.png +0 -0
  137. package/skills/13_Visualization/nature-figure/assets/chart-atlas/atlas-10-network-matrix.png +0 -0
  138. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_motivation.png +0 -0
  139. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation.png +0 -0
  140. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/Dispersion_observation_distillation.png +0 -0
  141. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_contrastive.png +0 -0
  142. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_CEDAR.png +0 -0
  143. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_results_IEDB.png +0 -0
  144. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/ImmunoStruct_schematic.png +0 -0
  145. package/skills/13_Visualization/nature-figure/assets/figures4papers/assets/RNAGenScape_schematic.png +0 -0
  146. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/ablation.png +0 -0
  147. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/figures/comparison.png +0 -0
  148. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_ablation.py +86 -0
  149. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_CellSpliceNet/plot_comparison.py +109 -0
  150. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/diffusion_swiss_roll.py +97 -0
  151. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/diffusion_swiss_roll.png +0 -0
  152. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.pdf +0 -0
  153. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_GeneRegulatory.png +0 -0
  154. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.pdf +0 -0
  155. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/fig2_comparison_Trajectory.png +0 -0
  156. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.pdf +0 -0
  157. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/figures/figX_comparison_Ablation.png +0 -0
  158. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Ablation.py +64 -0
  159. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_GeneRegulatory.py +74 -0
  160. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Cflows/plot_comparison_Trajectory.py +74 -0
  161. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/idea.png +0 -0
  162. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/figures/illustration.png +0 -0
  163. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_idea.py +76 -0
  164. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_Dispersion/plot_illustration.py +404 -0
  165. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/figures/freq_prior.png +0 -0
  166. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_FPGM/plot_freq_prior.py +146 -0
  167. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_Cancer.png +0 -0
  168. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_ablation_IEDB.png +0 -0
  169. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_Cancer.png +0 -0
  170. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/figures/bars_comparison_IEDB.png +0 -0
  171. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/plot_bars.py +216 -0
  172. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ImmunoStruct/raw_data.py +125 -0
  173. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold.png +0 -0
  174. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/manifold_holes.png +0 -0
  175. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_optimization.png +0 -0
  176. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_comparison_speed.png +0 -0
  177. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/figures/results_sweep.png +0 -0
  178. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_comparison.py +228 -0
  179. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_hole_manifold.py +82 -0
  180. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_manifold.py +61 -0
  181. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_RNAGenScape/plot_sweep.py +77 -0
  182. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_posttraining.png +0 -0
  183. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/figures/comparison_radar.png +0 -0
  184. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_comparison_radar.py +173 -0
  185. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_VIGIL/plot_posttraining.py +82 -0
  186. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/brute_force.png +0 -0
  187. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_category.png +0 -0
  188. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/correctness_by_subcategory.png +0 -0
  189. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/rewriting.png +0 -0
  190. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/figures/selfcorrection_math.png +0 -0
  191. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_brute_force.py +248 -0
  192. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_category.py +132 -0
  193. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_correctness_by_subcategory.py +131 -0
  194. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_rewriting.py +105 -0
  195. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_brainteaser/plot_selfcorrection_math.py +99 -0
  196. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/composition_heatmap.png +0 -0
  197. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/figures/trend_by_month.png +0 -0
  198. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_composition.py +81 -0
  199. package/skills/13_Visualization/nature-figure/assets/figures4papers/figure_ophthal_review/plot_trend.py +125 -0
  200. package/skills/13_Visualization/nature-figure/assets/gallery/fig1-material-mechanism-rich.png +0 -0
  201. package/skills/13_Visualization/nature-figure/assets/gallery/fig2-spatial-imaging-rich.png +0 -0
  202. package/skills/13_Visualization/nature-figure/assets/gallery/fig3-in-vivo-efficacy-rich.png +0 -0
  203. package/skills/13_Visualization/nature-figure/assets/gallery/fig4-single-cell-systems-rich.png +0 -0
  204. package/skills/13_Visualization/nature-figure/assets/gallery/fig5-validation-perturbation-rich.png +0 -0
  205. package/skills/13_Visualization/nature-figure/evals/evals.json +37 -0
  206. package/skills/13_Visualization/nature-figure/manifest.yaml +57 -0
  207. package/skills/13_Visualization/nature-figure/references/api.md +428 -0
  208. package/skills/13_Visualization/nature-figure/references/backend-selection.md +100 -0
  209. package/skills/13_Visualization/nature-figure/references/chart-types.md +281 -0
  210. package/skills/13_Visualization/nature-figure/references/common-patterns.md +350 -0
  211. package/skills/13_Visualization/nature-figure/references/demos.md +65 -0
  212. package/skills/13_Visualization/nature-figure/references/design-theory.md +436 -0
  213. package/skills/13_Visualization/nature-figure/references/figure-contract.md +93 -0
  214. package/skills/13_Visualization/nature-figure/references/nature-2026-observations.md +112 -0
  215. package/skills/13_Visualization/nature-figure/references/qa-contract.md +119 -0
  216. package/skills/13_Visualization/nature-figure/references/r-template-index.md +66 -0
  217. package/skills/13_Visualization/nature-figure/references/r-workflow.md +161 -0
  218. package/skills/13_Visualization/nature-figure/references/tutorials.md +251 -0
  219. package/skills/13_Visualization/nature-figure/static/core/contract.md +29 -0
  220. package/skills/13_Visualization/nature-figure/static/core/stance.md +37 -0
  221. package/skills/13_Visualization/nature-figure/static/fragments/backend/python.md +37 -0
  222. package/skills/13_Visualization/nature-figure/static/fragments/backend/r.md +44 -0
  223. package/skills/14_Writing/markdown-report-writing/SKILL.md +306 -0
  224. package/skills/14_Writing/markdown-report-writing/references/compatibility-matrix.md +72 -0
  225. package/skills/14_Writing/markdown-report-writing/references/templates.md +299 -0
  226. package/skills/15_Others/neuroimaging-power-guide/SKILL.md +324 -0
  227. package/skills/15_Others/neuroimaging-power-guide/references/effect-size-lookup-tables.md +102 -0
  228. package/skills/15_Others/neuroimaging-sample-size-calculator/SKILL.md +330 -0
  229. 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.