@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,266 @@
1
+ # Region Segmentation for Self-Paced Reading
2
+
3
+ This reference provides detailed guidance on how to segment sentences into reading regions for self-paced reading (SPR) experiments. Region boundaries are the most consequential design decision in SPR because they determine what can be measured and what will be confounded.
4
+
5
+ ---
6
+
7
+ ## Fundamental Principles
8
+
9
+ ### 1. Regions Must Respect Syntactic Constituency
10
+
11
+ Never split a region in the middle of a syntactic constituent. A region boundary within a noun phrase (e.g., splitting "the tall" from "man") forces participants to process an incomplete constituent, introducing processing difficulty that is an artifact of segmentation rather than a reflection of the intended manipulation (Jegerski, 2014).
12
+
13
+ **Good segmentation** (respects constituency):
14
+
15
+ ```
16
+ The maid | of the actress | who was | on the balcony | shouted | to the crowd.
17
+ ```
18
+
19
+ **Bad segmentation** (splits constituents):
20
+
21
+ ```
22
+ The maid of | the actress who | was on | the balcony shouted | to the | crowd.
23
+ ```
24
+
25
+ ### 2. Critical Regions Must Be Controlled
26
+
27
+ The critical region -- where you expect to observe a reading time difference between conditions -- must be matched across conditions on:
28
+
29
+ | Property | How to Match | Source for Norms |
30
+ |---|---|---|
31
+ | **Word length (characters)** | Within +/- 1 character across conditions | Count characters |
32
+ | **Lexical frequency** | Within 0.5 log10 units (SUBTLEX-US) | Brysbaert & New (2009); SUBTLEX-US database |
33
+ | **Number of syllables** | Same syllable count preferred | Standard dictionaries |
34
+ | **Morphological complexity** | Same number of morphemes preferred | Linguistic analysis |
35
+ | **Part of speech** | Identical across conditions | Linguistic analysis |
36
+ | **Orthographic neighborhood size** | Match if feasible | English Lexicon Project (Balota et al., 2007) |
37
+
38
+ If the same word appears in the critical region across all conditions (e.g., an ambiguity resolves on a word that is identical but disambiguates due to prior context), length and frequency matching is automatic. This is the ideal design.
39
+
40
+ ### 3. Pre-Critical and Post-Critical (Spillover) Regions Must Be Identical
41
+
42
+ The words immediately before and after the critical region should be character-for-character identical across conditions. This is essential because:
43
+
44
+ - **Pre-critical region**: Any difference here creates a baseline shift that propagates into the critical region via spillover (Mitchell, 2004)
45
+ - **Post-critical (spillover) region**: Effects from the critical word reliably appear 1-3 words downstream in SPR (Just et al., 1982; Rayner, 1998). If spillover regions differ across conditions, you cannot attribute reading time differences to the critical manipulation
46
+
47
+ ### 4. Avoid Clause and Sentence Boundaries in Critical Regions
48
+
49
+ Wrap-up effects inflate reading times at clause-final and sentence-final words by **50-100+ ms** (Just & Carpenter, 1980; Warren, White, & Reichle, 2009). This inflation is independent of experimental condition and adds noise that reduces statistical power. Additionally, clause-final words often co-occur with punctuation (commas, periods), which introduces visual complexity unrelated to your manipulation.
50
+
51
+ **Rule**: Place the critical region at least 2 words before any clause or sentence boundary.
52
+
53
+ ---
54
+
55
+ ## Segmentation Strategies by Construction Type
56
+
57
+ ### Garden-Path Sentences
58
+
59
+ Garden-path sentences temporarily mislead the parser. The critical region is typically the disambiguation point.
60
+
61
+ **Example**: Main verb / reduced relative ambiguity
62
+
63
+ Condition A (ambiguous):
64
+ ```
65
+ The horse | raced | past the barn | fell | down | the hill.
66
+ pre-crit CRIT spill1 spill2 spill3
67
+ ```
68
+
69
+ Condition B (unambiguous control):
70
+ ```
71
+ The horse | that was raced | past the barn | fell | down | the hill.
72
+ pre-crit CRIT spill1 spill2
73
+ ```
74
+
75
+ **Key considerations**:
76
+ - The critical word "fell" is identical across conditions -- this is ideal
77
+ - Spillover regions ("down the hill") are identical
78
+ - In condition B, the relative clause marker "that was raced" makes the structure unambiguous before the critical region
79
+ - The garden-path effect (longer RT in condition A at "fell") may spill over to "down" and even "the hill"
80
+
81
+ ### Relative Clause Attachment
82
+
83
+ Relative clause attachment ambiguity (high vs. low attachment) typically manipulates the plausibility or gender match of the relative clause with one of two potential hosts.
84
+
85
+ **Example**: High vs. low attachment
86
+
87
+ ```
88
+ The maid | of the actress | who was | sitting | on the | balcony | spoke loudly.
89
+ R1 R2 R3 CRIT spill1 spill2 wrap-up
90
+ ```
91
+
92
+ **Key considerations**:
93
+ - The critical region is the verb inside the relative clause ("sitting") where semantic fit disambiguates attachment
94
+ - "on the balcony" serves as spillover
95
+ - "spoke loudly" is the wrap-up region -- do NOT analyze this as spillover because it includes sentence-final wrap-up effects
96
+ - The two host nouns ("maid" and "actress") must be matched for length and frequency
97
+ - If the disambiguation depends on semantic fit (e.g., "who was knitting" fits better with "actress"), the critical verbs across conditions must be matched for length and frequency
98
+
99
+ ### Filler-Gap Dependencies
100
+
101
+ In filler-gap constructions, a moved element (the filler) is interpreted at a later position (the gap). The critical region is the gap site.
102
+
103
+ **Example**: Object relative with gap
104
+
105
+ ```
106
+ The book | that the author | wrote _ | in the | library | was | a bestseller.
107
+ filler intervener GAP spill1 spill2 spill3 wrap-up
108
+ ```
109
+
110
+ Control: Subject relative (no object gap)
111
+
112
+ ```
113
+ The author | that _ wrote | the book | in the | library | was | quite famous.
114
+ GAP post-gap spill1 spill2 spill3 wrap-up
115
+ ```
116
+
117
+ **Key considerations**:
118
+ - Compare reading times at the verb ("wrote") and spillover regions across the two structures
119
+ - The gap site is implicit (no overt marker), so the parser must posit a gap based on syntactic expectations
120
+ - Spillover regions must be identical or closely matched because gap-filling effects propagate downstream (Stowe, 1986)
121
+
122
+ ### Verb Argument Structure
123
+
124
+ When manipulating subcategorization or argument structure expectations, the critical region is typically the post-verbal material where the argument structure becomes clear.
125
+
126
+ **Example**: Transitive vs. intransitive bias
127
+
128
+ ```
129
+ The doctor | hoped | the patient | would recover | quickly | from | the illness.
130
+ verb CRIT spill1 spill2 spill3 wrap-up
131
+ ```
132
+
133
+ ```
134
+ The doctor | examined | the patient | would recover | quickly | from | the illness.
135
+ verb CRIT spill1 spill2 spill3 wrap-up
136
+ ```
137
+
138
+ **Key considerations**:
139
+ - "hoped" is intransitive-biased: "the patient" is unexpected as a direct object
140
+ - "examined" is transitive-biased: "the patient" is expected as a direct object
141
+ - The critical region ("the patient") is identical across conditions
142
+ - The verbs differ across conditions -- they must be matched for length and frequency
143
+ - The pre-critical verb is the only word that differs, so any RT difference at "the patient" or spillover must be due to the verb's argument structure bias
144
+
145
+ ### Agreement and Morphosyntactic Violations
146
+
147
+ For studies of grammatical agreement or morphosyntactic processing, the critical region is the word where the violation becomes apparent.
148
+
149
+ **Example**: Subject-verb number agreement
150
+
151
+ Grammatical:
152
+ ```
153
+ The key | to the cabinets | was | rusty | and | old.
154
+ subj intervener CRIT spill1 spill2 spill3
155
+ ```
156
+
157
+ Ungrammatical:
158
+ ```
159
+ The key | to the cabinets | were | rusty | and | old.
160
+ subj intervener CRIT spill1 spill2 spill3
161
+ ```
162
+
163
+ **Key considerations**:
164
+ - "was" vs. "were" differ by one character -- this is an acceptable minimal difference
165
+ - The intervening noun ("cabinets") creates an attraction environment that is part of the manipulation
166
+ - Spillover regions must be identical across conditions
167
+ - With agreement violations, effects are often largest in the spillover region (Pearlmutter, Garnsey, & Bock, 1999), not the critical word itself
168
+
169
+ ---
170
+
171
+ ## Word-by-Word vs. Phrase-by-Phrase: When to Choose Each
172
+
173
+ ### Word-by-Word
174
+
175
+ Use word-by-word presentation (the default and most common method) when:
176
+
177
+ - You need maximal temporal resolution
178
+ - The critical manipulation is localized to a single word
179
+ - You want to track spillover word-by-word
180
+ - You need comparability with the existing SPR literature
181
+
182
+ ### Phrase-by-Phrase
183
+
184
+ Use phrase-by-phrase presentation when:
185
+
186
+ - The critical manipulation spans a multi-word constituent (e.g., an entire PP or relative clause)
187
+ - Word-by-word presentation would break up a tightly bound phrase unnaturally
188
+ - You are studying phrase-level prosodic or structural effects
189
+
190
+ When using phrase-by-phrase, follow these rules:
191
+
192
+ 1. **Segment at constituent boundaries.** Every region must be a complete syntactic constituent (NP, VP, PP, clause)
193
+ 2. **Match region length (in words and characters) across conditions.** If condition A has a 4-word critical region and condition B has a 3-word critical region, the length difference confounds the comparison
194
+ 3. **Report your segmentation criteria explicitly.** Phrase-by-phrase segmentation is more subjective than word-by-word. Readers of your paper need to evaluate whether your boundaries are defensible
195
+
196
+ ---
197
+
198
+ ## Controlling for Confounds Within Regions
199
+
200
+ ### Word Length
201
+
202
+ Reading time in SPR increases approximately **30-40 ms per additional character** (Ferreira & Clifton, 1986; Trueswell, Tanenhaus, & Garnsey, 1994). This means a 2-character difference between conditions at the critical word creates a **60-80 ms confound** -- often larger than the effect of interest.
203
+
204
+ **Solutions** (in order of preference):
205
+ 1. Use identical words in the critical region across conditions (best)
206
+ 2. Match word length exactly (within +/- 1 character)
207
+ 3. Include word length as a covariate in the statistical model
208
+ 4. Use residual reading times (Ferreira & Clifton, 1986)
209
+
210
+ ### Word Frequency
211
+
212
+ Low-frequency words take longer to read than high-frequency words. The frequency effect in SPR is approximately **20-40 ms per log unit** of frequency difference (Rayner, 1998; Inhoff & Rayner, 1986).
213
+
214
+ **Solutions**:
215
+ 1. Use identical words in the critical region across conditions (best)
216
+ 2. Match on log-transformed word frequency (SUBTLEX-US; Brysbaert & New, 2009)
217
+ 3. Include log frequency as a covariate in the statistical model
218
+
219
+ ### Word Position in Sentence
220
+
221
+ Reading times are typically slower for the first 2-3 words of a sentence (start-up cost) and inflated at the final 1-2 words (wrap-up; Just & Carpenter, 1980). Avoid placing critical regions in these positions.
222
+
223
+ **Safe zone**: Words 3 through (sentence_length - 3) are least affected by positional artifacts.
224
+
225
+ ---
226
+
227
+ ## Example: Complete Segmentation with Region Labels
228
+
229
+ **Study**: Effect of verb bias on complement clause processing
230
+
231
+ Condition A (SC-biased verb):
232
+ ```
233
+ Position: R1 R2 R3-CRIT R4-spill1 R5-spill2 R6-wrap
234
+ Sentence: The coach | knew | the team | would travel | to the game | on Friday.
235
+ ```
236
+
237
+ Condition B (DO-biased verb):
238
+ ```
239
+ Position: R1 R2 R3-CRIT R4-spill1 R5-spill2 R6-wrap
240
+ Sentence: The coach | told | the team | would travel | to the game | on Friday.
241
+ ```
242
+
243
+ - **R1** (pre-verb context): Identical across conditions
244
+ - **R2** (verb): Differs across conditions -- "knew" (4 chars) vs. "told" (4 chars) -- matched for length. Must also match frequency.
245
+ - **R3** (critical region): "the team" is identical -- this is where the sentence-complement interpretation becomes clear for DO-biased "told" but not SC-biased "knew"
246
+ - **R4-R5** (spillover): Identical across conditions
247
+ - **R6** (wrap-up): Do not analyze as spillover due to sentence-final wrap-up effects
248
+
249
+ ---
250
+
251
+ ## References
252
+
253
+ - Balota, D. A., et al. (2007). The English Lexicon Project. *Behavior Research Methods, 39*, 445-459.
254
+ - Brysbaert, M., & New, B. (2009). Moving beyond Kucera and Francis. *Behavior Research Methods, 41*, 977-990.
255
+ - Ferreira, F., & Clifton, C. (1986). The independence of syntactic processing. *Journal of Memory and Language, 25*, 348-368.
256
+ - Inhoff, A. W., & Rayner, K. (1986). Parafoveal word processing during eye fixations in reading. *Perception & Psychophysics, 40*, 431-439.
257
+ - Jegerski, J. (2014). Self-paced reading. In J. Jegerski & B. VanPatten (Eds.), *Research methods in second language psycholinguistics*. Routledge.
258
+ - Just, M. A., & Carpenter, P. A. (1980). A theory of reading: From eye fixations to comprehension. *Psychological Review, 87*, 329-354.
259
+ - Just, M. A., Carpenter, P. A., & Woolley, J. D. (1982). Paradigms and processes in reading comprehension. *Journal of Experimental Psychology: General, 111*, 228-238.
260
+ - Keating, G. D., & Jegerski, J. (2015). Experimental designs in sentence processing research. *Studies in Second Language Acquisition, 37*, 1-32.
261
+ - Mitchell, D. C. (2004). On-line methods in language processing. In M. Carreiras & C. Clifton (Eds.), *The on-line study of sentence comprehension*. Psychology Press.
262
+ - Pearlmutter, N. J., Garnsey, S. M., & Bock, K. (1999). Agreement processes in sentence comprehension. *Journal of Memory and Language, 41*, 427-456.
263
+ - Rayner, K. (1998). Eye movements in reading and information processing. *Psychological Bulletin, 124*, 372-422.
264
+ - Stowe, L. A. (1986). Parsing WH-constructions: Evidence for on-line gap location. *Language and Cognitive Processes, 1*, 227-245.
265
+ - Trueswell, J. C., Tanenhaus, M. K., & Garnsey, S. M. (1994). Semantic influences on parsing. *Journal of Memory and Language, 33*, 285-318.
266
+ - Warren, T., White, S. J., & Reichle, E. D. (2009). Investigating the causes of wrap-up effects. *Cognition, 111*, 132-137.
@@ -0,0 +1,346 @@
1
+ ---
2
+ name: "sentence-stimulus-norming"
3
+ description: "Specifies norming procedures for linguistic stimuli including cloze probability, plausibility ratings, acceptability judgments, and lexical controls"
4
+ domain: "psycholinguistics"
5
+ version: "1.0.0"
6
+ authors:
7
+ - "Claude (AI-assisted)"
8
+ papers:
9
+ - "Taylor, 1953"
10
+ - "Sprouse & Almeida, 2012"
11
+ - "Brysbaert & New, 2009"
12
+ - "Schütze & Sprouse, 2014"
13
+ - "Baayen et al., 2008"
14
+ dependencies:
15
+ required:
16
+ - research-literacy
17
+ review_status: "ai-generated"
18
+ ---
19
+
20
+ # Sentence Stimulus Norming
21
+
22
+ ## Purpose
23
+
24
+ This skill encodes expert methodological knowledge for norming linguistic stimuli before running psycholinguistic experiments. A competent programmer without linguistics training would likely construct stimuli based on intuition, failing to control for critical lexical variables (word frequency, length, neighborhood density), skipping cloze norming, using inappropriate rating scales, or under-powering the norming study. Poor stimulus norming is the single most common methodological weakness in psycholinguistic research, because confounds in the materials propagate to every analysis.
25
+
26
+ ## When to Use
27
+
28
+ Use this skill when:
29
+
30
+ - Creating sentence stimuli for reading experiments (self-paced reading, eye-tracking, ERP)
31
+ - Norming the predictability (cloze probability) of critical words in sentence contexts
32
+ - Collecting plausibility, naturalness, or acceptability ratings for sentence materials
33
+ - Controlling lexical properties of critical words across experimental conditions
34
+ - Designing Latin square counterbalancing for within-item designs
35
+ - Planning filler items and practice trials
36
+
37
+ Do **not** use this skill when:
38
+
39
+ - Working with single-word stimuli without sentence context (use lexical database tools directly)
40
+ - Designing non-linguistic stimuli (visual search arrays, tones)
41
+ - Analyzing existing normed materials without creating new ones
42
+
43
+ ## Research Planning Protocol
44
+
45
+ Before executing the domain-specific steps below, you MUST:
46
+
47
+ 1. **State the research question** -- What specific question is this analysis/paradigm addressing?
48
+ 2. **Justify the method choice** -- Why is this approach appropriate? What alternatives were considered?
49
+ 3. **Declare expected outcomes** -- What results would support vs. refute the hypothesis?
50
+ 4. **Note assumptions and limitations** -- What does this method assume? Where could it mislead?
51
+ 5. **Present the plan to the user and WAIT for confirmation** before proceeding.
52
+
53
+ For detailed methodology guidance, see the `research-literacy` skill.
54
+
55
+
56
+ ## ⚠️ Verification Notice
57
+
58
+ 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).
59
+
60
+ ## Cloze Probability Norming
61
+
62
+ ### What Is Cloze Probability?
63
+
64
+ Cloze probability is the proportion of people who complete a sentence fragment with a particular word (Taylor, 1953). It is the standard measure of a word's predictability in context and is a critical control variable in nearly all sentence processing research.
65
+
66
+ ### Procedure
67
+
68
+ 1. **Create sentence fragments**: Truncate each sentence immediately before the critical word
69
+ 2. **Present fragments one at a time** to participants
70
+ 3. **Instruct**: "Please complete each sentence with the first word that comes to mind. Write only one word."
71
+ 4. **Score**: For each item, cloze probability = (number of completions matching the target word) / (total number of respondents)
72
+
73
+ ### Design Parameters
74
+
75
+ | Parameter | Recommended Value | Citation / Rationale |
76
+ |-----------|------------------|---------------------|
77
+ | **N per item** | Minimum **30 raters** | Taylor, 1953; Bloom & Fischler, 1980; standard minimum for stable estimates |
78
+ | **Preferred N** | **40-50 raters** | More stable estimates, especially for medium-cloze items |
79
+ | **Items per participant** | **50-100 fragments** per norming session | Avoid fatigue; pilot to calibrate |
80
+ | **Time limit** | **~10-15 seconds per item** or untimed | Untimed is standard; brief limit prevents overthinking |
81
+ | **Population** | Same as experimental population (e.g., native English speakers, same age range) | Ensures cloze values generalize |
82
+
83
+ ### Scoring Conventions
84
+
85
+ - **Exact match**: Only the target word counts (standard)
86
+ - **Morphological variants**: Decide a priori whether "run" and "running" count as the same completion. Standard practice: count only the **exact form** (Staub et al., 2015)
87
+ - **Spelling errors**: Accept obvious misspellings of the target
88
+ - **Blank/nonsense responses**: Exclude from the denominator (participant did not engage)
89
+
90
+ ### Cloze Probability Benchmarks
91
+
92
+ | Cloze Range | Label | Use Case |
93
+ |-------------|-------|----------|
94
+ | **> 0.80** | High cloze / highly predictable | N400 amplitude studies; predictability effects (Kutas & Hillyard, 1984) |
95
+ | **0.30 - 0.70** | Medium cloze | Moderate predictability manipulations |
96
+ | **< 0.10** | Low cloze / unpredictable | Baseline; unexpected completions |
97
+ | **0.00** | Zero cloze | Anomalous or implausible continuations |
98
+
99
+ ### Online vs. Lab Norming
100
+
101
+ | Aspect | Lab | Online (e.g., Prolific, MTurk) |
102
+ |--------|-----|-------------------------------|
103
+ | **Quality control** | Direct observation | Must include catch trials and attention checks |
104
+ | **Sample size** | Limited by lab capacity | Easy to reach N = 40-50 per item |
105
+ | **Population** | Typically university students | More diverse; specify inclusion criteria |
106
+ | **Validity** | Gold standard | Comparable for cloze (Schütze & Sprouse, 2014) |
107
+ | **Cost** | Lab time | Participant payment (~$10-15/hour; Prolific standards) |
108
+
109
+ **Recommendation for online norming**: Include **10-15% catch trials** (sentences with obvious completions, e.g., "The dog chased the ___") and exclude participants who fail > **20%** of catch trials.
110
+
111
+ ## Plausibility and Naturalness Ratings
112
+
113
+ ### When to Collect
114
+
115
+ - When cloze probability alone is insufficient (e.g., both conditions have low cloze but differ in plausibility)
116
+ - When manipulating semantic fit or thematic role plausibility
117
+ - When verifying that "anomalous" conditions are genuinely perceived as odd
118
+
119
+ ### Rating Scale Design
120
+
121
+ | Parameter | Recommended | Citation / Rationale |
122
+ |-----------|------------|---------------------|
123
+ | **Scale type** | Likert scale | Standard for sentence ratings (Schütze & Sprouse, 2014) |
124
+ | **Number of points** | **7-point scale** | Balances sensitivity and reliability; standard in psycholinguistics (Schütze & Sprouse, 2014) |
125
+ | **Anchors** | 1 = "very unnatural/implausible" to 7 = "very natural/plausible" | Labeled endpoints with unlabeled intermediate points |
126
+ | **N per item** | Minimum **20 raters**; preferred **30+** | Sufficient for stable means per item (Sprouse & Almeida, 2012) |
127
+ | **Items per rater** | **40-80** items per session | Avoid fatigue effects |
128
+ | **Practice items** | **3-5 items** spanning the full range before data collection | Calibrate scale use |
129
+
130
+ ### Instructions Template
131
+
132
+ > "You will read a series of sentences. For each sentence, please rate how natural or plausible it sounds on a scale from 1 to 7, where 1 means 'very unnatural / makes no sense' and 7 means 'perfectly natural / makes complete sense.' There are no right or wrong answers; we are interested in your intuition."
133
+
134
+ ### Critical Design Considerations
135
+
136
+ - **Within-list design**: Each rater sees only one version of each item (Latin square). Raters should **never** see multiple conditions of the same item, or they will rate contrastively rather than absolutely.
137
+ - **Filler items**: Include filler sentences spanning the full rating range. This prevents range restriction.
138
+ - **Order effects**: Randomize item order per participant.
139
+
140
+ ## Acceptability Judgments
141
+
142
+ ### When to Collect
143
+
144
+ - When manipulating syntactic structure (grammaticality, island constraints, movement dependencies)
145
+ - When testing formal linguistic predictions about sentence well-formedness
146
+ - For factorial designs crossing syntactic factors (e.g., 2x2 designs testing island effects; Sprouse et al., 2012)
147
+
148
+ ### Rating Methods
149
+
150
+ | Method | Description | Pros | Cons | Citation |
151
+ |--------|-------------|------|------|----------|
152
+ | **Likert scale (7-point)** | Rate acceptability 1-7 | Simple; familiar; sufficient for most purposes | Ceiling/floor possible; ordinal data | Schütze & Sprouse, 2014 |
153
+ | **Magnitude estimation (ME)** | Assign a number proportional to perceived acceptability relative to a reference sentence | Unbounded scale; ratio-level data (in theory) | More complex; participants need training; debated whether it outperforms Likert | Bard et al., 1996; Sprouse, 2011 |
154
+ | **Forced choice** | Choose the more acceptable of two sentences | Binary; easy; avoids scale-use differences | Low sensitivity; many trials needed | Sprouse & Almeida, 2012 |
155
+ | **Yes/No judgment** | "Is this sentence acceptable?" | Simple; binary | Very low sensitivity; cannot distinguish degrees of unacceptability | -- |
156
+
157
+ **Recommendation**: Use **7-point Likert** as the default. It provides sufficient sensitivity for most research questions and has been shown to replicate formal linguistic judgments as reliably as magnitude estimation (Sprouse & Almeida, 2012; Sprouse, 2011).
158
+
159
+ ### Sample Size for Acceptability
160
+
161
+ | Design | Minimum N | Rationale | Citation |
162
+ |--------|-----------|-----------|----------|
163
+ | **Simple grammatical/ungrammatical** | **20 participants** | Large effect sizes (d > 1.0 typical) | Sprouse & Almeida, 2012 |
164
+ | **Factorial (2x2) with interaction** | **30-40 participants** | Interaction effects are smaller | Sprouse et al., 2012 |
165
+ | **Subtle contrasts** | **50+ participants** | Small effect sizes require more power | Power analysis recommended |
166
+
167
+ ## Lexical Controls
168
+
169
+ ### Variables That Must Be Controlled Across Conditions
170
+
171
+ Every critical word manipulation must control for confounding lexical variables. The target word and its condition-matched alternatives should be equated on the following:
172
+
173
+ | Variable | Database / Source | Why It Matters | Citation |
174
+ |----------|------------------|----------------|----------|
175
+ | **Word frequency** | SUBTLEX-US (log10 word frequency per million) | Most powerful predictor of reading time; ~30-60 ms effect for high vs. low (Brysbaert & New, 2009) | Brysbaert & New, 2009 |
176
+ | **Word length** | Character count | Longer words = longer reading times; ~20-30 ms per character (Rayner, 2009) | Rayner, 1998 |
177
+ | **Orthographic neighborhood density (N)** | N-Watch; CLEARPOND | Number of words differing by one letter; affects lexical access (Coltheart et al., 1977) | Andrews, 1997 |
178
+ | **Concreteness** | Brysbaert et al. (2014) ratings | Concrete words processed faster than abstract words | Brysbaert et al., 2014 |
179
+ | **Age of acquisition (AoA)** | Kuperman et al. (2012) ratings | Earlier-acquired words processed faster | Kuperman et al., 2012 |
180
+ | **Number of syllables** | Any pronunciation dictionary | Affects phonological processing time | Rayner, 1998 |
181
+ | **Morphological complexity** | Manual coding | Derived words (e.g., un-happi-ness) processed differently than monomorphemic words | Taft, 2004 |
182
+
183
+ ### Frequency Database Selection
184
+
185
+ | Database | Language | Measure | Recommended? | Citation |
186
+ |----------|----------|---------|--------------|----------|
187
+ | **SUBTLEX-US** | English (US) | Subtitle-based frequency per million | **Yes** -- best predictor of processing times | Brysbaert & New, 2009 |
188
+ | **SUBTLEX-UK** | English (UK) | Subtitle-based frequency | Yes, for British English materials | van Heuven et al., 2014 |
189
+ | **HAL** | English | Usenet corpus frequency | Outdated; SUBTLEX preferred | Lund & Burgess, 1996 |
190
+ | **CELEX** | English, Dutch, German | Mixed corpus frequency | Acceptable but less predictive than SUBTLEX | Baayen et al., 1995 |
191
+
192
+ **Key recommendation**: Use **SUBTLEX** log frequency values. They explain more variance in lexical decision and naming times than older norms (Brysbaert & New, 2009).
193
+
194
+ ### How to Match Across Conditions
195
+
196
+ 1. **Select critical words** for each condition
197
+ 2. **Retrieve lexical metrics** from SUBTLEX-US and norming databases
198
+ 3. **Compute condition means** for each metric
199
+ 4. **Test for differences**: Run t-tests or ANOVAs across conditions on each lexical variable
200
+ 5. **Criterion**: No significant differences (p > 0.20 is a reasonable threshold; some use p > 0.30) on any controlled variable
201
+ 6. If matching fails: **replace items** or add the unmatched variable as a **covariate** in the analysis
202
+
203
+ ## Latin Square Counterbalancing
204
+
205
+ ### Purpose
206
+
207
+ In a within-item design, each item appears in all conditions, but each participant sees each item in only one condition. A Latin square assigns items to conditions across participant lists.
208
+
209
+ ### Construction
210
+
211
+ For a design with **k conditions** and **n items** (where n is divisible by k):
212
+
213
+ 1. Divide items into **k groups** of n/k items each
214
+ 2. Create **k lists**; in each list, assign each item group to a different condition
215
+ 3. Each participant receives one list
216
+ 4. Result: every item appears in every condition across participants; each participant sees an equal number of items per condition
217
+
218
+ ### Example: 2-Condition Design
219
+
220
+ With 40 items and 2 conditions (A, B):
221
+
222
+ | List | Items 1-20 | Items 21-40 |
223
+ |------|-----------|-------------|
224
+ | **List 1** | Condition A | Condition B |
225
+ | **List 2** | Condition B | Condition A |
226
+
227
+ ### Requirements
228
+
229
+ | Parameter | Value | Rationale |
230
+ |-----------|-------|-----------|
231
+ | **Minimum items per condition per list** | **16-24** | Standard for psycholinguistic experiments; fewer items = lower power (Brysbaert & Stevens, 2018) |
232
+ | **Recommended items** | **24-40** per condition | More stable estimates, especially for eye-tracking |
233
+ | **Participants per list** | Equal across lists; minimum **4-6 per list** | Ensures balanced representation |
234
+ | **Total participants** | Divisible by number of lists | Critical for balanced design |
235
+
236
+ ## Filler Items
237
+
238
+ ### Purpose
239
+
240
+ Fillers prevent participants from noticing the experimental manipulation and adopting strategies.
241
+
242
+ ### Design Parameters
243
+
244
+ | Parameter | Recommended Value | Rationale |
245
+ |-----------|------------------|-----------|
246
+ | **Filler-to-target ratio** | **2:1 or 3:1** (fillers:targets) | Standard in psycholinguistics; prevents pattern detection (Schütze & Sprouse, 2014) |
247
+ | **Filler diversity** | Fillers should span the full range of sentence types, lengths, and structures | Prevents target sentences from standing out |
248
+ | **Filler acceptability range** | Include some clearly good and some mildly awkward fillers | Prevents raters from using only part of the scale |
249
+ | **Filler length** | Match the average length of target sentences | Controls for sentence length expectations |
250
+
251
+ ### Filler Construction Tips
252
+
253
+ - Use fillers from different syntactic constructions than your targets
254
+ - Include some fillers with comprehension questions (for reading studies) to maintain attentive reading
255
+ - If targets are semantically anomalous, include some fillers that are also slightly odd (but in different ways) so anomaly is not a cue
256
+
257
+ ## Practice and Warm-Up Items
258
+
259
+ | Parameter | Recommended Value | Rationale |
260
+ |-----------|------------------|-----------|
261
+ | **Number of practice items** | **4-6 items** (minimum 3) | Familiarize participants with the task and interface |
262
+ | **Practice item composition** | Span the range of difficulty/acceptability | Calibrate participant expectations |
263
+ | **Practice data** | **Always exclude** from analysis | Practice responses are contaminated by learning effects |
264
+ | **Warm-up items at start of main experiment** | **2-3 additional filler items** | Allow settling into the task; exclude from analysis |
265
+
266
+ ## Online Norming Considerations
267
+
268
+ ### Platform Recommendations
269
+
270
+ | Platform | Pros | Cons | Typical Pay Rate |
271
+ |----------|------|------|-----------------|
272
+ | **Prolific** | Diverse participants; pre-screening; good data quality | Smaller pool than MTurk | ~$10-15/hour (Prolific minimum: $8/hour) |
273
+ | **Amazon MTurk** | Large pool; fast recruitment | Lower data quality; less diverse; requires careful screening | ~$10-15/hour recommended |
274
+ | **PCIbex / Ibex Farm** | Free hosting; designed for linguistics | Requires programming; no built-in recruitment | (hosting only) |
275
+ | **Gorilla** | GUI-based; good for complex designs | Subscription cost | (hosting only) |
276
+
277
+ ### Quality Control for Online Studies
278
+
279
+ | Measure | Implementation | Threshold |
280
+ |---------|---------------|-----------|
281
+ | **Catch trials** | Include **10-15%** filler items with obvious answers | Exclude participants failing > **20%** |
282
+ | **Completion time** | Record total time | Exclude participants completing in < **50%** of median time |
283
+ | **Straight-lining** | Check for same response on all items | Exclude participants with zero variance in ratings |
284
+ | **Bot detection** | Include reCAPTCHA or similar | Exclude flagged responses |
285
+ | **Native speaker check** | Self-report + brief language background questionnaire | Exclude non-native speakers (unless studying L2) |
286
+
287
+ ## Common Pitfalls
288
+
289
+ 1. **Not norming cloze probability**: Claiming words are "predictable" or "unpredictable" based on experimenter intuition rather than empirical cloze norms. Always collect cloze data (Taylor, 1953).
290
+
291
+ 2. **Too few raters per item**: With N < 20 raters for cloze, individual item estimates are unstable. A word with true cloze of 0.50 could yield observed cloze of 0.20-0.80 with only 10 raters. Use minimum **30 raters** (Bloom & Fischler, 1980).
292
+
293
+ 3. **Not controlling word frequency**: Frequency is the strongest single predictor of reading time. A 1 log-unit difference in SUBTLEX frequency corresponds to ~**30-40 ms** in gaze duration (Brysbaert & New, 2009; Rayner, 1998). Always match or control.
294
+
295
+ 4. **Using the wrong frequency database**: HAL and Kucera-Francis norms are outdated. SUBTLEX-US explains significantly more variance in behavioral data (Brysbaert & New, 2009).
296
+
297
+ 5. **Showing raters multiple conditions of the same item**: This introduces contrastive evaluation. Raters must see each item in only one condition (Latin square for norming too).
298
+
299
+ 6. **Insufficient filler items**: A 1:1 target-to-filler ratio makes the manipulation transparent. Use at least **2:1** fillers to targets (Schütze & Sprouse, 2014).
300
+
301
+ 7. **Not piloting the norming study**: Always pilot with **5-10 participants** to catch unclear instructions, ambiguous items, and timing issues before running the full norming sample.
302
+
303
+ 8. **Ignoring age of acquisition**: AoA effects are independent of frequency (Kuperman et al., 2012). Failing to control AoA can introduce confounds, especially for studies comparing concrete vs. abstract words.
304
+
305
+ ## Minimum Reporting Checklist
306
+
307
+ Based on Schütze & Sprouse (2014) and current psycholinguistic standards:
308
+
309
+ - [ ] Number of items per condition
310
+ - [ ] Cloze probability values: mean, SD, and range per condition (if collected)
311
+ - [ ] Cloze norming details: N raters, population, procedure, scoring criteria
312
+ - [ ] Plausibility/acceptability ratings: scale type, N raters, mean and SD per condition
313
+ - [ ] Lexical control variables: list each controlled variable, database source, and condition means
314
+ - [ ] Statistical test confirming conditions do not differ on controlled variables
315
+ - [ ] Latin square design: number of lists, items per list per condition, participants per list
316
+ - [ ] Filler-to-target ratio and description of filler types
317
+ - [ ] Number of practice/warm-up items
318
+ - [ ] For online norming: platform, pay rate, attention check procedure, exclusion criteria and N excluded
319
+ - [ ] Full item list (in supplementary materials or online repository)
320
+
321
+ ## References
322
+
323
+ - Andrews, S. (1997). The effect of orthographic similarity on lexical retrieval: Resolving neighborhood conflicts. *Psychonomic Bulletin & Review*, 4, 439-461.
324
+ - Baayen, R. H., Davidson, D. J., & Bates, D. M. (2008). Mixed-effects modeling with crossed random effects for subjects and items. *Journal of Memory and Language*, 59, 390-412.
325
+ - Baayen, R. H., Piepenbrock, R., & Gulikers, L. (1995). *The CELEX lexical database* (CD-ROM). Linguistic Data Consortium, University of Pennsylvania.
326
+ - Bard, E. G., Robertson, D., & Sorace, A. (1996). Magnitude estimation of linguistic acceptability. *Language*, 72, 32-68.
327
+ - Bloom, P. A., & Fischler, I. (1980). Completion norms for 329 sentence contexts. *Memory & Cognition*, 8, 631-642.
328
+ - Brysbaert, M., & New, B. (2009). Moving beyond Kucera and Francis: A critical evaluation of current word frequency norms and the introduction of a new and improved word frequency measure for American English. *Behavior Research Methods*, 41, 977-990.
329
+ - Brysbaert, M., & Stevens, M. (2018). Power analysis and effect size in mixed effects models: A tutorial. *Journal of Cognition*, 1, 9.
330
+ - Brysbaert, M., Warriner, A. B., & Kuperman, V. (2014). Concreteness ratings for 40 thousand generally known English word lemmas. *Behavior Research Methods*, 46, 904-911.
331
+ - Coltheart, M., Davelaar, E., Jonasson, J. T., & Besner, D. (1977). Access to the internal lexicon. In S. Dornic (Ed.), *Attention and performance VI*. Hillsdale, NJ: Erlbaum.
332
+ - Kuperman, V., Stadthagen-Gonzalez, H., & Brysbaert, M. (2012). Age-of-acquisition ratings for 30,000 English words. *Behavior Research Methods*, 44, 978-990.
333
+ - Kutas, M., & Hillyard, S. A. (1984). Brain potentials during reading reflect word expectancy and semantic association. *Nature*, 307, 161-163.
334
+ - Lund, K., & Burgess, C. (1996). Producing high-dimensional semantic spaces from lexical co-occurrence. *Behavior Research Methods, Instruments, & Computers*, 28, 203-208.
335
+ - Rayner, K. (1998). Eye movements in reading and information processing: 20 years of research. *Psychological Bulletin*, 124, 372-422.
336
+ - Rayner, K. (2009). Eye movements and attention in reading, scene perception, and visual search. *Quarterly Journal of Experimental Psychology*, 62, 1457-1506.
337
+ - Schütze, C. T., & Sprouse, J. (2014). Judgment data. In R. J. Podesva & D. Sharma (Eds.), *Research methods in linguistics*. Cambridge University Press.
338
+ - Sprouse, J. (2011). A test of the cognitive assumptions of magnitude estimation: Commutativity does not hold for acceptability judgments. *Language*, 87, 274-288.
339
+ - Sprouse, J., & Almeida, D. (2012). Assessing the reliability of textbook data in syntax: Adger's Core Syntax. *Journal of Linguistics*, 48, 609-652.
340
+ - Sprouse, J., Schütze, C. T., & Almeida, D. (2012). A comparison of informal and formal acceptability judgments using a random sample from Linguistic Inquiry 2001-2010. *Lingua*, 134, 219-248.
341
+ - Staub, A., Grant, M., Astheimer, L., & Cohen, A. (2015). The influence of cloze probability and item constraint on cloze task response time. *Journal of Memory and Language*, 82, 1-17.
342
+ - Taft, M. (2004). Morphological decomposition and the reverse base frequency effect. *Quarterly Journal of Experimental Psychology*, 57A, 745-765.
343
+ - Taylor, W. L. (1953). "Cloze procedure": A new tool for measuring readability. *Journalism Quarterly*, 30, 415-433.
344
+ - van Heuven, W. J. B., Mandera, P., Keuleers, E., & Brysbaert, M. (2014). SUBTLEX-UK: A new and improved word frequency database for British English. *Quarterly Journal of Experimental Psychology*, 67, 1176-1190.
345
+
346
+ See `references/lexical-databases-guide.md` for detailed instructions on accessing and querying lexical control databases.