medsci-skills 4.1.0

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 (702) hide show
  1. package/LICENSE +50 -0
  2. package/README.md +602 -0
  3. package/README_FIRST.md +27 -0
  4. package/bin/medsci-skills.js +159 -0
  5. package/installers/install-macos.command +19 -0
  6. package/installers/install-windows.cmd +26 -0
  7. package/installers/install-windows.ps1 +17 -0
  8. package/installers/install.py +218 -0
  9. package/metadata/skills_catalog.json +452 -0
  10. package/package.json +48 -0
  11. package/skills/academic-aio/SKILL.md +408 -0
  12. package/skills/academic-aio/references/case_studies/kjr_mllm_2025.md +82 -0
  13. package/skills/academic-aio/references/checklists/AIO_GENERAL.md +354 -0
  14. package/skills/academic-aio/references/journal_summarybox_templates.yaml +126 -0
  15. package/skills/academic-aio/references/oac_funding_checklist.yaml +129 -0
  16. package/skills/academic-aio/references/reporting_guideline_mapping.md +39 -0
  17. package/skills/academic-aio/references/schema_markup_templates/CodeRepository.jsonld +32 -0
  18. package/skills/academic-aio/references/schema_markup_templates/Dataset.jsonld +36 -0
  19. package/skills/academic-aio/references/schema_markup_templates/Person.jsonld +30 -0
  20. package/skills/academic-aio/references/schema_markup_templates/README.md +43 -0
  21. package/skills/academic-aio/references/schema_markup_templates/ScholarlyArticle.jsonld +55 -0
  22. package/skills/academic-aio/scripts/batch_metadata_audit.py +169 -0
  23. package/skills/academic-aio/scripts/validate_schema.py +118 -0
  24. package/skills/academic-aio/skill.yml +36 -0
  25. package/skills/academic-aio/templates/aio_audit_checklist.md.j2 +108 -0
  26. package/skills/add-journal/SKILL.md +482 -0
  27. package/skills/add-journal/skill.yml +33 -0
  28. package/skills/analyze-stats/SKILL.md +598 -0
  29. package/skills/analyze-stats/references/analysis_guides/missing_data.md +109 -0
  30. package/skills/analyze-stats/references/analysis_guides/nhis_icd10_mapping.md +247 -0
  31. package/skills/analyze-stats/references/analysis_guides/propensity_score.md +132 -0
  32. package/skills/analyze-stats/references/analysis_guides/regression.md +115 -0
  33. package/skills/analyze-stats/references/analysis_guides/repeated_measures.md +160 -0
  34. package/skills/analyze-stats/references/analysis_guides/survey_weighted.md +366 -0
  35. package/skills/analyze-stats/references/analysis_guides/test_selection.md +86 -0
  36. package/skills/analyze-stats/references/style/figure_style.mplstyle +69 -0
  37. package/skills/analyze-stats/references/style/theme_publication.R +147 -0
  38. package/skills/analyze-stats/references/table-standards/journal-profiles/ajr.yaml +51 -0
  39. package/skills/analyze-stats/references/table-standards/journal-profiles/european_radiology.yaml +55 -0
  40. package/skills/analyze-stats/references/table-standards/journal-profiles/jama.yaml +66 -0
  41. package/skills/analyze-stats/references/table-standards/journal-profiles/lancet.yaml +57 -0
  42. package/skills/analyze-stats/references/table-standards/journal-profiles/nejm.yaml +51 -0
  43. package/skills/analyze-stats/references/table-standards/journal-profiles/radiology.yaml +66 -0
  44. package/skills/analyze-stats/references/table-standards/table-standards.md +287 -0
  45. package/skills/analyze-stats/references/table-standards/table-types/diagnostic_accuracy.md +36 -0
  46. package/skills/analyze-stats/references/table-standards/table-types/meta_analysis.md +58 -0
  47. package/skills/analyze-stats/references/table-standards/table-types/model_comparison.md +36 -0
  48. package/skills/analyze-stats/references/table-standards/table-types/regression_results.md +50 -0
  49. package/skills/analyze-stats/references/table-standards/table-types/table1_demographics.md +51 -0
  50. package/skills/analyze-stats/references/table-standards/tool-comparison.md +79 -0
  51. package/skills/analyze-stats/references/templates/agreement_analysis.py +436 -0
  52. package/skills/analyze-stats/references/templates/dca_plot.R +237 -0
  53. package/skills/analyze-stats/references/templates/diagnostic_accuracy.py +401 -0
  54. package/skills/analyze-stats/references/templates/dta_meta_analysis.R +384 -0
  55. package/skills/analyze-stats/references/templates/forest_plot.py +412 -0
  56. package/skills/analyze-stats/references/templates/likert_summary.py +356 -0
  57. package/skills/analyze-stats/references/templates/meta_analysis.R +365 -0
  58. package/skills/analyze-stats/references/templates/propensity_score.py +478 -0
  59. package/skills/analyze-stats/references/templates/regression.py +425 -0
  60. package/skills/analyze-stats/references/templates/repeated_measures.py +434 -0
  61. package/skills/analyze-stats/references/templates/sample_size.R +382 -0
  62. package/skills/analyze-stats/references/templates/survey_weighted_analysis.py +411 -0
  63. package/skills/analyze-stats/references/templates/survival_analysis.py +325 -0
  64. package/skills/analyze-stats/references/templates/table1_demographics.py +287 -0
  65. package/skills/analyze-stats/scripts/check_generated_code.py +335 -0
  66. package/skills/analyze-stats/skill.yml +38 -0
  67. package/skills/analyze-stats/tests/fixtures/gen_bad.R +16 -0
  68. package/skills/analyze-stats/tests/fixtures/gen_bad.py +24 -0
  69. package/skills/analyze-stats/tests/fixtures/gen_clean.py +21 -0
  70. package/skills/analyze-stats/tests/test_generated_code.sh +59 -0
  71. package/skills/analyze-stats/tests/test_survival_template.sh +53 -0
  72. package/skills/author-strategy/SKILL.md +117 -0
  73. package/skills/author-strategy/analyze_patterns.py +303 -0
  74. package/skills/author-strategy/fetch_pubmed.py +374 -0
  75. package/skills/author-strategy/skill.yml +34 -0
  76. package/skills/batch-cohort/SKILL.md +223 -0
  77. package/skills/batch-cohort/references/base_template_knhanes.R +210 -0
  78. package/skills/batch-cohort/references/batch_template_generator.R +222 -0
  79. package/skills/batch-cohort/references/variable_coding_registry.md +136 -0
  80. package/skills/batch-cohort/skill.yml +35 -0
  81. package/skills/calc-sample-size/SKILL.md +491 -0
  82. package/skills/calc-sample-size/references/formulas.md +655 -0
  83. package/skills/calc-sample-size/references/observational_cohort.md +49 -0
  84. package/skills/calc-sample-size/skill.yml +51 -0
  85. package/skills/check-reporting/SKILL.md +534 -0
  86. package/skills/check-reporting/references/LICENSES.md +41 -0
  87. package/skills/check-reporting/references/checklists/AMSTAR2.md +54 -0
  88. package/skills/check-reporting/references/checklists/ARRIVE_2.md +234 -0
  89. package/skills/check-reporting/references/checklists/CARE.md +102 -0
  90. package/skills/check-reporting/references/checklists/CLAIM_2024.md +128 -0
  91. package/skills/check-reporting/references/checklists/CLEAR.md +113 -0
  92. package/skills/check-reporting/references/checklists/CONSORT.md +86 -0
  93. package/skills/check-reporting/references/checklists/COSMIN_RoB.md +136 -0
  94. package/skills/check-reporting/references/checklists/GRRAS.md +61 -0
  95. package/skills/check-reporting/references/checklists/MI_CLEAR_LLM.md +167 -0
  96. package/skills/check-reporting/references/checklists/MOOSE.md +85 -0
  97. package/skills/check-reporting/references/checklists/NOS.md +88 -0
  98. package/skills/check-reporting/references/checklists/PRISMA_2020.md +135 -0
  99. package/skills/check-reporting/references/checklists/PRISMA_DTA.md +36 -0
  100. package/skills/check-reporting/references/checklists/PRISMA_P.md +56 -0
  101. package/skills/check-reporting/references/checklists/PROBAST.md +75 -0
  102. package/skills/check-reporting/references/checklists/PROBAST_AI.md +130 -0
  103. package/skills/check-reporting/references/checklists/QUADAS2.md +77 -0
  104. package/skills/check-reporting/references/checklists/QUADAS_C.md +131 -0
  105. package/skills/check-reporting/references/checklists/ROBINS_E.md +179 -0
  106. package/skills/check-reporting/references/checklists/ROBINS_I.md +87 -0
  107. package/skills/check-reporting/references/checklists/ROBIS.md +114 -0
  108. package/skills/check-reporting/references/checklists/ROB_ME.md +126 -0
  109. package/skills/check-reporting/references/checklists/RoB2.md +79 -0
  110. package/skills/check-reporting/references/checklists/RoB_NMA.md +96 -0
  111. package/skills/check-reporting/references/checklists/SPIRIT.md +112 -0
  112. package/skills/check-reporting/references/checklists/SQUIRE_2.md +68 -0
  113. package/skills/check-reporting/references/checklists/STARD.md +129 -0
  114. package/skills/check-reporting/references/checklists/STARD_AI.md +211 -0
  115. package/skills/check-reporting/references/checklists/STROBE.md +80 -0
  116. package/skills/check-reporting/references/checklists/SWiM.md +33 -0
  117. package/skills/check-reporting/references/checklists/TRIPOD.md +157 -0
  118. package/skills/check-reporting/references/checklists/TRIPOD_AI.md +140 -0
  119. package/skills/check-reporting/references/step4c_registration_timing.md +93 -0
  120. package/skills/check-reporting/references/step4d_prisma_figure_audit.md +137 -0
  121. package/skills/check-reporting/scripts/check_checklist_exists.py +183 -0
  122. package/skills/check-reporting/scripts/check_checklist_version.py +168 -0
  123. package/skills/check-reporting/scripts/check_framework_naming.py +206 -0
  124. package/skills/check-reporting/scripts/check_prisma_figure.py +209 -0
  125. package/skills/check-reporting/scripts/prisma_cascade_check.py +274 -0
  126. package/skills/check-reporting/skill.yml +41 -0
  127. package/skills/check-reporting/tests/fixtures/framework_bad.md +8 -0
  128. package/skills/check-reporting/tests/fixtures/framework_clean.md +7 -0
  129. package/skills/check-reporting/tests/test_checklist_fail_fast.sh +77 -0
  130. package/skills/check-reporting/tests/test_checklist_version.sh +72 -0
  131. package/skills/check-reporting/tests/test_framework_naming.sh +45 -0
  132. package/skills/check-reporting/tests/test_prisma_cascade.sh +104 -0
  133. package/skills/clean-data/SKILL.md +180 -0
  134. package/skills/clean-data/references/cleaning_patterns.md +299 -0
  135. package/skills/clean-data/references/profiling_template.py +304 -0
  136. package/skills/clean-data/scripts/check_structural_zero.py +174 -0
  137. package/skills/clean-data/skill.yml +35 -0
  138. package/skills/clean-data/tests/fixtures/smoking.csv +8 -0
  139. package/skills/clean-data/tests/test_structural_zero.sh +49 -0
  140. package/skills/cross-national/SKILL.md +264 -0
  141. package/skills/cross-national/skill.yml +37 -0
  142. package/skills/define-variables/SKILL.md +146 -0
  143. package/skills/define-variables/references/common_definitions.md +190 -0
  144. package/skills/define-variables/skill.yml +34 -0
  145. package/skills/define-variables/templates/variable_operationalization.md +64 -0
  146. package/skills/deidentify/SKILL.md +203 -0
  147. package/skills/deidentify/deidentify.py +1224 -0
  148. package/skills/deidentify/locales/_template.json +45 -0
  149. package/skills/deidentify/locales/au.json +43 -0
  150. package/skills/deidentify/locales/ca.json +44 -0
  151. package/skills/deidentify/locales/cn.json +47 -0
  152. package/skills/deidentify/locales/de.json +48 -0
  153. package/skills/deidentify/locales/fr.json +48 -0
  154. package/skills/deidentify/locales/in.json +48 -0
  155. package/skills/deidentify/locales/jp.json +48 -0
  156. package/skills/deidentify/locales/kr.json +48 -0
  157. package/skills/deidentify/locales/uk.json +45 -0
  158. package/skills/deidentify/locales/us.json +43 -0
  159. package/skills/deidentify/references/date_shift_guide.md +82 -0
  160. package/skills/deidentify/references/hipaa_18_identifiers.md +48 -0
  161. package/skills/deidentify/references/korean_phi_patterns.md +135 -0
  162. package/skills/deidentify/skill.yml +43 -0
  163. package/skills/deidentify/tests/README.md +26 -0
  164. package/skills/deidentify/tests/test_clean.csv +16 -0
  165. package/skills/deidentify/tests/test_edge_cases.csv +11 -0
  166. package/skills/deidentify/tests/test_phi_korean.csv +11 -0
  167. package/skills/design-ai-benchmarking/SKILL.md +214 -0
  168. package/skills/design-ai-benchmarking/references/benchmark_export_schema.json +69 -0
  169. package/skills/design-ai-benchmarking/references/elicitation_rubric_template.md +37 -0
  170. package/skills/design-ai-benchmarking/skill.yml +38 -0
  171. package/skills/design-study/SKILL.md +298 -0
  172. package/skills/design-study/skill.yml +33 -0
  173. package/skills/fill-icmje-coi/SKILL.md +216 -0
  174. package/skills/fill-icmje-coi/scripts/fill_icmje_coi.py +140 -0
  175. package/skills/fill-icmje-coi/skill.yml +35 -0
  176. package/skills/fill-icmje-coi/templates/icmje_coi_seed_synthetic.docx +0 -0
  177. package/skills/fill-protocol/SKILL.md +248 -0
  178. package/skills/fill-protocol/examples/example_irb_template.yaml +53 -0
  179. package/skills/fill-protocol/references/best_practices.md +121 -0
  180. package/skills/fill-protocol/scripts/doc_to_docx.py +111 -0
  181. package/skills/fill-protocol/scripts/fill_form.py +611 -0
  182. package/skills/fill-protocol/scripts/inspect_template.py +61 -0
  183. package/skills/fill-protocol/setup.sh +162 -0
  184. package/skills/fill-protocol/skill.yml +37 -0
  185. package/skills/find-cohort-gap/SKILL.md +309 -0
  186. package/skills/find-cohort-gap/references/cohort_profile_template.md +93 -0
  187. package/skills/find-cohort-gap/references/onepager_template.md +84 -0
  188. package/skills/find-cohort-gap/references/pattern_scoring_rubric.md +169 -0
  189. package/skills/find-cohort-gap/references/saturation_query_templates.md +143 -0
  190. package/skills/find-cohort-gap/skill.yml +35 -0
  191. package/skills/find-journal/POLICY.md +87 -0
  192. package/skills/find-journal/SKILL.md +340 -0
  193. package/skills/find-journal/references/journal_profiles/AJNR.md +29 -0
  194. package/skills/find-journal/references/journal_profiles/AJR.md +30 -0
  195. package/skills/find-journal/references/journal_profiles/Abdominal_Radiology.md +30 -0
  196. package/skills/find-journal/references/journal_profiles/Academic_Radiology.md +30 -0
  197. package/skills/find-journal/references/journal_profiles/Annals_of_Internal_Medicine.md +33 -0
  198. package/skills/find-journal/references/journal_profiles/Artificial_Intelligence_in_Medicine.md +28 -0
  199. package/skills/find-journal/references/journal_profiles/BMC_Medicine.md +31 -0
  200. package/skills/find-journal/references/journal_profiles/British_Journal_of_Radiology.md +39 -0
  201. package/skills/find-journal/references/journal_profiles/CVIR.md +30 -0
  202. package/skills/find-journal/references/journal_profiles/Chest.md +39 -0
  203. package/skills/find-journal/references/journal_profiles/Clinical_Radiology.md +30 -0
  204. package/skills/find-journal/references/journal_profiles/Clinical_and_Molecular_Hepatology.md +32 -0
  205. package/skills/find-journal/references/journal_profiles/Diabetes_Metabolism_Journal.md +36 -0
  206. package/skills/find-journal/references/journal_profiles/Diagnostic_and_Interventional_Radiology.md +32 -0
  207. package/skills/find-journal/references/journal_profiles/Endocrinology_and_Metabolism.md +37 -0
  208. package/skills/find-journal/references/journal_profiles/European_Journal_of_Preventive_Cardiology.md +39 -0
  209. package/skills/find-journal/references/journal_profiles/European_Radiology.md +29 -0
  210. package/skills/find-journal/references/journal_profiles/Hepatology_Communications.md +40 -0
  211. package/skills/find-journal/references/journal_profiles/Hepatology_International.md +37 -0
  212. package/skills/find-journal/references/journal_profiles/IEEE_JBHI.md +28 -0
  213. package/skills/find-journal/references/journal_profiles/IEEE_TMI.md +28 -0
  214. package/skills/find-journal/references/journal_profiles/INSI.md +29 -0
  215. package/skills/find-journal/references/journal_profiles/Investigative_Radiology.md +25 -0
  216. package/skills/find-journal/references/journal_profiles/JACC_Advances.md +41 -0
  217. package/skills/find-journal/references/journal_profiles/JACC_Asia.md +30 -0
  218. package/skills/find-journal/references/journal_profiles/JACR.md +28 -0
  219. package/skills/find-journal/references/journal_profiles/JAMA.md +40 -0
  220. package/skills/find-journal/references/journal_profiles/JAMA_Network_Open.md +30 -0
  221. package/skills/find-journal/references/journal_profiles/JCSM.md +39 -0
  222. package/skills/find-journal/references/journal_profiles/JKMS.md +32 -0
  223. package/skills/find-journal/references/journal_profiles/JMIR.md +29 -0
  224. package/skills/find-journal/references/journal_profiles/JMIR_Medical_Education.md +29 -0
  225. package/skills/find-journal/references/journal_profiles/JNIS.md +35 -0
  226. package/skills/find-journal/references/journal_profiles/JVIR.md +31 -0
  227. package/skills/find-journal/references/journal_profiles/Journal_of_Biomedical_Informatics.md +29 -0
  228. package/skills/find-journal/references/journal_profiles/Journal_of_Clinical_Endocrinology_and_Metabolism.md +40 -0
  229. package/skills/find-journal/references/journal_profiles/Journal_of_Magnetic_Resonance_Imaging.md +30 -0
  230. package/skills/find-journal/references/journal_profiles/Journal_of_Nuclear_Medicine.md +31 -0
  231. package/skills/find-journal/references/journal_profiles/Journal_of_Stroke.md +32 -0
  232. package/skills/find-journal/references/journal_profiles/KJR.md +38 -0
  233. package/skills/find-journal/references/journal_profiles/Korean_Circulation_Journal.md +38 -0
  234. package/skills/find-journal/references/journal_profiles/Korean_Journal_of_Internal_Medicine.md +36 -0
  235. package/skills/find-journal/references/journal_profiles/Lancet_Diabetes_and_Endocrinology.md +40 -0
  236. package/skills/find-journal/references/journal_profiles/Lancet_Gastroenterology_and_Hepatology.md +49 -0
  237. package/skills/find-journal/references/journal_profiles/Lancet_Infectious_Diseases.md +38 -0
  238. package/skills/find-journal/references/journal_profiles/Lancet_Neurology.md +39 -0
  239. package/skills/find-journal/references/journal_profiles/Lancet_Oncology.md +40 -0
  240. package/skills/find-journal/references/journal_profiles/Lancet_Psychiatry.md +38 -0
  241. package/skills/find-journal/references/journal_profiles/Lancet_Public_Health.md +30 -0
  242. package/skills/find-journal/references/journal_profiles/Lancet_Respiratory_Medicine.md +39 -0
  243. package/skills/find-journal/references/journal_profiles/Liver_International.md +33 -0
  244. package/skills/find-journal/references/journal_profiles/Medical_Image_Analysis.md +28 -0
  245. package/skills/find-journal/references/journal_profiles/NEJM.md +33 -0
  246. package/skills/find-journal/references/journal_profiles/Nature_Machine_Intelligence.md +31 -0
  247. package/skills/find-journal/references/journal_profiles/Nature_Medicine.md +39 -0
  248. package/skills/find-journal/references/journal_profiles/Neuroradiology.md +31 -0
  249. package/skills/find-journal/references/journal_profiles/Nutrition_Metabolism_and_Cardiovascular_Diseases.md +39 -0
  250. package/skills/find-journal/references/journal_profiles/PLOS_Medicine.md +32 -0
  251. package/skills/find-journal/references/journal_profiles/RYAI.md +28 -0
  252. package/skills/find-journal/references/journal_profiles/Radiology.md +29 -0
  253. package/skills/find-journal/references/journal_profiles/Skeletal_Radiology.md +31 -0
  254. package/skills/find-journal/references/journal_profiles/Stroke.md +37 -0
  255. package/skills/find-journal/references/journal_profiles/The_BMJ.md +31 -0
  256. package/skills/find-journal/references/journal_profiles/The_Lancet.md +31 -0
  257. package/skills/find-journal/references/journal_profiles/The_Lancet_Digital_Health.md +29 -0
  258. package/skills/find-journal/references/journal_profiles/World_Journal_of_Hepatology.md +53 -0
  259. package/skills/find-journal/references/journal_profiles/npj_Digital_Medicine.md +29 -0
  260. package/skills/find-journal/skill.yml +34 -0
  261. package/skills/fulltext-retrieval/SKILL.md +174 -0
  262. package/skills/fulltext-retrieval/fetch_oa.py +433 -0
  263. package/skills/fulltext-retrieval/pdf_to_md.py +160 -0
  264. package/skills/fulltext-retrieval/skill.yml +41 -0
  265. package/skills/generate-codebook/SKILL.md +155 -0
  266. package/skills/generate-codebook/references/codebook_schema.md +76 -0
  267. package/skills/generate-codebook/scripts/generate_codebook.py +278 -0
  268. package/skills/generate-codebook/skill.yml +35 -0
  269. package/skills/generate-codebook/tests/test_generate_codebook.sh +76 -0
  270. package/skills/grant-builder/SKILL.md +251 -0
  271. package/skills/grant-builder/skill.yml +34 -0
  272. package/skills/humanize/SKILL.md +251 -0
  273. package/skills/humanize/references/ai_patterns.md +571 -0
  274. package/skills/humanize/skill.yml +33 -0
  275. package/skills/intake-project/SKILL.md +264 -0
  276. package/skills/intake-project/skill.yml +34 -0
  277. package/skills/lit-sync/SKILL.md +448 -0
  278. package/skills/lit-sync/references/locale/ko/note_templates.md +110 -0
  279. package/skills/lit-sync/skill.yml +52 -0
  280. package/skills/lit-sync/tests/test_poll_logic.sh +92 -0
  281. package/skills/ma-scout/SKILL.md +640 -0
  282. package/skills/ma-scout/references/project_readme_template.md +95 -0
  283. package/skills/ma-scout/references/project_readme_template_ko.md +82 -0
  284. package/skills/ma-scout/skill.yml +33 -0
  285. package/skills/make-figures/SKILL.md +957 -0
  286. package/skills/make-figures/references/critic_rubrics/data_plot.md +166 -0
  287. package/skills/make-figures/references/critic_rubrics/flow_diagram.md +169 -0
  288. package/skills/make-figures/references/design_principles.md +181 -0
  289. package/skills/make-figures/references/exemplar_diagrams/README.md +65 -0
  290. package/skills/make-figures/references/exemplar_diagrams/consort/README.md +15 -0
  291. package/skills/make-figures/references/exemplar_diagrams/consort/template_input.yaml +37 -0
  292. package/skills/make-figures/references/exemplar_diagrams/consort/template_output.pdf +0 -0
  293. package/skills/make-figures/references/exemplar_diagrams/consort/template_output.png +0 -0
  294. package/skills/make-figures/references/exemplar_diagrams/consort/template_output_600.png +0 -0
  295. package/skills/make-figures/references/exemplar_diagrams/other/other_02.meta.yaml +4 -0
  296. package/skills/make-figures/references/exemplar_diagrams/other/other_02.png +0 -0
  297. package/skills/make-figures/references/exemplar_diagrams/other/other_02_why.md +13 -0
  298. package/skills/make-figures/references/exemplar_diagrams/pipeline/README.md +15 -0
  299. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01.meta.yaml +4 -0
  300. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01.png +0 -0
  301. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01_why.md +13 -0
  302. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03.meta.yaml +4 -0
  303. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03.png +0 -0
  304. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03_why.md +13 -0
  305. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04.meta.yaml +4 -0
  306. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04.png +0 -0
  307. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04_why.md +13 -0
  308. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05.meta.yaml +4 -0
  309. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05.png +0 -0
  310. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05_why.md +13 -0
  311. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06.meta.yaml +4 -0
  312. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06.png +0 -0
  313. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06_why.md +13 -0
  314. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07.meta.yaml +4 -0
  315. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07.png +0 -0
  316. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07_why.md +13 -0
  317. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08.meta.yaml +4 -0
  318. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08.png +0 -0
  319. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08_why.md +13 -0
  320. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09.meta.yaml +4 -0
  321. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09.png +0 -0
  322. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09_why.md +13 -0
  323. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10.meta.yaml +4 -0
  324. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10.png +0 -0
  325. package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10_why.md +13 -0
  326. package/skills/make-figures/references/exemplar_diagrams/prisma/README.md +15 -0
  327. package/skills/make-figures/references/exemplar_diagrams/prisma/template_input.yaml +47 -0
  328. package/skills/make-figures/references/exemplar_diagrams/prisma/template_output.pdf +0 -0
  329. package/skills/make-figures/references/exemplar_diagrams/prisma/template_output.png +0 -0
  330. package/skills/make-figures/references/exemplar_diagrams/prisma/template_output_600.png +0 -0
  331. package/skills/make-figures/references/exemplar_diagrams/stard/README.md +15 -0
  332. package/skills/make-figures/references/exemplar_diagrams/stard/template_input.yaml +40 -0
  333. package/skills/make-figures/references/exemplar_diagrams/stard/template_output.pdf +0 -0
  334. package/skills/make-figures/references/exemplar_diagrams/stard/template_output.png +0 -0
  335. package/skills/make-figures/references/exemplar_diagrams/stard/template_output_600.png +0 -0
  336. package/skills/make-figures/references/exemplar_diagrams/strobe/template_input.yaml +43 -0
  337. package/skills/make-figures/references/exemplar_diagrams/strobe/template_input_pptx.yaml +43 -0
  338. package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.pdf +0 -0
  339. package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.png +0 -0
  340. package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.pptx +0 -0
  341. package/skills/make-figures/references/exemplar_diagrams/strobe/template_output_600.png +0 -0
  342. package/skills/make-figures/references/figure_specs.md +291 -0
  343. package/skills/make-figures/references/flow_diagram_lessons.md +164 -0
  344. package/skills/make-figures/references/jacc_central_illustration_principles.md +91 -0
  345. package/skills/make-figures/references/medical_illustration_sources.md +98 -0
  346. package/skills/make-figures/references/pipeline_concepts_medical_ai.md +240 -0
  347. package/skills/make-figures/references/reporting_guideline_figure_map.md +104 -0
  348. package/skills/make-figures/references/visual_abstract_templates/european_radiology.pptx +0 -0
  349. package/skills/make-figures/references/visual_abstract_templates/jacc_central_illustration.pptx +0 -0
  350. package/skills/make-figures/references/visual_abstract_templates/medsci_default.pptx +0 -0
  351. package/skills/make-figures/references/visual_abstract_templates/template_guide.md +114 -0
  352. package/skills/make-figures/scripts/build_jacc_template.py +77 -0
  353. package/skills/make-figures/scripts/build_prisma2020_template.py +371 -0
  354. package/skills/make-figures/scripts/build_strobe_template.py +351 -0
  355. package/skills/make-figures/scripts/critic_figure.py +264 -0
  356. package/skills/make-figures/scripts/derive_figure_legend_counts.py +138 -0
  357. package/skills/make-figures/scripts/extract_exemplar_from_pdf.py +186 -0
  358. package/skills/make-figures/scripts/fetch_official_templates.sh +88 -0
  359. package/skills/make-figures/scripts/fill_prisma_template.py +142 -0
  360. package/skills/make-figures/scripts/generate_flow_diagram.R +133 -0
  361. package/skills/make-figures/scripts/generate_image.py +99 -0
  362. package/skills/make-figures/scripts/generate_visual_abstract.py +438 -0
  363. package/skills/make-figures/scripts/validate_pptx_mac_compat.py +233 -0
  364. package/skills/make-figures/skill.yml +52 -0
  365. package/skills/make-figures/templates/official/NOTES.md +62 -0
  366. package/skills/make-figures/templates/official/consort2010/CONSORT_2025_editable_checklist.docx +0 -0
  367. package/skills/make-figures/templates/official/consort2010/CONSORT_2025_flow_diagram.docx +0 -0
  368. package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_new_v1.pptx +0 -0
  369. package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_new_v2.pptx +0 -0
  370. package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_updated_v2.pptx +0 -0
  371. package/skills/make-figures/templates/official/spirit2013/SPIRIT_2025_editable_checklist.docx +0 -0
  372. package/skills/make-figures/templates/official/spirit2013/SPIRIT_2025_participant_timeline.docx +0 -0
  373. package/skills/make-figures/templates/official/stard2015/STARD_2015_checklist.docx +0 -0
  374. package/skills/make-figures/templates/official/stard2015/STARD_2015_flow_diagram.pdf +0 -0
  375. package/skills/make-figures/tests/fixtures/figure1_flow.yaml +8 -0
  376. package/skills/make-figures/tests/fixtures/manuscript_ok.md +9 -0
  377. package/skills/make-figures/tests/fixtures/manuscript_stale.md +4 -0
  378. package/skills/make-figures/tests/test_legend_reconcile.sh +36 -0
  379. package/skills/manage-project/SKILL.md +358 -0
  380. package/skills/manage-project/references/pre_submission_checklist.md +53 -0
  381. package/skills/manage-project/references/project_state_template.json +37 -0
  382. package/skills/manage-project/references/scaffold_templates.md +118 -0
  383. package/skills/manage-project/references/status_output_format.md +44 -0
  384. package/skills/manage-project/references/timeline_example.md +20 -0
  385. package/skills/manage-project/skill.yml +36 -0
  386. package/skills/manage-project/templates/SSOT.yaml.template +41 -0
  387. package/skills/manage-refs/LICENSE.zotero-mcp +21 -0
  388. package/skills/manage-refs/NOTICE.md +29 -0
  389. package/skills/manage-refs/SKILL.md +289 -0
  390. package/skills/manage-refs/citation_styles/README.md +40 -0
  391. package/skills/manage-refs/citation_styles/american-journal-of-roentgenology.csl +211 -0
  392. package/skills/manage-refs/citation_styles/cardiovascular-and-interventional-radiology.csl +19 -0
  393. package/skills/manage-refs/citation_styles/european-radiology.csl +19 -0
  394. package/skills/manage-refs/citation_styles/journal-of-cachexia-sarcopenia-and-muscle.csl +150 -0
  395. package/skills/manage-refs/citation_styles/journal-of-korean-medical-science-strict.csl +533 -0
  396. package/skills/manage-refs/citation_styles/journal-of-korean-medical-science.csl +16 -0
  397. package/skills/manage-refs/citation_styles/korean-journal-of-radiology.csl +155 -0
  398. package/skills/manage-refs/citation_styles/nature.csl +189 -0
  399. package/skills/manage-refs/citation_styles/nlm-citation-sequence.csl +535 -0
  400. package/skills/manage-refs/citation_styles/radiology.csl +228 -0
  401. package/skills/manage-refs/citation_styles/springer-basic-brackets.csl +187 -0
  402. package/skills/manage-refs/citation_styles/springer-vancouver-brackets.csl +276 -0
  403. package/skills/manage-refs/citation_styles/vancouver-superscript.csl +536 -0
  404. package/skills/manage-refs/citation_styles/vancouver.csl +535 -0
  405. package/skills/manage-refs/references/REFERENCE_STYLE_SPECS.md +59 -0
  406. package/skills/manage-refs/references/check_xref_symptoms.md +35 -0
  407. package/skills/manage-refs/scripts/_vendor_citation_writer.py +600 -0
  408. package/skills/manage-refs/scripts/check_citation_keys.py +112 -0
  409. package/skills/manage-refs/scripts/check_csl_render.py +102 -0
  410. package/skills/manage-refs/scripts/check_xref.py +633 -0
  411. package/skills/manage-refs/scripts/fill_journal_abbrev.py +104 -0
  412. package/skills/manage-refs/scripts/inject_zotero_cwyw.py +133 -0
  413. package/skills/manage-refs/scripts/md_marker_convert.py +193 -0
  414. package/skills/manage-refs/scripts/pre_submission_gate.sh +238 -0
  415. package/skills/manage-refs/scripts/render_pandoc.sh +88 -0
  416. package/skills/manage-refs/skill.yml +70 -0
  417. package/skills/manage-refs/tests/fixtures/pre_submission_gate/README.md +32 -0
  418. package/skills/manage-refs/tests/fixtures/pre_submission_gate/manuscript.md +10 -0
  419. package/skills/manage-refs/tests/fixtures/pre_submission_gate/refs.bib +34 -0
  420. package/skills/manage-refs/tests/fixtures/pre_submission_gate/run.sh +117 -0
  421. package/skills/manage-refs/tests/test_vN_docx_check.sh +145 -0
  422. package/skills/meta-analysis/SKILL.md +739 -0
  423. package/skills/meta-analysis/references/LICENSES.md +21 -0
  424. package/skills/meta-analysis/references/PROSPERO_template.md +221 -0
  425. package/skills/meta-analysis/references/ai_pre_screening_template.py +245 -0
  426. package/skills/meta-analysis/references/checklists/JBI_Case_Series.md +45 -0
  427. package/skills/meta-analysis/references/checklists/NOS.md +88 -0
  428. package/skills/meta-analysis/references/checklists/PRISMA_DTA.md +36 -0
  429. package/skills/meta-analysis/references/checklists/PROBAST.md +75 -0
  430. package/skills/meta-analysis/references/checklists/QUADAS2.md +77 -0
  431. package/skills/meta-analysis/references/checklists/ROBINS_I.md +87 -0
  432. package/skills/meta-analysis/references/checklists/RoB2.md +79 -0
  433. package/skills/meta-analysis/references/data_integrity_checklist.md +57 -0
  434. package/skills/meta-analysis/references/icmje_coi_guide.md +181 -0
  435. package/skills/meta-analysis/references/phase10_recovery.md +136 -0
  436. package/skills/meta-analysis/references/phase4_km_composite.md +58 -0
  437. package/skills/meta-analysis/references/phase6_statistical_synthesis.md +148 -0
  438. package/skills/meta-analysis/references/phase9_circulation.md +84 -0
  439. package/skills/meta-analysis/references/post_submission_release_ops.md +41 -0
  440. package/skills/meta-analysis/references/r_templates.md +132 -0
  441. package/skills/meta-analysis/references/review_orchestration.md +40 -0
  442. package/skills/meta-analysis/references/submission_package_drift.md +71 -0
  443. package/skills/meta-analysis/scripts/check_pool_consistency.py +201 -0
  444. package/skills/meta-analysis/scripts/cohort_overlap_check.py +242 -0
  445. package/skills/meta-analysis/scripts/dta_extraction_qc.py +137 -0
  446. package/skills/meta-analysis/scripts/screening_reconcile.py +160 -0
  447. package/skills/meta-analysis/skill.yml +47 -0
  448. package/skills/meta-analysis/templates/FINAL_POOL_LOCK.yaml.template +70 -0
  449. package/skills/meta-analysis/templates/extraction_form_v2.md +129 -0
  450. package/skills/meta-analysis/templates/supplementary_8file_checklist.md +94 -0
  451. package/skills/meta-analysis/tests/test_pool_consistency.sh +123 -0
  452. package/skills/orchestrate/SKILL.md +501 -0
  453. package/skills/orchestrate/references/dialogue_nodes.md +196 -0
  454. package/skills/orchestrate/references/report_template.md +109 -0
  455. package/skills/orchestrate/references/report_template_ko.md +88 -0
  456. package/skills/orchestrate/skill.yml +44 -0
  457. package/skills/peer-review/SKILL.md +381 -0
  458. package/skills/peer-review/references/aczel_2021_reviewer2_patterns.md +88 -0
  459. package/skills/peer-review/references/domain-probes/ai_overclaiming.md +47 -0
  460. package/skills/peer-review/references/domain-probes/narrative_review.md +44 -0
  461. package/skills/peer-review/references/domain-probes/observational_confounding.md +48 -0
  462. package/skills/peer-review/references/domain-probes/radiomics.md +38 -0
  463. package/skills/peer-review/references/domain-probes/sr_ma.md +87 -0
  464. package/skills/peer-review/references/domain-probes/survival_prognostic.md +68 -0
  465. package/skills/peer-review/references/exemplar_reviews/README.md +43 -0
  466. package/skills/peer-review/references/exemplar_reviews/ai_overclaiming.md +47 -0
  467. package/skills/peer-review/references/exemplar_reviews/calibration_missing.md +44 -0
  468. package/skills/peer-review/references/exemplar_reviews/data_leakage.md +48 -0
  469. package/skills/peer-review/references/exemplar_reviews/reference_standard_validity.md +45 -0
  470. package/skills/peer-review/references/narrative_review_audit.md +67 -0
  471. package/skills/peer-review/references/reviewer_calibration/README.md +34 -0
  472. package/skills/peer-review/references/reviewer_calibration/compliance_floor.md +52 -0
  473. package/skills/peer-review/references/reviewer_profiles/AJR.md +82 -0
  474. package/skills/peer-review/references/reviewer_profiles/EURE.md +64 -0
  475. package/skills/peer-review/references/reviewer_profiles/INSI.md +57 -0
  476. package/skills/peer-review/references/reviewer_profiles/KJR.md +100 -0
  477. package/skills/peer-review/references/reviewer_profiles/README.md +32 -0
  478. package/skills/peer-review/references/reviewer_profiles/RYAI.md +86 -0
  479. package/skills/peer-review/skill.yml +39 -0
  480. package/skills/present-paper/SKILL.md +675 -0
  481. package/skills/present-paper/references/critic_rubrics/slide.md +155 -0
  482. package/skills/present-paper/references/generate_pptx_templates.py +604 -0
  483. package/skills/present-paper/references/medical_presentation_templates.md +277 -0
  484. package/skills/present-paper/references/slide_design_principles.md +202 -0
  485. package/skills/present-paper/references/slide_visual_styles/nature_lancet.md +168 -0
  486. package/skills/present-paper/references/workflow-checklist.md +109 -0
  487. package/skills/present-paper/scripts/extract_pdf_figures.py +243 -0
  488. package/skills/present-paper/scripts/inject_pronunciation_notes.py +178 -0
  489. package/skills/present-paper/scripts/inject_speaker_notes.py +133 -0
  490. package/skills/present-paper/scripts/strip_notes_for_sharing.py +140 -0
  491. package/skills/present-paper/scripts/trim_caption.py +271 -0
  492. package/skills/present-paper/skill.yml +41 -0
  493. package/skills/present-paper/templates/build_pptx_nature_lancet.py +688 -0
  494. package/skills/publish-skill/SKILL.md +370 -0
  495. package/skills/publish-skill/references/license-compatibility-matrix.md +132 -0
  496. package/skills/publish-skill/references/pii-patterns.md +130 -0
  497. package/skills/publish-skill/scripts/audit_skill.sh +278 -0
  498. package/skills/publish-skill/skill.yml +35 -0
  499. package/skills/render-pdf-doc/SKILL.md +146 -0
  500. package/skills/render-pdf-doc/references/known_pitfalls.md +53 -0
  501. package/skills/render-pdf-doc/references/pandoc_korean_cheatsheet.md +77 -0
  502. package/skills/render-pdf-doc/scripts/check_deps.sh +42 -0
  503. package/skills/render-pdf-doc/scripts/infer_colwidths.py +164 -0
  504. package/skills/render-pdf-doc/scripts/render_pdf.sh +98 -0
  505. package/skills/render-pdf-doc/skill.yml +57 -0
  506. package/skills/render-pdf-doc/templates/anchor-doc.md +27 -0
  507. package/skills/render-pdf-doc/templates/anchor-doc_ko.md +25 -0
  508. package/skills/render-pdf-doc/templates/briefing-handout.md +33 -0
  509. package/skills/render-pdf-doc/templates/briefing-handout_ko.md +31 -0
  510. package/skills/render-pdf-doc/templates/proposal-cover.md +33 -0
  511. package/skills/render-pdf-doc/templates/proposal-cover_ko.md +31 -0
  512. package/skills/render-pdf-doc/templates/reference-table.md +22 -0
  513. package/skills/render-pdf-doc/templates/reference-table_ko.md +20 -0
  514. package/skills/replicate-study/SKILL.md +150 -0
  515. package/skills/replicate-study/references/harmonization_3country.csv +47 -0
  516. package/skills/replicate-study/references/harmonization_knhanes_nhanes.csv +68 -0
  517. package/skills/replicate-study/references/methodology_extraction_template.md +134 -0
  518. package/skills/replicate-study/skill.yml +37 -0
  519. package/skills/review-paper/SKILL.md +104 -0
  520. package/skills/review-paper/references/macro_skeleton.md +6 -0
  521. package/skills/review-paper/skill.yml +25 -0
  522. package/skills/revise/SKILL.md +515 -0
  523. package/skills/revise/references/r2r_voice.md +346 -0
  524. package/skills/revise/skill.yml +43 -0
  525. package/skills/search-lit/SKILL.md +443 -0
  526. package/skills/search-lit/references/parse_pubmed.py +326 -0
  527. package/skills/search-lit/references/pubmed_eutils.sh +111 -0
  528. package/skills/search-lit/skill.yml +46 -0
  529. package/skills/self-review/SKILL.md +1045 -0
  530. package/skills/self-review/references/domain-probes/ai_overclaiming.md +47 -0
  531. package/skills/self-review/references/domain-probes/narrative_review.md +44 -0
  532. package/skills/self-review/references/domain-probes/observational_confounding.md +48 -0
  533. package/skills/self-review/references/domain-probes/radiomics.md +38 -0
  534. package/skills/self-review/references/domain-probes/sr_ma.md +87 -0
  535. package/skills/self-review/references/domain-probes/survival_prognostic.md +68 -0
  536. package/skills/self-review/references/exemplar_findings/README.md +43 -0
  537. package/skills/self-review/references/exemplar_findings/cohort_arithmetic_mismatch.md +35 -0
  538. package/skills/self-review/references/exemplar_findings/estimand_drift_posthoc_primary.md +39 -0
  539. package/skills/self-review/references/exemplar_findings/scope_overreach_cross_sectional.md +35 -0
  540. package/skills/self-review/references/exemplar_findings/unadjusted_confounder.md +36 -0
  541. package/skills/self-review/references/panel_review_template.md +177 -0
  542. package/skills/self-review/scripts/check_artifact_coverage.py +301 -0
  543. package/skills/self-review/scripts/check_claim_artifact.py +248 -0
  544. package/skills/self-review/scripts/check_classical_style.py +185 -0
  545. package/skills/self-review/scripts/check_cohort_arithmetic.py +481 -0
  546. package/skills/self-review/scripts/check_confounding_completeness.py +287 -0
  547. package/skills/self-review/scripts/check_panel_diversity.py +336 -0
  548. package/skills/self-review/scripts/check_reference_adequacy.py +392 -0
  549. package/skills/self-review/scripts/check_reviewer_team_consistency.py +412 -0
  550. package/skills/self-review/scripts/check_scope_coherence.py +177 -0
  551. package/skills/self-review/skill.yml +47 -0
  552. package/skills/self-review/tests/fixtures/claim_manuscript.md +17 -0
  553. package/skills/self-review/tests/fixtures/claim_prereg.md +6 -0
  554. package/skills/self-review/tests/fixtures/cohort_bad.md +21 -0
  555. package/skills/self-review/tests/fixtures/cohort_clean.md +21 -0
  556. package/skills/self-review/tests/fixtures/cohort_partition.csv +5 -0
  557. package/skills/self-review/tests/fixtures/coverage_analysis/31_delong_nested_added_value.csv +3 -0
  558. package/skills/self-review/tests/fixtures/coverage_analysis/table1_demographics.csv +3 -0
  559. package/skills/self-review/tests/fixtures/coverage_clean.md +13 -0
  560. package/skills/self-review/tests/fixtures/coverage_manuscript.md +11 -0
  561. package/skills/self-review/tests/fixtures/panel_collapse.json +27 -0
  562. package/skills/self-review/tests/fixtures/panel_good.json +32 -0
  563. package/skills/self-review/tests/fixtures/panel_monoculture.json +32 -0
  564. package/skills/self-review/tests/fixtures/refadeq_letter.md +13 -0
  565. package/skills/self-review/tests/fixtures/refadeq_original_fixed.md +42 -0
  566. package/skills/self-review/tests/fixtures/refadeq_original_uncited.md +40 -0
  567. package/skills/self-review/tests/fixtures/scope_bad.md +9 -0
  568. package/skills/self-review/tests/fixtures/scope_clean.md +8 -0
  569. package/skills/self-review/tests/fixtures/scope_surrogate.md +8 -0
  570. package/skills/self-review/tests/fixtures/style_bad.md +13 -0
  571. package/skills/self-review/tests/fixtures/style_clean.md +11 -0
  572. package/skills/self-review/tests/fixtures/table1_by_exposure.csv +11 -0
  573. package/skills/self-review/tests/test_artifact_coverage.sh +44 -0
  574. package/skills/self-review/tests/test_claim_artifact.sh +50 -0
  575. package/skills/self-review/tests/test_classical_style.sh +44 -0
  576. package/skills/self-review/tests/test_cohort_arithmetic.sh +49 -0
  577. package/skills/self-review/tests/test_confounding_completeness.sh +66 -0
  578. package/skills/self-review/tests/test_panel_diversity.sh +55 -0
  579. package/skills/self-review/tests/test_panel_mode.sh +69 -0
  580. package/skills/self-review/tests/test_reference_adequacy.sh +68 -0
  581. package/skills/self-review/tests/test_reviewer_team_consistency.sh +138 -0
  582. package/skills/self-review/tests/test_scope_coherence.sh +46 -0
  583. package/skills/setup-medsci/SKILL.md +110 -0
  584. package/skills/setup-medsci/references/setup-checklist.md +51 -0
  585. package/skills/setup-medsci/skill.yml +30 -0
  586. package/skills/sync-submission/SKILL.md +382 -0
  587. package/skills/sync-submission/scripts/author_registry_example.yaml +36 -0
  588. package/skills/sync-submission/scripts/blind_sweep.py +203 -0
  589. package/skills/sync-submission/scripts/check_asset_anonymization.py +300 -0
  590. package/skills/sync-submission/scripts/check_cross_artifact_stale.py +211 -0
  591. package/skills/sync-submission/scripts/cover_letter_drift_check.py +451 -0
  592. package/skills/sync-submission/scripts/cross_document_n_check.py +486 -0
  593. package/skills/sync-submission/scripts/detect_copy_divergence.py +136 -0
  594. package/skills/sync-submission/scripts/preflight_gate.py +458 -0
  595. package/skills/sync-submission/scripts/scope_drift_check.py +362 -0
  596. package/skills/sync-submission/scripts/sync_submission.py +169 -0
  597. package/skills/sync-submission/skill.yml +43 -0
  598. package/skills/sync-submission/tests/fixtures/copy_ok.md +5 -0
  599. package/skills/sync-submission/tests/fixtures/copy_stale.md +5 -0
  600. package/skills/sync-submission/tests/fixtures/ssot.md +5 -0
  601. package/skills/sync-submission/tests/test_asset_anonymization.sh +99 -0
  602. package/skills/sync-submission/tests/test_copy_divergence.sh +44 -0
  603. package/skills/sync-submission/tests/test_cross_artifact_stale.sh +80 -0
  604. package/skills/sync-submission/tests/test_cross_document_n.sh +132 -0
  605. package/skills/sync-submission/tests/test_preflight_gate.sh +112 -0
  606. package/skills/sync-submission/tests/test_scope_drift.sh +122 -0
  607. package/skills/sync-submission/tests/test_vN_docx_assertion.sh +51 -0
  608. package/skills/verify-refs/SKILL.md +177 -0
  609. package/skills/verify-refs/references/manual_checkpoint_guide.md +100 -0
  610. package/skills/verify-refs/scripts/verify_cli.sh +62 -0
  611. package/skills/verify-refs/scripts/verify_refs.py +782 -0
  612. package/skills/verify-refs/skill.yml +44 -0
  613. package/skills/verify-refs/tests/fixtures/pagination_placeholder.bib +17 -0
  614. package/skills/verify-refs/tests/test_pagination_placeholder.sh +42 -0
  615. package/skills/version-dataset/SKILL.md +143 -0
  616. package/skills/version-dataset/references/manifest_schema.md +72 -0
  617. package/skills/version-dataset/scripts/version_dataset.py +242 -0
  618. package/skills/version-dataset/skill.yml +35 -0
  619. package/skills/version-dataset/tests/test_version_dataset.sh +52 -0
  620. package/skills/write-paper/SKILL.md +1148 -0
  621. package/skills/write-paper/references/exemplar_methods/README.md +38 -0
  622. package/skills/write-paper/references/exemplar_methods/ai_validation_tripod_claim.md +47 -0
  623. package/skills/write-paper/references/exemplar_methods/diagnostic_accuracy_stard.md +50 -0
  624. package/skills/write-paper/references/exemplar_methods/observational_cohort_strobe.md +43 -0
  625. package/skills/write-paper/references/journal_profiles/AJNR.md +185 -0
  626. package/skills/write-paper/references/journal_profiles/AJR.md +149 -0
  627. package/skills/write-paper/references/journal_profiles/Abdominal_Radiology.md +139 -0
  628. package/skills/write-paper/references/journal_profiles/Academic_Radiology.md +90 -0
  629. package/skills/write-paper/references/journal_profiles/Annals_of_Internal_Medicine.md +150 -0
  630. package/skills/write-paper/references/journal_profiles/Artificial_Intelligence_in_Medicine.md +82 -0
  631. package/skills/write-paper/references/journal_profiles/British_Journal_of_Radiology.md +161 -0
  632. package/skills/write-paper/references/journal_profiles/CVIR.md +157 -0
  633. package/skills/write-paper/references/journal_profiles/Chest.md +270 -0
  634. package/skills/write-paper/references/journal_profiles/Clinical_Radiology.md +160 -0
  635. package/skills/write-paper/references/journal_profiles/Clinical_and_Molecular_Hepatology.md +147 -0
  636. package/skills/write-paper/references/journal_profiles/Diabetes_Metabolism_Journal.md +163 -0
  637. package/skills/write-paper/references/journal_profiles/Diagnostic_and_Interventional_Radiology.md +216 -0
  638. package/skills/write-paper/references/journal_profiles/Endocrinology_and_Metabolism.md +167 -0
  639. package/skills/write-paper/references/journal_profiles/European_Journal_of_Preventive_Cardiology.md +192 -0
  640. package/skills/write-paper/references/journal_profiles/European_Radiology.md +159 -0
  641. package/skills/write-paper/references/journal_profiles/Hepatology_Communications.md +110 -0
  642. package/skills/write-paper/references/journal_profiles/Hepatology_International.md +106 -0
  643. package/skills/write-paper/references/journal_profiles/IEEE_TMI.md +180 -0
  644. package/skills/write-paper/references/journal_profiles/INSI.md +163 -0
  645. package/skills/write-paper/references/journal_profiles/Investigative_Radiology.md +86 -0
  646. package/skills/write-paper/references/journal_profiles/JACC_Advances.md +197 -0
  647. package/skills/write-paper/references/journal_profiles/JACC_Asia.md +168 -0
  648. package/skills/write-paper/references/journal_profiles/JACR.md +87 -0
  649. package/skills/write-paper/references/journal_profiles/JAMA.md +188 -0
  650. package/skills/write-paper/references/journal_profiles/JAMA_Network_Open.md +170 -0
  651. package/skills/write-paper/references/journal_profiles/JCSM.md +266 -0
  652. package/skills/write-paper/references/journal_profiles/JKMS.md +201 -0
  653. package/skills/write-paper/references/journal_profiles/JMIR.md +88 -0
  654. package/skills/write-paper/references/journal_profiles/JMIR_Medical_Education.md +86 -0
  655. package/skills/write-paper/references/journal_profiles/JNIS.md +227 -0
  656. package/skills/write-paper/references/journal_profiles/JVIR.md +158 -0
  657. package/skills/write-paper/references/journal_profiles/Journal_of_Clinical_Endocrinology_and_Metabolism.md +191 -0
  658. package/skills/write-paper/references/journal_profiles/Journal_of_Stroke.md +176 -0
  659. package/skills/write-paper/references/journal_profiles/KJR.md +185 -0
  660. package/skills/write-paper/references/journal_profiles/Korean_Circulation_Journal.md +184 -0
  661. package/skills/write-paper/references/journal_profiles/Korean_Journal_of_Internal_Medicine.md +178 -0
  662. package/skills/write-paper/references/journal_profiles/Lancet_Gastroenterology_and_Hepatology.md +127 -0
  663. package/skills/write-paper/references/journal_profiles/Liver_International.md +165 -0
  664. package/skills/write-paper/references/journal_profiles/Medical_Image_Analysis.md +147 -0
  665. package/skills/write-paper/references/journal_profiles/NEJM.md +147 -0
  666. package/skills/write-paper/references/journal_profiles/Nature_Medicine.md +181 -0
  667. package/skills/write-paper/references/journal_profiles/Neuroradiology.md +151 -0
  668. package/skills/write-paper/references/journal_profiles/Nutrition_Metabolism_and_Cardiovascular_Diseases.md +184 -0
  669. package/skills/write-paper/references/journal_profiles/PLOS_Medicine.md +166 -0
  670. package/skills/write-paper/references/journal_profiles/RYAI.md +124 -0
  671. package/skills/write-paper/references/journal_profiles/Radiology.md +173 -0
  672. package/skills/write-paper/references/journal_profiles/Skeletal_Radiology.md +135 -0
  673. package/skills/write-paper/references/journal_profiles/Stroke.md +210 -0
  674. package/skills/write-paper/references/journal_profiles/The_BMJ.md +121 -0
  675. package/skills/write-paper/references/journal_profiles/The_Lancet.md +112 -0
  676. package/skills/write-paper/references/journal_profiles/The_Lancet_Digital_Health.md +104 -0
  677. package/skills/write-paper/references/journal_profiles/World_Journal_of_Hepatology.md +106 -0
  678. package/skills/write-paper/references/journal_profiles/npj_Digital_Medicine.md +93 -0
  679. package/skills/write-paper/references/paper_types/ai_validation.md +270 -0
  680. package/skills/write-paper/references/paper_types/animal_study.md +194 -0
  681. package/skills/write-paper/references/paper_types/case_report.md +237 -0
  682. package/skills/write-paper/references/paper_types/cross_national.md +328 -0
  683. package/skills/write-paper/references/paper_types/letter.md +127 -0
  684. package/skills/write-paper/references/paper_types/meta_analysis.md +181 -0
  685. package/skills/write-paper/references/paper_types/nhis_cohort.md +297 -0
  686. package/skills/write-paper/references/paper_types/original_article.md +221 -0
  687. package/skills/write-paper/references/paper_types/technical_note.md +131 -0
  688. package/skills/write-paper/references/section_guides/discussion.md +155 -0
  689. package/skills/write-paper/references/section_guides/introduction.md +108 -0
  690. package/skills/write-paper/references/section_guides/methods.md +144 -0
  691. package/skills/write-paper/references/section_guides/results.md +113 -0
  692. package/skills/write-paper/references/section_guides/step7_1_classical_qc.md +67 -0
  693. package/skills/write-paper/references/section_guides/step7_4a_audit_recovery.md +74 -0
  694. package/skills/write-paper/references/section_guides/title_abstract.md +123 -0
  695. package/skills/write-paper/references/section_templates/methods_statistical.md +147 -0
  696. package/skills/write-paper/scripts/check_placeholders.py +182 -0
  697. package/skills/write-paper/skill.yml +48 -0
  698. package/skills/write-paper/tests/test_placeholders.sh +107 -0
  699. package/skills/write-protocol/SKILL.md +243 -0
  700. package/skills/write-protocol/references/ethics_checklist.md +150 -0
  701. package/skills/write-protocol/references/protocol_template.md +304 -0
  702. package/skills/write-protocol/skill.yml +34 -0
@@ -0,0 +1,436 @@
1
+ """
2
+ Template: Inter-rater Agreement Analysis
3
+ Calculates Cohen's/Fleiss' kappa, ICC, and Krippendorff's alpha with bootstrap CIs.
4
+ Generates Bland-Altman plots for continuous measurements.
5
+
6
+ Usage:
7
+ Modify the CONFIGURATION section below, then run:
8
+ python agreement_analysis.py
9
+
10
+ Input: CSV with rows=items, columns=raters (or long format)
11
+ Output: agreement_table.csv, bland_altman.pdf/.png, summary text
12
+ """
13
+
14
+ # === REPRODUCIBILITY HEADER ===
15
+ import sys
16
+ import os
17
+ import datetime
18
+ import numpy as np
19
+ import pandas as pd
20
+ from scipy import stats
21
+
22
+ np.random.seed(42)
23
+ print(f"Date: {datetime.date.today()}")
24
+ print(f"Python: {sys.version}")
25
+ print(f"numpy: {np.__version__}, pandas: {pd.__version__}, scipy: {stats.scipy.__version__}")
26
+
27
+ import matplotlib
28
+ matplotlib.use("Agg")
29
+ import matplotlib.pyplot as plt
30
+
31
+ STYLE_PATH = os.path.expanduser(
32
+ "~/.claude/skills/analyze-stats/references/style/figure_style.mplstyle"
33
+ )
34
+ if os.path.exists(STYLE_PATH):
35
+ plt.style.use(STYLE_PATH)
36
+
37
+ print()
38
+
39
+ # === CONFIGURATION (modify for your study) ===
40
+ INPUT_FILE = "data.csv" # Path to input data
41
+ OUTPUT_DIR = "." # Output directory
42
+ RATER_COLS = [] # Column names for each rater (wide format)
43
+ DATA_TYPE = "auto" # "categorical", "ordinal", "continuous", or "auto"
44
+ BOOTSTRAP_N = 1000 # Number of bootstrap iterations for CIs
45
+ ALPHA = 0.05 # Significance level
46
+ # ==============================================
47
+
48
+
49
+ def load_data(filepath: str) -> pd.DataFrame:
50
+ """Load CSV or Excel file."""
51
+ if filepath.endswith((".xlsx", ".xls")):
52
+ return pd.read_excel(filepath)
53
+ return pd.read_csv(filepath)
54
+
55
+
56
+ def detect_data_type(df: pd.DataFrame, cols: list) -> str:
57
+ """Auto-detect whether ratings are categorical, ordinal, or continuous."""
58
+ combined = pd.concat([df[c] for c in cols], ignore_index=True).dropna()
59
+ n_unique = combined.nunique()
60
+
61
+ if combined.dtype == object or combined.dtype.name == "category":
62
+ return "categorical"
63
+ if n_unique <= 10 and all(combined == combined.astype(int)):
64
+ return "ordinal"
65
+ return "continuous"
66
+
67
+
68
+ def interpret_kappa(kappa: float) -> str:
69
+ """Interpret kappa using Landis & Koch (1977) guidelines."""
70
+ if kappa < 0:
71
+ return "poor"
72
+ if kappa < 0.20:
73
+ return "slight"
74
+ if kappa < 0.40:
75
+ return "fair"
76
+ if kappa < 0.60:
77
+ return "moderate"
78
+ if kappa < 0.80:
79
+ return "substantial"
80
+ return "almost perfect"
81
+
82
+
83
+ def interpret_icc(icc: float) -> str:
84
+ """Interpret ICC using Cicchetti (1994) guidelines."""
85
+ if icc < 0.40:
86
+ return "poor"
87
+ if icc < 0.60:
88
+ return "fair"
89
+ if icc < 0.75:
90
+ return "good"
91
+ return "excellent"
92
+
93
+
94
+ def cohens_kappa(r1: np.ndarray, r2: np.ndarray) -> float:
95
+ """Cohen's kappa for 2 raters, categorical data."""
96
+ from sklearn.metrics import cohen_kappa_score
97
+ return cohen_kappa_score(r1, r2)
98
+
99
+
100
+ def cohens_weighted_kappa(r1: np.ndarray, r2: np.ndarray,
101
+ weights: str = "linear") -> float:
102
+ """Weighted Cohen's kappa for ordinal data."""
103
+ from sklearn.metrics import cohen_kappa_score
104
+ return cohen_kappa_score(r1, r2, weights=weights)
105
+
106
+
107
+ def fleiss_kappa(rating_matrix: np.ndarray) -> float:
108
+ """Fleiss' kappa for multiple raters, categorical data.
109
+
110
+ Args:
111
+ rating_matrix: n_items x n_categories matrix of category counts per item
112
+ """
113
+ n_items, n_categories = rating_matrix.shape
114
+ n_raters = int(rating_matrix.sum(axis=1)[0])
115
+
116
+ p_j = rating_matrix.sum(axis=0) / (n_items * n_raters)
117
+ P_i = (rating_matrix**2).sum(axis=1) - n_raters
118
+ P_i = P_i / (n_raters * (n_raters - 1))
119
+
120
+ P_bar = P_i.mean()
121
+ P_e = (p_j**2).sum()
122
+
123
+ if P_e == 1:
124
+ return 1.0
125
+ return (P_bar - P_e) / (1 - P_e)
126
+
127
+
128
+ def compute_icc(df: pd.DataFrame, cols: list,
129
+ model: str = "two-way", type_: str = "agreement") -> float:
130
+ """Compute Intraclass Correlation Coefficient.
131
+
132
+ Args:
133
+ model: "one-way", "two-way" (random), or "two-way-mixed"
134
+ type_: "consistency" or "agreement" (only for two-way)
135
+ Returns: ICC value
136
+ """
137
+ ratings = df[cols].values
138
+ n_subjects, n_raters = ratings.shape
139
+
140
+ grand_mean = ratings.mean()
141
+
142
+ ss_total = np.sum((ratings - grand_mean) ** 2)
143
+ row_means = ratings.mean(axis=1)
144
+ col_means = ratings.mean(axis=0)
145
+
146
+ ss_rows = n_raters * np.sum((row_means - grand_mean) ** 2)
147
+ ss_cols = n_subjects * np.sum((col_means - grand_mean) ** 2)
148
+ ss_error = ss_total - ss_rows - ss_cols
149
+
150
+ ms_rows = ss_rows / (n_subjects - 1)
151
+ ms_cols = ss_cols / (n_raters - 1) if n_raters > 1 else 0
152
+ ms_error = ss_error / ((n_subjects - 1) * (n_raters - 1)) if (n_subjects > 1 and n_raters > 1) else 0
153
+
154
+ if model == "one-way":
155
+ ms_within = (ss_total - ss_rows) / (n_subjects * (n_raters - 1))
156
+ icc = (ms_rows - ms_within) / (ms_rows + (n_raters - 1) * ms_within)
157
+ elif model in ("two-way", "two-way-mixed"):
158
+ if type_ == "agreement":
159
+ icc = (ms_rows - ms_error) / (
160
+ ms_rows + (n_raters - 1) * ms_error +
161
+ n_raters * (ms_cols - ms_error) / n_subjects
162
+ )
163
+ else: # consistency
164
+ icc = (ms_rows - ms_error) / (ms_rows + (n_raters - 1) * ms_error)
165
+ else:
166
+ raise ValueError(f"Unknown model: {model}")
167
+
168
+ return icc
169
+
170
+
171
+ def bootstrap_ci(data: pd.DataFrame, cols: list, metric_func,
172
+ n_bootstrap: int = 1000, alpha: float = 0.05,
173
+ **kwargs) -> tuple:
174
+ """Bootstrap confidence interval for any agreement metric."""
175
+ n = len(data)
176
+ boot_values = []
177
+
178
+ for _ in range(n_bootstrap):
179
+ idx = np.random.choice(n, size=n, replace=True)
180
+ boot_data = data.iloc[idx]
181
+ try:
182
+ val = metric_func(boot_data, cols, **kwargs)
183
+ if np.isfinite(val):
184
+ boot_values.append(val)
185
+ except Exception:
186
+ continue
187
+
188
+ if len(boot_values) < 10:
189
+ return (np.nan, np.nan)
190
+
191
+ boot_values = np.array(boot_values)
192
+ ci_lo = np.percentile(boot_values, 100 * alpha / 2)
193
+ ci_hi = np.percentile(boot_values, 100 * (1 - alpha / 2))
194
+ return (ci_lo, ci_hi)
195
+
196
+
197
+ def bland_altman_plot(r1: np.ndarray, r2: np.ndarray,
198
+ name1: str, name2: str, output_dir: str) -> dict:
199
+ """Generate Bland-Altman plot for two continuous raters."""
200
+ mean_vals = (r1 + r2) / 2
201
+ diff_vals = r1 - r2
202
+ mean_diff = diff_vals.mean()
203
+ std_diff = diff_vals.std(ddof=1)
204
+
205
+ loa_upper = mean_diff + 1.96 * std_diff
206
+ loa_lower = mean_diff - 1.96 * std_diff
207
+
208
+ fig, ax = plt.subplots(figsize=(3.5, 3.5))
209
+ ax.scatter(mean_vals, diff_vals, s=15, alpha=0.6, color="#0072B2", edgecolors="none")
210
+ ax.axhline(mean_diff, color="#D55E00", linewidth=1, label=f"Mean: {mean_diff:.2f}")
211
+ ax.axhline(loa_upper, color="#D55E00", linewidth=0.8, linestyle="--",
212
+ label=f"+1.96 SD: {loa_upper:.2f}")
213
+ ax.axhline(loa_lower, color="#D55E00", linewidth=0.8, linestyle="--",
214
+ label=f"-1.96 SD: {loa_lower:.2f}")
215
+ ax.set_xlabel(f"Mean of {name1} and {name2}")
216
+ ax.set_ylabel(f"Difference ({name1} - {name2})")
217
+ ax.legend(fontsize=7, loc="upper right")
218
+
219
+ fig.tight_layout()
220
+ pdf_path = os.path.join(output_dir, "bland_altman.pdf")
221
+ png_path = os.path.join(output_dir, "bland_altman.png")
222
+ fig.savefig(pdf_path, format="pdf", bbox_inches="tight")
223
+ fig.savefig(png_path, format="png", dpi=300, bbox_inches="tight")
224
+ plt.close(fig)
225
+ print(f"Saved: {pdf_path}")
226
+ print(f"Saved: {png_path}")
227
+
228
+ return {
229
+ "mean_diff": mean_diff,
230
+ "sd_diff": std_diff,
231
+ "loa_lower": loa_lower,
232
+ "loa_upper": loa_upper,
233
+ }
234
+
235
+
236
+ def _icc_for_bootstrap(data, cols, model="two-way", type_="agreement"):
237
+ """Wrapper for ICC to use with bootstrap_ci."""
238
+ return compute_icc(data, cols, model=model, type_=type_)
239
+
240
+
241
+ def _kappa_for_bootstrap_2raters(data, cols):
242
+ """Wrapper for Cohen's kappa to use with bootstrap_ci."""
243
+ r1 = data[cols[0]].values
244
+ r2 = data[cols[1]].values
245
+ mask = ~(pd.isna(r1) | pd.isna(r2))
246
+ if mask.sum() < 2:
247
+ return np.nan
248
+ return cohens_kappa(r1[mask], r2[mask])
249
+
250
+
251
+ def analyze_categorical(df: pd.DataFrame, cols: list, output_dir: str) -> list:
252
+ """Run agreement analysis for categorical data."""
253
+ results = []
254
+ n_raters = len(cols)
255
+ n_items = len(df)
256
+
257
+ if n_raters == 2:
258
+ r1 = df[cols[0]].values
259
+ r2 = df[cols[1]].values
260
+ mask = ~(pd.isna(r1) | pd.isna(r2))
261
+ r1_clean, r2_clean = r1[mask], r2[mask]
262
+
263
+ kappa = cohens_kappa(r1_clean, r2_clean)
264
+ ci_lo, ci_hi = bootstrap_ci(df, cols, _kappa_for_bootstrap_2raters,
265
+ n_bootstrap=BOOTSTRAP_N, alpha=ALPHA)
266
+
267
+ results.append({
268
+ "Metric": "Cohen's kappa",
269
+ "Value": f"{kappa:.3f}",
270
+ "95% CI": f"({ci_lo:.3f}-{ci_hi:.3f})",
271
+ "Interpretation": interpret_kappa(kappa),
272
+ "n_items": int(mask.sum()),
273
+ "n_raters": 2,
274
+ })
275
+
276
+ pct_agree = np.mean(r1_clean == r2_clean)
277
+ results.append({
278
+ "Metric": "Percent agreement",
279
+ "Value": f"{pct_agree:.3f}",
280
+ "95% CI": "",
281
+ "Interpretation": "",
282
+ "n_items": int(mask.sum()),
283
+ "n_raters": 2,
284
+ })
285
+ else:
286
+ categories = sorted(set(pd.concat([df[c] for c in cols]).dropna().unique()))
287
+ rating_counts = np.zeros((n_items, len(categories)))
288
+ for i in range(n_items):
289
+ for c in cols:
290
+ val = df[c].iloc[i]
291
+ if pd.notna(val) and val in categories:
292
+ rating_counts[i, categories.index(val)] += 1
293
+
294
+ fk = fleiss_kappa(rating_counts)
295
+ results.append({
296
+ "Metric": "Fleiss' kappa",
297
+ "Value": f"{fk:.3f}",
298
+ "95% CI": "",
299
+ "Interpretation": interpret_kappa(fk),
300
+ "n_items": n_items,
301
+ "n_raters": n_raters,
302
+ })
303
+
304
+ return results
305
+
306
+
307
+ def analyze_continuous(df: pd.DataFrame, cols: list, output_dir: str) -> list:
308
+ """Run agreement analysis for continuous data."""
309
+ results = []
310
+ n_raters = len(cols)
311
+
312
+ for type_ in ["agreement", "consistency"]:
313
+ icc = compute_icc(df, cols, model="two-way", type_=type_)
314
+ ci_lo, ci_hi = bootstrap_ci(df, cols, _icc_for_bootstrap,
315
+ n_bootstrap=BOOTSTRAP_N, alpha=ALPHA,
316
+ model="two-way", type_=type_)
317
+ label = f"ICC (two-way, {type_})"
318
+ results.append({
319
+ "Metric": label,
320
+ "Value": f"{icc:.3f}",
321
+ "95% CI": f"({ci_lo:.3f}-{ci_hi:.3f})",
322
+ "Interpretation": interpret_icc(icc),
323
+ "n_items": len(df),
324
+ "n_raters": n_raters,
325
+ })
326
+
327
+ if n_raters == 2:
328
+ r1 = df[cols[0]].values.astype(float)
329
+ r2 = df[cols[1]].values.astype(float)
330
+ mask = ~(np.isnan(r1) | np.isnan(r2))
331
+ ba = bland_altman_plot(r1[mask], r2[mask], cols[0], cols[1], output_dir)
332
+ results.append({
333
+ "Metric": "Bland-Altman mean diff",
334
+ "Value": f"{ba['mean_diff']:.3f}",
335
+ "95% CI": f"LoA: ({ba['loa_lower']:.3f}-{ba['loa_upper']:.3f})",
336
+ "Interpretation": "",
337
+ "n_items": int(mask.sum()),
338
+ "n_raters": 2,
339
+ })
340
+
341
+ return results
342
+
343
+
344
+ def analyze_ordinal(df: pd.DataFrame, cols: list, output_dir: str) -> list:
345
+ """Run agreement analysis for ordinal data (weighted kappa + ICC)."""
346
+ results = []
347
+
348
+ if len(cols) == 2:
349
+ r1 = df[cols[0]].values
350
+ r2 = df[cols[1]].values
351
+ mask = ~(pd.isna(r1) | pd.isna(r2))
352
+ r1_clean, r2_clean = r1[mask], r2[mask]
353
+
354
+ for weight in ["linear", "quadratic"]:
355
+ wk = cohens_weighted_kappa(r1_clean, r2_clean, weights=weight)
356
+ results.append({
357
+ "Metric": f"Weighted kappa ({weight})",
358
+ "Value": f"{wk:.3f}",
359
+ "95% CI": "",
360
+ "Interpretation": interpret_kappa(wk),
361
+ "n_items": int(mask.sum()),
362
+ "n_raters": 2,
363
+ })
364
+
365
+ results.extend(analyze_continuous(df, cols, output_dir))
366
+ return results
367
+
368
+
369
+ def save_results(results: list, output_dir: str) -> None:
370
+ """Save agreement metrics as CSV and print formatted output."""
371
+ df = pd.DataFrame(results)
372
+ csv_path = os.path.join(output_dir, "agreement_table.csv")
373
+ df.to_csv(csv_path, index=False)
374
+ print(f"\nSaved: {csv_path}")
375
+ print("\n--- Agreement Analysis Results ---\n")
376
+ print(df.to_markdown(index=False))
377
+
378
+
379
+ def print_results_text(results: list, data_type: str) -> None:
380
+ """Print manuscript-ready text for Results section."""
381
+ print("\n--- Results Text (copy-paste ready) ---\n")
382
+
383
+ for r in results:
384
+ metric = r["Metric"]
385
+ value = r["Value"]
386
+ ci = r.get("95% CI", "")
387
+ interp = r.get("Interpretation", "")
388
+ n_items = r.get("n_items", "")
389
+ n_raters = r.get("n_raters", "")
390
+
391
+ text = f"{metric} was {value}"
392
+ if ci:
393
+ text += f" (95% CI: {ci})"
394
+ if interp:
395
+ text += f", indicating {interp} agreement"
396
+ text += f" (n = {n_items} items, {n_raters} raters)."
397
+ print(text)
398
+ print()
399
+
400
+
401
+ # === MAIN ===
402
+ if __name__ == "__main__":
403
+ print("=" * 60)
404
+ print("Inter-rater Agreement Analysis")
405
+ print("=" * 60)
406
+
407
+ df = load_data(INPUT_FILE)
408
+ print(f"\nLoaded: {INPUT_FILE} ({df.shape[0]} rows, {df.shape[1]} columns)")
409
+
410
+ if not RATER_COLS:
411
+ RATER_COLS = [c for c in df.columns if c.lower().startswith("rater")]
412
+ if not RATER_COLS:
413
+ RATER_COLS = list(df.columns)
414
+ print(f"Using rater columns: {RATER_COLS}")
415
+
416
+ if DATA_TYPE == "auto":
417
+ DATA_TYPE = detect_data_type(df, RATER_COLS)
418
+ print(f"Data type: {DATA_TYPE}")
419
+ print(f"Items: {len(df)}, Raters: {len(RATER_COLS)}")
420
+
421
+ for col in RATER_COLS:
422
+ n_miss = df[col].isna().sum()
423
+ if n_miss > 0:
424
+ print(f" Missing in {col}: {n_miss} ({100*n_miss/len(df):.1f}%)")
425
+
426
+ if DATA_TYPE == "categorical":
427
+ results = analyze_categorical(df, RATER_COLS, OUTPUT_DIR)
428
+ elif DATA_TYPE == "ordinal":
429
+ results = analyze_ordinal(df, RATER_COLS, OUTPUT_DIR)
430
+ elif DATA_TYPE == "continuous":
431
+ results = analyze_continuous(df, RATER_COLS, OUTPUT_DIR)
432
+ else:
433
+ raise ValueError(f"Unknown data type: {DATA_TYPE}")
434
+
435
+ save_results(results, OUTPUT_DIR)
436
+ print_results_text(results, DATA_TYPE)
@@ -0,0 +1,237 @@
1
+ #!/usr/bin/env Rscript
2
+ # dca_plot.R — Decision Curve Analysis
3
+ # =====================================
4
+ # Generates DCA plots showing net benefit vs threshold probability.
5
+ # Compares models against treat-all and treat-none strategies.
6
+ #
7
+ # Dependencies: dcurves, ggplot2, dplyr
8
+ # Install: install.packages(c("dcurves", "ggplot2", "dplyr"))
9
+ #
10
+ # Input: Data frame with binary outcome + one or more prediction scores
11
+ #
12
+ # Usage:
13
+ # Rscript dca_plot.R --input predictions.csv --outcome event \
14
+ # --models model1_prob model2_prob --output dca_results
15
+
16
+ set.seed(42)
17
+ suppressPackageStartupMessages({
18
+ library(dcurves)
19
+ library(ggplot2)
20
+ library(dplyr)
21
+ })
22
+
23
+ cat(sprintf("dca_plot.R | Date: %s | R: %s\n",
24
+ format(Sys.Date()), R.version$version.string))
25
+ cat(sprintf("dcurves: %s | ggplot2: %s\n\n",
26
+ packageVersion("dcurves"), packageVersion("ggplot2")))
27
+
28
+ # ══════════════════════════════════════════════════════════════════════════════
29
+ # CONFIGURATION — Edit for your analysis
30
+ # ══════════════════════════════════════════════════════════════════════════════
31
+
32
+ CONFIG <- list(
33
+ input_file = "predictions.csv", # CSV with outcome and model probabilities
34
+ outcome_col = "event", # Binary outcome column (0/1)
35
+ model_cols = c("model1", "model2"), # Probability score columns
36
+ model_labels = c("AI Model", "Radiologist Score"), # Labels for legend
37
+ threshold_lo = 0.05, # Lower threshold for DCA
38
+ threshold_hi = 0.50, # Upper threshold for DCA
39
+ output_prefix = "dca"
40
+ )
41
+
42
+ # ══════════════════════════════════════════════════════════════════════════════
43
+ # EXAMPLE DATA — Replace with real data
44
+ # ══════════════════════════════════════════════════════════════════════════════
45
+
46
+ set.seed(42)
47
+ n <- 400
48
+ example_data <- data.frame(
49
+ event = rbinom(n, 1, prob = 0.25),
50
+ model1 = plogis(rnorm(n, mean = 0.8, sd = 1.2)),
51
+ model2 = plogis(rnorm(n, mean = 0.3, sd = 1.0))
52
+ )
53
+ # Add some correlation between outcome and predictions
54
+ example_data$model1 <- plogis(
55
+ qlogis(example_data$model1) + example_data$event * 1.5
56
+ )
57
+ example_data$model2 <- plogis(
58
+ qlogis(example_data$model2) + example_data$event * 1.0
59
+ )
60
+
61
+ # ══════════════════════════════════════════════════════════════════════════════
62
+ # LOAD DATA
63
+ # ══════════════════════════════════════════════════════════════════════════════
64
+
65
+ load_data <- function(config) {
66
+ if (file.exists(config$input_file)) {
67
+ df <- read.csv(config$input_file, stringsAsFactors = FALSE)
68
+ cat(sprintf("Loaded: %s (N = %d)\n\n", config$input_file, nrow(df)))
69
+
70
+ # Validate
71
+ for (col in c(config$outcome_col, config$model_cols)) {
72
+ if (!col %in% names(df)) {
73
+ stop(sprintf("Column '%s' not found in %s", col, config$input_file))
74
+ }
75
+ }
76
+ return(df)
77
+ } else {
78
+ cat("Input file not found. Using built-in example data.\n\n")
79
+ return(example_data)
80
+ }
81
+ }
82
+
83
+ df <- load_data(CONFIG)
84
+
85
+ # Rename columns for dcurves
86
+ outcome_var <- CONFIG$outcome_col
87
+ model_cols <- CONFIG$model_cols
88
+
89
+ # ══════════════════════════════════════════════════════════════════════════════
90
+ # RUN DCA
91
+ # ══════════════════════════════════════════════════════════════════════════════
92
+
93
+ cat("═══ DECISION CURVE ANALYSIS ════════════════════════════════════════════\n")
94
+
95
+ # Build formula dynamically
96
+ formula_str <- paste(outcome_var, "~",
97
+ paste(model_cols, collapse = " + "))
98
+ dca_formula <- as.formula(formula_str)
99
+
100
+ dca_result <- dca(
101
+ formula = dca_formula,
102
+ data = df,
103
+ thresholds = seq(CONFIG$threshold_lo, CONFIG$threshold_hi, by = 0.01),
104
+ as_probability = model_cols # our columns are already probabilities
105
+ )
106
+
107
+ # ── Print net benefit at key thresholds ───────────────────────────────────────
108
+ cat("\nNet Benefit at Selected Thresholds:\n")
109
+ key_thresholds <- c(0.10, 0.20, 0.30, 0.40, 0.50)
110
+
111
+ nb_summary <- dca_result$dca %>%
112
+ filter(threshold %in% key_thresholds) %>%
113
+ select(label, threshold, net_benefit) %>%
114
+ tidyr::pivot_wider(names_from = label, values_from = net_benefit)
115
+
116
+ print(nb_summary, digits = 3)
117
+
118
+ # ── Standardized net benefit ──────────────────────────────────────────────────
119
+ # NB_std = (NB_model - NB_treat-all) / (p / (1 - p))
120
+ # where p = event prevalence
121
+
122
+ p_event <- mean(df[[outcome_var]], na.rm = TRUE)
123
+ cat(sprintf("\nEvent prevalence: %.1f%%\n", p_event * 100))
124
+
125
+ # ── Interventions avoided per 100 ────────────────────────────────────────────
126
+ cat("\nInterventions Avoided per 100 Patients (vs treat-all):\n")
127
+ ia_summary <- dca_result$dca %>%
128
+ filter(threshold %in% key_thresholds, !label %in% c("All", "None")) %>%
129
+ mutate(
130
+ nb_all = dca_result$dca$net_benefit[
131
+ dca_result$dca$label == "All" &
132
+ dca_result$dca$threshold %in% threshold
133
+ ][match(threshold, key_thresholds)],
134
+ ia_per_100 = (nb_all - net_benefit) / (threshold / (1 - threshold)) * 100
135
+ ) %>%
136
+ select(label, threshold, net_benefit, ia_per_100)
137
+
138
+ print(ia_summary, digits = 2)
139
+
140
+ # ══════════════════════════════════════════════════════════════════════════════
141
+ # PLOT — Standard DCA plot
142
+ # ══════════════════════════════════════════════════════════════════════════════
143
+
144
+ # Wong colorblind-safe palette
145
+ MODEL_COLORS <- c(
146
+ "#0072B2", # blue — model 1
147
+ "#D55E00", # vermillion — model 2
148
+ "#009E73", # green — model 3 (if present)
149
+ "#E69F00" # orange — model 4 (if present)
150
+ )
151
+
152
+ # Build label-color mapping (exclude "All" and "None" built-ins)
153
+ model_labels_full <- c(CONFIG$model_labels)
154
+ color_map <- c(
155
+ setNames(MODEL_COLORS[seq_along(CONFIG$model_cols)], CONFIG$model_cols),
156
+ "All" = "#888888",
157
+ "None" = "#000000"
158
+ )
159
+
160
+ # Rename model labels for display
161
+ dca_plot_data <- dca_result$dca %>%
162
+ mutate(label = case_when(
163
+ label %in% CONFIG$model_cols ~
164
+ CONFIG$model_labels[match(label, CONFIG$model_cols)],
165
+ TRUE ~ label
166
+ ))
167
+
168
+ # Color map with renamed labels
169
+ color_map_renamed <- c(
170
+ setNames(MODEL_COLORS[seq_along(CONFIG$model_labels)], CONFIG$model_labels),
171
+ "All" = "#888888",
172
+ "None" = "#000000"
173
+ )
174
+
175
+ p_dca <- ggplot(dca_plot_data,
176
+ aes(x = threshold, y = net_benefit,
177
+ color = label, linetype = label)) +
178
+ geom_line(linewidth = 1.0, na.rm = TRUE) +
179
+ scale_color_manual(values = color_map_renamed, name = NULL) +
180
+ scale_linetype_manual(
181
+ values = c(
182
+ setNames(rep("solid", length(CONFIG$model_labels)), CONFIG$model_labels),
183
+ "All" = "dashed", "None" = "dotted"
184
+ ),
185
+ name = NULL
186
+ ) +
187
+ scale_x_continuous(
188
+ limits = c(CONFIG$threshold_lo, CONFIG$threshold_hi),
189
+ labels = scales::percent_format(accuracy = 1)
190
+ ) +
191
+ scale_y_continuous(
192
+ limits = c(
193
+ -0.05,
194
+ max(dca_result$dca$net_benefit, na.rm = TRUE) * 1.1
195
+ )
196
+ ) +
197
+ geom_hline(yintercept = 0, linetype = "solid", color = "#CCCCCC",
198
+ linewidth = 0.5) +
199
+ labs(
200
+ x = "Threshold probability",
201
+ y = "Net benefit",
202
+ title = "Decision Curve Analysis"
203
+ ) +
204
+ theme_classic(base_size = 9, base_family = "Arial") +
205
+ theme(
206
+ legend.position = "bottom",
207
+ legend.text = element_text(size = 8),
208
+ axis.title = element_text(size = 9),
209
+ axis.text = element_text(size = 8),
210
+ plot.title = element_text(size = 10, face = "bold"),
211
+ panel.grid.major.y = element_line(color = "#EEEEEE", linewidth = 0.4)
212
+ )
213
+
214
+ # Save
215
+ for (ext in c("pdf", "png")) {
216
+ outfile <- paste0(CONFIG$output_prefix, "_dca.", ext)
217
+ dpi <- if (ext == "png") 300 else NULL
218
+ ggsave(outfile, plot = p_dca, width = 5.5, height = 4.0,
219
+ dpi = dpi, bg = "white")
220
+ cat(sprintf("Saved: %s\n", outfile))
221
+ }
222
+
223
+ # ══════════════════════════════════════════════════════════════════════════════
224
+ # SAVE NUMERIC RESULTS
225
+ # ══════════════════════════════════════════════════════════════════════════════
226
+
227
+ results_file <- paste0(CONFIG$output_prefix, "_results.csv")
228
+ write.csv(dca_result$dca, results_file, row.names = FALSE)
229
+ cat(sprintf("Saved: %s\n", results_file))
230
+
231
+ # ── Session info ───────────────────────────────────────────────────────────────
232
+ cat("\n── Session Info ─────────────────────────────────────────────────────\n")
233
+ for (pkg in c("dcurves", "ggplot2", "dplyr")) {
234
+ cat(sprintf(" %-12s %s\n", pkg, packageVersion(pkg)))
235
+ }
236
+ cat(sprintf("Date: %s\n", format(Sys.time())))
237
+ cat("DCA analysis complete.\n")