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.
- package/LICENSE +50 -0
- package/README.md +602 -0
- package/README_FIRST.md +27 -0
- package/bin/medsci-skills.js +159 -0
- package/installers/install-macos.command +19 -0
- package/installers/install-windows.cmd +26 -0
- package/installers/install-windows.ps1 +17 -0
- package/installers/install.py +218 -0
- package/metadata/skills_catalog.json +452 -0
- package/package.json +48 -0
- package/skills/academic-aio/SKILL.md +408 -0
- package/skills/academic-aio/references/case_studies/kjr_mllm_2025.md +82 -0
- package/skills/academic-aio/references/checklists/AIO_GENERAL.md +354 -0
- package/skills/academic-aio/references/journal_summarybox_templates.yaml +126 -0
- package/skills/academic-aio/references/oac_funding_checklist.yaml +129 -0
- package/skills/academic-aio/references/reporting_guideline_mapping.md +39 -0
- package/skills/academic-aio/references/schema_markup_templates/CodeRepository.jsonld +32 -0
- package/skills/academic-aio/references/schema_markup_templates/Dataset.jsonld +36 -0
- package/skills/academic-aio/references/schema_markup_templates/Person.jsonld +30 -0
- package/skills/academic-aio/references/schema_markup_templates/README.md +43 -0
- package/skills/academic-aio/references/schema_markup_templates/ScholarlyArticle.jsonld +55 -0
- package/skills/academic-aio/scripts/batch_metadata_audit.py +169 -0
- package/skills/academic-aio/scripts/validate_schema.py +118 -0
- package/skills/academic-aio/skill.yml +36 -0
- package/skills/academic-aio/templates/aio_audit_checklist.md.j2 +108 -0
- package/skills/add-journal/SKILL.md +482 -0
- package/skills/add-journal/skill.yml +33 -0
- package/skills/analyze-stats/SKILL.md +598 -0
- package/skills/analyze-stats/references/analysis_guides/missing_data.md +109 -0
- package/skills/analyze-stats/references/analysis_guides/nhis_icd10_mapping.md +247 -0
- package/skills/analyze-stats/references/analysis_guides/propensity_score.md +132 -0
- package/skills/analyze-stats/references/analysis_guides/regression.md +115 -0
- package/skills/analyze-stats/references/analysis_guides/repeated_measures.md +160 -0
- package/skills/analyze-stats/references/analysis_guides/survey_weighted.md +366 -0
- package/skills/analyze-stats/references/analysis_guides/test_selection.md +86 -0
- package/skills/analyze-stats/references/style/figure_style.mplstyle +69 -0
- package/skills/analyze-stats/references/style/theme_publication.R +147 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/ajr.yaml +51 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/european_radiology.yaml +55 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/jama.yaml +66 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/lancet.yaml +57 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/nejm.yaml +51 -0
- package/skills/analyze-stats/references/table-standards/journal-profiles/radiology.yaml +66 -0
- package/skills/analyze-stats/references/table-standards/table-standards.md +287 -0
- package/skills/analyze-stats/references/table-standards/table-types/diagnostic_accuracy.md +36 -0
- package/skills/analyze-stats/references/table-standards/table-types/meta_analysis.md +58 -0
- package/skills/analyze-stats/references/table-standards/table-types/model_comparison.md +36 -0
- package/skills/analyze-stats/references/table-standards/table-types/regression_results.md +50 -0
- package/skills/analyze-stats/references/table-standards/table-types/table1_demographics.md +51 -0
- package/skills/analyze-stats/references/table-standards/tool-comparison.md +79 -0
- package/skills/analyze-stats/references/templates/agreement_analysis.py +436 -0
- package/skills/analyze-stats/references/templates/dca_plot.R +237 -0
- package/skills/analyze-stats/references/templates/diagnostic_accuracy.py +401 -0
- package/skills/analyze-stats/references/templates/dta_meta_analysis.R +384 -0
- package/skills/analyze-stats/references/templates/forest_plot.py +412 -0
- package/skills/analyze-stats/references/templates/likert_summary.py +356 -0
- package/skills/analyze-stats/references/templates/meta_analysis.R +365 -0
- package/skills/analyze-stats/references/templates/propensity_score.py +478 -0
- package/skills/analyze-stats/references/templates/regression.py +425 -0
- package/skills/analyze-stats/references/templates/repeated_measures.py +434 -0
- package/skills/analyze-stats/references/templates/sample_size.R +382 -0
- package/skills/analyze-stats/references/templates/survey_weighted_analysis.py +411 -0
- package/skills/analyze-stats/references/templates/survival_analysis.py +325 -0
- package/skills/analyze-stats/references/templates/table1_demographics.py +287 -0
- package/skills/analyze-stats/scripts/check_generated_code.py +335 -0
- package/skills/analyze-stats/skill.yml +38 -0
- package/skills/analyze-stats/tests/fixtures/gen_bad.R +16 -0
- package/skills/analyze-stats/tests/fixtures/gen_bad.py +24 -0
- package/skills/analyze-stats/tests/fixtures/gen_clean.py +21 -0
- package/skills/analyze-stats/tests/test_generated_code.sh +59 -0
- package/skills/analyze-stats/tests/test_survival_template.sh +53 -0
- package/skills/author-strategy/SKILL.md +117 -0
- package/skills/author-strategy/analyze_patterns.py +303 -0
- package/skills/author-strategy/fetch_pubmed.py +374 -0
- package/skills/author-strategy/skill.yml +34 -0
- package/skills/batch-cohort/SKILL.md +223 -0
- package/skills/batch-cohort/references/base_template_knhanes.R +210 -0
- package/skills/batch-cohort/references/batch_template_generator.R +222 -0
- package/skills/batch-cohort/references/variable_coding_registry.md +136 -0
- package/skills/batch-cohort/skill.yml +35 -0
- package/skills/calc-sample-size/SKILL.md +491 -0
- package/skills/calc-sample-size/references/formulas.md +655 -0
- package/skills/calc-sample-size/references/observational_cohort.md +49 -0
- package/skills/calc-sample-size/skill.yml +51 -0
- package/skills/check-reporting/SKILL.md +534 -0
- package/skills/check-reporting/references/LICENSES.md +41 -0
- package/skills/check-reporting/references/checklists/AMSTAR2.md +54 -0
- package/skills/check-reporting/references/checklists/ARRIVE_2.md +234 -0
- package/skills/check-reporting/references/checklists/CARE.md +102 -0
- package/skills/check-reporting/references/checklists/CLAIM_2024.md +128 -0
- package/skills/check-reporting/references/checklists/CLEAR.md +113 -0
- package/skills/check-reporting/references/checklists/CONSORT.md +86 -0
- package/skills/check-reporting/references/checklists/COSMIN_RoB.md +136 -0
- package/skills/check-reporting/references/checklists/GRRAS.md +61 -0
- package/skills/check-reporting/references/checklists/MI_CLEAR_LLM.md +167 -0
- package/skills/check-reporting/references/checklists/MOOSE.md +85 -0
- package/skills/check-reporting/references/checklists/NOS.md +88 -0
- package/skills/check-reporting/references/checklists/PRISMA_2020.md +135 -0
- package/skills/check-reporting/references/checklists/PRISMA_DTA.md +36 -0
- package/skills/check-reporting/references/checklists/PRISMA_P.md +56 -0
- package/skills/check-reporting/references/checklists/PROBAST.md +75 -0
- package/skills/check-reporting/references/checklists/PROBAST_AI.md +130 -0
- package/skills/check-reporting/references/checklists/QUADAS2.md +77 -0
- package/skills/check-reporting/references/checklists/QUADAS_C.md +131 -0
- package/skills/check-reporting/references/checklists/ROBINS_E.md +179 -0
- package/skills/check-reporting/references/checklists/ROBINS_I.md +87 -0
- package/skills/check-reporting/references/checklists/ROBIS.md +114 -0
- package/skills/check-reporting/references/checklists/ROB_ME.md +126 -0
- package/skills/check-reporting/references/checklists/RoB2.md +79 -0
- package/skills/check-reporting/references/checklists/RoB_NMA.md +96 -0
- package/skills/check-reporting/references/checklists/SPIRIT.md +112 -0
- package/skills/check-reporting/references/checklists/SQUIRE_2.md +68 -0
- package/skills/check-reporting/references/checklists/STARD.md +129 -0
- package/skills/check-reporting/references/checklists/STARD_AI.md +211 -0
- package/skills/check-reporting/references/checklists/STROBE.md +80 -0
- package/skills/check-reporting/references/checklists/SWiM.md +33 -0
- package/skills/check-reporting/references/checklists/TRIPOD.md +157 -0
- package/skills/check-reporting/references/checklists/TRIPOD_AI.md +140 -0
- package/skills/check-reporting/references/step4c_registration_timing.md +93 -0
- package/skills/check-reporting/references/step4d_prisma_figure_audit.md +137 -0
- package/skills/check-reporting/scripts/check_checklist_exists.py +183 -0
- package/skills/check-reporting/scripts/check_checklist_version.py +168 -0
- package/skills/check-reporting/scripts/check_framework_naming.py +206 -0
- package/skills/check-reporting/scripts/check_prisma_figure.py +209 -0
- package/skills/check-reporting/scripts/prisma_cascade_check.py +274 -0
- package/skills/check-reporting/skill.yml +41 -0
- package/skills/check-reporting/tests/fixtures/framework_bad.md +8 -0
- package/skills/check-reporting/tests/fixtures/framework_clean.md +7 -0
- package/skills/check-reporting/tests/test_checklist_fail_fast.sh +77 -0
- package/skills/check-reporting/tests/test_checklist_version.sh +72 -0
- package/skills/check-reporting/tests/test_framework_naming.sh +45 -0
- package/skills/check-reporting/tests/test_prisma_cascade.sh +104 -0
- package/skills/clean-data/SKILL.md +180 -0
- package/skills/clean-data/references/cleaning_patterns.md +299 -0
- package/skills/clean-data/references/profiling_template.py +304 -0
- package/skills/clean-data/scripts/check_structural_zero.py +174 -0
- package/skills/clean-data/skill.yml +35 -0
- package/skills/clean-data/tests/fixtures/smoking.csv +8 -0
- package/skills/clean-data/tests/test_structural_zero.sh +49 -0
- package/skills/cross-national/SKILL.md +264 -0
- package/skills/cross-national/skill.yml +37 -0
- package/skills/define-variables/SKILL.md +146 -0
- package/skills/define-variables/references/common_definitions.md +190 -0
- package/skills/define-variables/skill.yml +34 -0
- package/skills/define-variables/templates/variable_operationalization.md +64 -0
- package/skills/deidentify/SKILL.md +203 -0
- package/skills/deidentify/deidentify.py +1224 -0
- package/skills/deidentify/locales/_template.json +45 -0
- package/skills/deidentify/locales/au.json +43 -0
- package/skills/deidentify/locales/ca.json +44 -0
- package/skills/deidentify/locales/cn.json +47 -0
- package/skills/deidentify/locales/de.json +48 -0
- package/skills/deidentify/locales/fr.json +48 -0
- package/skills/deidentify/locales/in.json +48 -0
- package/skills/deidentify/locales/jp.json +48 -0
- package/skills/deidentify/locales/kr.json +48 -0
- package/skills/deidentify/locales/uk.json +45 -0
- package/skills/deidentify/locales/us.json +43 -0
- package/skills/deidentify/references/date_shift_guide.md +82 -0
- package/skills/deidentify/references/hipaa_18_identifiers.md +48 -0
- package/skills/deidentify/references/korean_phi_patterns.md +135 -0
- package/skills/deidentify/skill.yml +43 -0
- package/skills/deidentify/tests/README.md +26 -0
- package/skills/deidentify/tests/test_clean.csv +16 -0
- package/skills/deidentify/tests/test_edge_cases.csv +11 -0
- package/skills/deidentify/tests/test_phi_korean.csv +11 -0
- package/skills/design-ai-benchmarking/SKILL.md +214 -0
- package/skills/design-ai-benchmarking/references/benchmark_export_schema.json +69 -0
- package/skills/design-ai-benchmarking/references/elicitation_rubric_template.md +37 -0
- package/skills/design-ai-benchmarking/skill.yml +38 -0
- package/skills/design-study/SKILL.md +298 -0
- package/skills/design-study/skill.yml +33 -0
- package/skills/fill-icmje-coi/SKILL.md +216 -0
- package/skills/fill-icmje-coi/scripts/fill_icmje_coi.py +140 -0
- package/skills/fill-icmje-coi/skill.yml +35 -0
- package/skills/fill-icmje-coi/templates/icmje_coi_seed_synthetic.docx +0 -0
- package/skills/fill-protocol/SKILL.md +248 -0
- package/skills/fill-protocol/examples/example_irb_template.yaml +53 -0
- package/skills/fill-protocol/references/best_practices.md +121 -0
- package/skills/fill-protocol/scripts/doc_to_docx.py +111 -0
- package/skills/fill-protocol/scripts/fill_form.py +611 -0
- package/skills/fill-protocol/scripts/inspect_template.py +61 -0
- package/skills/fill-protocol/setup.sh +162 -0
- package/skills/fill-protocol/skill.yml +37 -0
- package/skills/find-cohort-gap/SKILL.md +309 -0
- package/skills/find-cohort-gap/references/cohort_profile_template.md +93 -0
- package/skills/find-cohort-gap/references/onepager_template.md +84 -0
- package/skills/find-cohort-gap/references/pattern_scoring_rubric.md +169 -0
- package/skills/find-cohort-gap/references/saturation_query_templates.md +143 -0
- package/skills/find-cohort-gap/skill.yml +35 -0
- package/skills/find-journal/POLICY.md +87 -0
- package/skills/find-journal/SKILL.md +340 -0
- package/skills/find-journal/references/journal_profiles/AJNR.md +29 -0
- package/skills/find-journal/references/journal_profiles/AJR.md +30 -0
- package/skills/find-journal/references/journal_profiles/Abdominal_Radiology.md +30 -0
- package/skills/find-journal/references/journal_profiles/Academic_Radiology.md +30 -0
- package/skills/find-journal/references/journal_profiles/Annals_of_Internal_Medicine.md +33 -0
- package/skills/find-journal/references/journal_profiles/Artificial_Intelligence_in_Medicine.md +28 -0
- package/skills/find-journal/references/journal_profiles/BMC_Medicine.md +31 -0
- package/skills/find-journal/references/journal_profiles/British_Journal_of_Radiology.md +39 -0
- package/skills/find-journal/references/journal_profiles/CVIR.md +30 -0
- package/skills/find-journal/references/journal_profiles/Chest.md +39 -0
- package/skills/find-journal/references/journal_profiles/Clinical_Radiology.md +30 -0
- package/skills/find-journal/references/journal_profiles/Clinical_and_Molecular_Hepatology.md +32 -0
- package/skills/find-journal/references/journal_profiles/Diabetes_Metabolism_Journal.md +36 -0
- package/skills/find-journal/references/journal_profiles/Diagnostic_and_Interventional_Radiology.md +32 -0
- package/skills/find-journal/references/journal_profiles/Endocrinology_and_Metabolism.md +37 -0
- package/skills/find-journal/references/journal_profiles/European_Journal_of_Preventive_Cardiology.md +39 -0
- package/skills/find-journal/references/journal_profiles/European_Radiology.md +29 -0
- package/skills/find-journal/references/journal_profiles/Hepatology_Communications.md +40 -0
- package/skills/find-journal/references/journal_profiles/Hepatology_International.md +37 -0
- package/skills/find-journal/references/journal_profiles/IEEE_JBHI.md +28 -0
- package/skills/find-journal/references/journal_profiles/IEEE_TMI.md +28 -0
- package/skills/find-journal/references/journal_profiles/INSI.md +29 -0
- package/skills/find-journal/references/journal_profiles/Investigative_Radiology.md +25 -0
- package/skills/find-journal/references/journal_profiles/JACC_Advances.md +41 -0
- package/skills/find-journal/references/journal_profiles/JACC_Asia.md +30 -0
- package/skills/find-journal/references/journal_profiles/JACR.md +28 -0
- package/skills/find-journal/references/journal_profiles/JAMA.md +40 -0
- package/skills/find-journal/references/journal_profiles/JAMA_Network_Open.md +30 -0
- package/skills/find-journal/references/journal_profiles/JCSM.md +39 -0
- package/skills/find-journal/references/journal_profiles/JKMS.md +32 -0
- package/skills/find-journal/references/journal_profiles/JMIR.md +29 -0
- package/skills/find-journal/references/journal_profiles/JMIR_Medical_Education.md +29 -0
- package/skills/find-journal/references/journal_profiles/JNIS.md +35 -0
- package/skills/find-journal/references/journal_profiles/JVIR.md +31 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Biomedical_Informatics.md +29 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Clinical_Endocrinology_and_Metabolism.md +40 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Magnetic_Resonance_Imaging.md +30 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Nuclear_Medicine.md +31 -0
- package/skills/find-journal/references/journal_profiles/Journal_of_Stroke.md +32 -0
- package/skills/find-journal/references/journal_profiles/KJR.md +38 -0
- package/skills/find-journal/references/journal_profiles/Korean_Circulation_Journal.md +38 -0
- package/skills/find-journal/references/journal_profiles/Korean_Journal_of_Internal_Medicine.md +36 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Diabetes_and_Endocrinology.md +40 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Gastroenterology_and_Hepatology.md +49 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Infectious_Diseases.md +38 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Neurology.md +39 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Oncology.md +40 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Psychiatry.md +38 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Public_Health.md +30 -0
- package/skills/find-journal/references/journal_profiles/Lancet_Respiratory_Medicine.md +39 -0
- package/skills/find-journal/references/journal_profiles/Liver_International.md +33 -0
- package/skills/find-journal/references/journal_profiles/Medical_Image_Analysis.md +28 -0
- package/skills/find-journal/references/journal_profiles/NEJM.md +33 -0
- package/skills/find-journal/references/journal_profiles/Nature_Machine_Intelligence.md +31 -0
- package/skills/find-journal/references/journal_profiles/Nature_Medicine.md +39 -0
- package/skills/find-journal/references/journal_profiles/Neuroradiology.md +31 -0
- package/skills/find-journal/references/journal_profiles/Nutrition_Metabolism_and_Cardiovascular_Diseases.md +39 -0
- package/skills/find-journal/references/journal_profiles/PLOS_Medicine.md +32 -0
- package/skills/find-journal/references/journal_profiles/RYAI.md +28 -0
- package/skills/find-journal/references/journal_profiles/Radiology.md +29 -0
- package/skills/find-journal/references/journal_profiles/Skeletal_Radiology.md +31 -0
- package/skills/find-journal/references/journal_profiles/Stroke.md +37 -0
- package/skills/find-journal/references/journal_profiles/The_BMJ.md +31 -0
- package/skills/find-journal/references/journal_profiles/The_Lancet.md +31 -0
- package/skills/find-journal/references/journal_profiles/The_Lancet_Digital_Health.md +29 -0
- package/skills/find-journal/references/journal_profiles/World_Journal_of_Hepatology.md +53 -0
- package/skills/find-journal/references/journal_profiles/npj_Digital_Medicine.md +29 -0
- package/skills/find-journal/skill.yml +34 -0
- package/skills/fulltext-retrieval/SKILL.md +174 -0
- package/skills/fulltext-retrieval/fetch_oa.py +433 -0
- package/skills/fulltext-retrieval/pdf_to_md.py +160 -0
- package/skills/fulltext-retrieval/skill.yml +41 -0
- package/skills/generate-codebook/SKILL.md +155 -0
- package/skills/generate-codebook/references/codebook_schema.md +76 -0
- package/skills/generate-codebook/scripts/generate_codebook.py +278 -0
- package/skills/generate-codebook/skill.yml +35 -0
- package/skills/generate-codebook/tests/test_generate_codebook.sh +76 -0
- package/skills/grant-builder/SKILL.md +251 -0
- package/skills/grant-builder/skill.yml +34 -0
- package/skills/humanize/SKILL.md +251 -0
- package/skills/humanize/references/ai_patterns.md +571 -0
- package/skills/humanize/skill.yml +33 -0
- package/skills/intake-project/SKILL.md +264 -0
- package/skills/intake-project/skill.yml +34 -0
- package/skills/lit-sync/SKILL.md +448 -0
- package/skills/lit-sync/references/locale/ko/note_templates.md +110 -0
- package/skills/lit-sync/skill.yml +52 -0
- package/skills/lit-sync/tests/test_poll_logic.sh +92 -0
- package/skills/ma-scout/SKILL.md +640 -0
- package/skills/ma-scout/references/project_readme_template.md +95 -0
- package/skills/ma-scout/references/project_readme_template_ko.md +82 -0
- package/skills/ma-scout/skill.yml +33 -0
- package/skills/make-figures/SKILL.md +957 -0
- package/skills/make-figures/references/critic_rubrics/data_plot.md +166 -0
- package/skills/make-figures/references/critic_rubrics/flow_diagram.md +169 -0
- package/skills/make-figures/references/design_principles.md +181 -0
- package/skills/make-figures/references/exemplar_diagrams/README.md +65 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_input.yaml +37 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/consort/template_output_600.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/other/other_02.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/other/other_02.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/other/other_02_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_01_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_03_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_04_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_05_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_06_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_07_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_08_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_09_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10.meta.yaml +4 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/pipeline/pipeline_10_why.md +13 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_input.yaml +47 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/prisma/template_output_600.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/README.md +15 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_input.yaml +40 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/stard/template_output_600.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_input.yaml +43 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_input_pptx.yaml +43 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.pdf +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.png +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output.pptx +0 -0
- package/skills/make-figures/references/exemplar_diagrams/strobe/template_output_600.png +0 -0
- package/skills/make-figures/references/figure_specs.md +291 -0
- package/skills/make-figures/references/flow_diagram_lessons.md +164 -0
- package/skills/make-figures/references/jacc_central_illustration_principles.md +91 -0
- package/skills/make-figures/references/medical_illustration_sources.md +98 -0
- package/skills/make-figures/references/pipeline_concepts_medical_ai.md +240 -0
- package/skills/make-figures/references/reporting_guideline_figure_map.md +104 -0
- package/skills/make-figures/references/visual_abstract_templates/european_radiology.pptx +0 -0
- package/skills/make-figures/references/visual_abstract_templates/jacc_central_illustration.pptx +0 -0
- package/skills/make-figures/references/visual_abstract_templates/medsci_default.pptx +0 -0
- package/skills/make-figures/references/visual_abstract_templates/template_guide.md +114 -0
- package/skills/make-figures/scripts/build_jacc_template.py +77 -0
- package/skills/make-figures/scripts/build_prisma2020_template.py +371 -0
- package/skills/make-figures/scripts/build_strobe_template.py +351 -0
- package/skills/make-figures/scripts/critic_figure.py +264 -0
- package/skills/make-figures/scripts/derive_figure_legend_counts.py +138 -0
- package/skills/make-figures/scripts/extract_exemplar_from_pdf.py +186 -0
- package/skills/make-figures/scripts/fetch_official_templates.sh +88 -0
- package/skills/make-figures/scripts/fill_prisma_template.py +142 -0
- package/skills/make-figures/scripts/generate_flow_diagram.R +133 -0
- package/skills/make-figures/scripts/generate_image.py +99 -0
- package/skills/make-figures/scripts/generate_visual_abstract.py +438 -0
- package/skills/make-figures/scripts/validate_pptx_mac_compat.py +233 -0
- package/skills/make-figures/skill.yml +52 -0
- package/skills/make-figures/templates/official/NOTES.md +62 -0
- package/skills/make-figures/templates/official/consort2010/CONSORT_2025_editable_checklist.docx +0 -0
- package/skills/make-figures/templates/official/consort2010/CONSORT_2025_flow_diagram.docx +0 -0
- package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_new_v1.pptx +0 -0
- package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_new_v2.pptx +0 -0
- package/skills/make-figures/templates/official/prisma2020/PRISMA_2020_flow_updated_v2.pptx +0 -0
- package/skills/make-figures/templates/official/spirit2013/SPIRIT_2025_editable_checklist.docx +0 -0
- package/skills/make-figures/templates/official/spirit2013/SPIRIT_2025_participant_timeline.docx +0 -0
- package/skills/make-figures/templates/official/stard2015/STARD_2015_checklist.docx +0 -0
- package/skills/make-figures/templates/official/stard2015/STARD_2015_flow_diagram.pdf +0 -0
- package/skills/make-figures/tests/fixtures/figure1_flow.yaml +8 -0
- package/skills/make-figures/tests/fixtures/manuscript_ok.md +9 -0
- package/skills/make-figures/tests/fixtures/manuscript_stale.md +4 -0
- package/skills/make-figures/tests/test_legend_reconcile.sh +36 -0
- package/skills/manage-project/SKILL.md +358 -0
- package/skills/manage-project/references/pre_submission_checklist.md +53 -0
- package/skills/manage-project/references/project_state_template.json +37 -0
- package/skills/manage-project/references/scaffold_templates.md +118 -0
- package/skills/manage-project/references/status_output_format.md +44 -0
- package/skills/manage-project/references/timeline_example.md +20 -0
- package/skills/manage-project/skill.yml +36 -0
- package/skills/manage-project/templates/SSOT.yaml.template +41 -0
- package/skills/manage-refs/LICENSE.zotero-mcp +21 -0
- package/skills/manage-refs/NOTICE.md +29 -0
- package/skills/manage-refs/SKILL.md +289 -0
- package/skills/manage-refs/citation_styles/README.md +40 -0
- package/skills/manage-refs/citation_styles/american-journal-of-roentgenology.csl +211 -0
- package/skills/manage-refs/citation_styles/cardiovascular-and-interventional-radiology.csl +19 -0
- package/skills/manage-refs/citation_styles/european-radiology.csl +19 -0
- package/skills/manage-refs/citation_styles/journal-of-cachexia-sarcopenia-and-muscle.csl +150 -0
- package/skills/manage-refs/citation_styles/journal-of-korean-medical-science-strict.csl +533 -0
- package/skills/manage-refs/citation_styles/journal-of-korean-medical-science.csl +16 -0
- package/skills/manage-refs/citation_styles/korean-journal-of-radiology.csl +155 -0
- package/skills/manage-refs/citation_styles/nature.csl +189 -0
- package/skills/manage-refs/citation_styles/nlm-citation-sequence.csl +535 -0
- package/skills/manage-refs/citation_styles/radiology.csl +228 -0
- package/skills/manage-refs/citation_styles/springer-basic-brackets.csl +187 -0
- package/skills/manage-refs/citation_styles/springer-vancouver-brackets.csl +276 -0
- package/skills/manage-refs/citation_styles/vancouver-superscript.csl +536 -0
- package/skills/manage-refs/citation_styles/vancouver.csl +535 -0
- package/skills/manage-refs/references/REFERENCE_STYLE_SPECS.md +59 -0
- package/skills/manage-refs/references/check_xref_symptoms.md +35 -0
- package/skills/manage-refs/scripts/_vendor_citation_writer.py +600 -0
- package/skills/manage-refs/scripts/check_citation_keys.py +112 -0
- package/skills/manage-refs/scripts/check_csl_render.py +102 -0
- package/skills/manage-refs/scripts/check_xref.py +633 -0
- package/skills/manage-refs/scripts/fill_journal_abbrev.py +104 -0
- package/skills/manage-refs/scripts/inject_zotero_cwyw.py +133 -0
- package/skills/manage-refs/scripts/md_marker_convert.py +193 -0
- package/skills/manage-refs/scripts/pre_submission_gate.sh +238 -0
- package/skills/manage-refs/scripts/render_pandoc.sh +88 -0
- package/skills/manage-refs/skill.yml +70 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/README.md +32 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/manuscript.md +10 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/refs.bib +34 -0
- package/skills/manage-refs/tests/fixtures/pre_submission_gate/run.sh +117 -0
- package/skills/manage-refs/tests/test_vN_docx_check.sh +145 -0
- package/skills/meta-analysis/SKILL.md +739 -0
- package/skills/meta-analysis/references/LICENSES.md +21 -0
- package/skills/meta-analysis/references/PROSPERO_template.md +221 -0
- package/skills/meta-analysis/references/ai_pre_screening_template.py +245 -0
- package/skills/meta-analysis/references/checklists/JBI_Case_Series.md +45 -0
- package/skills/meta-analysis/references/checklists/NOS.md +88 -0
- package/skills/meta-analysis/references/checklists/PRISMA_DTA.md +36 -0
- package/skills/meta-analysis/references/checklists/PROBAST.md +75 -0
- package/skills/meta-analysis/references/checklists/QUADAS2.md +77 -0
- package/skills/meta-analysis/references/checklists/ROBINS_I.md +87 -0
- package/skills/meta-analysis/references/checklists/RoB2.md +79 -0
- package/skills/meta-analysis/references/data_integrity_checklist.md +57 -0
- package/skills/meta-analysis/references/icmje_coi_guide.md +181 -0
- package/skills/meta-analysis/references/phase10_recovery.md +136 -0
- package/skills/meta-analysis/references/phase4_km_composite.md +58 -0
- package/skills/meta-analysis/references/phase6_statistical_synthesis.md +148 -0
- package/skills/meta-analysis/references/phase9_circulation.md +84 -0
- package/skills/meta-analysis/references/post_submission_release_ops.md +41 -0
- package/skills/meta-analysis/references/r_templates.md +132 -0
- package/skills/meta-analysis/references/review_orchestration.md +40 -0
- package/skills/meta-analysis/references/submission_package_drift.md +71 -0
- package/skills/meta-analysis/scripts/check_pool_consistency.py +201 -0
- package/skills/meta-analysis/scripts/cohort_overlap_check.py +242 -0
- package/skills/meta-analysis/scripts/dta_extraction_qc.py +137 -0
- package/skills/meta-analysis/scripts/screening_reconcile.py +160 -0
- package/skills/meta-analysis/skill.yml +47 -0
- package/skills/meta-analysis/templates/FINAL_POOL_LOCK.yaml.template +70 -0
- package/skills/meta-analysis/templates/extraction_form_v2.md +129 -0
- package/skills/meta-analysis/templates/supplementary_8file_checklist.md +94 -0
- package/skills/meta-analysis/tests/test_pool_consistency.sh +123 -0
- package/skills/orchestrate/SKILL.md +501 -0
- package/skills/orchestrate/references/dialogue_nodes.md +196 -0
- package/skills/orchestrate/references/report_template.md +109 -0
- package/skills/orchestrate/references/report_template_ko.md +88 -0
- package/skills/orchestrate/skill.yml +44 -0
- package/skills/peer-review/SKILL.md +381 -0
- package/skills/peer-review/references/aczel_2021_reviewer2_patterns.md +88 -0
- package/skills/peer-review/references/domain-probes/ai_overclaiming.md +47 -0
- package/skills/peer-review/references/domain-probes/narrative_review.md +44 -0
- package/skills/peer-review/references/domain-probes/observational_confounding.md +48 -0
- package/skills/peer-review/references/domain-probes/radiomics.md +38 -0
- package/skills/peer-review/references/domain-probes/sr_ma.md +87 -0
- package/skills/peer-review/references/domain-probes/survival_prognostic.md +68 -0
- package/skills/peer-review/references/exemplar_reviews/README.md +43 -0
- package/skills/peer-review/references/exemplar_reviews/ai_overclaiming.md +47 -0
- package/skills/peer-review/references/exemplar_reviews/calibration_missing.md +44 -0
- package/skills/peer-review/references/exemplar_reviews/data_leakage.md +48 -0
- package/skills/peer-review/references/exemplar_reviews/reference_standard_validity.md +45 -0
- package/skills/peer-review/references/narrative_review_audit.md +67 -0
- package/skills/peer-review/references/reviewer_calibration/README.md +34 -0
- package/skills/peer-review/references/reviewer_calibration/compliance_floor.md +52 -0
- package/skills/peer-review/references/reviewer_profiles/AJR.md +82 -0
- package/skills/peer-review/references/reviewer_profiles/EURE.md +64 -0
- package/skills/peer-review/references/reviewer_profiles/INSI.md +57 -0
- package/skills/peer-review/references/reviewer_profiles/KJR.md +100 -0
- package/skills/peer-review/references/reviewer_profiles/README.md +32 -0
- package/skills/peer-review/references/reviewer_profiles/RYAI.md +86 -0
- package/skills/peer-review/skill.yml +39 -0
- package/skills/present-paper/SKILL.md +675 -0
- package/skills/present-paper/references/critic_rubrics/slide.md +155 -0
- package/skills/present-paper/references/generate_pptx_templates.py +604 -0
- package/skills/present-paper/references/medical_presentation_templates.md +277 -0
- package/skills/present-paper/references/slide_design_principles.md +202 -0
- package/skills/present-paper/references/slide_visual_styles/nature_lancet.md +168 -0
- package/skills/present-paper/references/workflow-checklist.md +109 -0
- package/skills/present-paper/scripts/extract_pdf_figures.py +243 -0
- package/skills/present-paper/scripts/inject_pronunciation_notes.py +178 -0
- package/skills/present-paper/scripts/inject_speaker_notes.py +133 -0
- package/skills/present-paper/scripts/strip_notes_for_sharing.py +140 -0
- package/skills/present-paper/scripts/trim_caption.py +271 -0
- package/skills/present-paper/skill.yml +41 -0
- package/skills/present-paper/templates/build_pptx_nature_lancet.py +688 -0
- package/skills/publish-skill/SKILL.md +370 -0
- package/skills/publish-skill/references/license-compatibility-matrix.md +132 -0
- package/skills/publish-skill/references/pii-patterns.md +130 -0
- package/skills/publish-skill/scripts/audit_skill.sh +278 -0
- package/skills/publish-skill/skill.yml +35 -0
- package/skills/render-pdf-doc/SKILL.md +146 -0
- package/skills/render-pdf-doc/references/known_pitfalls.md +53 -0
- package/skills/render-pdf-doc/references/pandoc_korean_cheatsheet.md +77 -0
- package/skills/render-pdf-doc/scripts/check_deps.sh +42 -0
- package/skills/render-pdf-doc/scripts/infer_colwidths.py +164 -0
- package/skills/render-pdf-doc/scripts/render_pdf.sh +98 -0
- package/skills/render-pdf-doc/skill.yml +57 -0
- package/skills/render-pdf-doc/templates/anchor-doc.md +27 -0
- package/skills/render-pdf-doc/templates/anchor-doc_ko.md +25 -0
- package/skills/render-pdf-doc/templates/briefing-handout.md +33 -0
- package/skills/render-pdf-doc/templates/briefing-handout_ko.md +31 -0
- package/skills/render-pdf-doc/templates/proposal-cover.md +33 -0
- package/skills/render-pdf-doc/templates/proposal-cover_ko.md +31 -0
- package/skills/render-pdf-doc/templates/reference-table.md +22 -0
- package/skills/render-pdf-doc/templates/reference-table_ko.md +20 -0
- package/skills/replicate-study/SKILL.md +150 -0
- package/skills/replicate-study/references/harmonization_3country.csv +47 -0
- package/skills/replicate-study/references/harmonization_knhanes_nhanes.csv +68 -0
- package/skills/replicate-study/references/methodology_extraction_template.md +134 -0
- package/skills/replicate-study/skill.yml +37 -0
- package/skills/review-paper/SKILL.md +104 -0
- package/skills/review-paper/references/macro_skeleton.md +6 -0
- package/skills/review-paper/skill.yml +25 -0
- package/skills/revise/SKILL.md +515 -0
- package/skills/revise/references/r2r_voice.md +346 -0
- package/skills/revise/skill.yml +43 -0
- package/skills/search-lit/SKILL.md +443 -0
- package/skills/search-lit/references/parse_pubmed.py +326 -0
- package/skills/search-lit/references/pubmed_eutils.sh +111 -0
- package/skills/search-lit/skill.yml +46 -0
- package/skills/self-review/SKILL.md +1045 -0
- package/skills/self-review/references/domain-probes/ai_overclaiming.md +47 -0
- package/skills/self-review/references/domain-probes/narrative_review.md +44 -0
- package/skills/self-review/references/domain-probes/observational_confounding.md +48 -0
- package/skills/self-review/references/domain-probes/radiomics.md +38 -0
- package/skills/self-review/references/domain-probes/sr_ma.md +87 -0
- package/skills/self-review/references/domain-probes/survival_prognostic.md +68 -0
- package/skills/self-review/references/exemplar_findings/README.md +43 -0
- package/skills/self-review/references/exemplar_findings/cohort_arithmetic_mismatch.md +35 -0
- package/skills/self-review/references/exemplar_findings/estimand_drift_posthoc_primary.md +39 -0
- package/skills/self-review/references/exemplar_findings/scope_overreach_cross_sectional.md +35 -0
- package/skills/self-review/references/exemplar_findings/unadjusted_confounder.md +36 -0
- package/skills/self-review/references/panel_review_template.md +177 -0
- package/skills/self-review/scripts/check_artifact_coverage.py +301 -0
- package/skills/self-review/scripts/check_claim_artifact.py +248 -0
- package/skills/self-review/scripts/check_classical_style.py +185 -0
- package/skills/self-review/scripts/check_cohort_arithmetic.py +481 -0
- package/skills/self-review/scripts/check_confounding_completeness.py +287 -0
- package/skills/self-review/scripts/check_panel_diversity.py +336 -0
- package/skills/self-review/scripts/check_reference_adequacy.py +392 -0
- package/skills/self-review/scripts/check_reviewer_team_consistency.py +412 -0
- package/skills/self-review/scripts/check_scope_coherence.py +177 -0
- package/skills/self-review/skill.yml +47 -0
- package/skills/self-review/tests/fixtures/claim_manuscript.md +17 -0
- package/skills/self-review/tests/fixtures/claim_prereg.md +6 -0
- package/skills/self-review/tests/fixtures/cohort_bad.md +21 -0
- package/skills/self-review/tests/fixtures/cohort_clean.md +21 -0
- package/skills/self-review/tests/fixtures/cohort_partition.csv +5 -0
- package/skills/self-review/tests/fixtures/coverage_analysis/31_delong_nested_added_value.csv +3 -0
- package/skills/self-review/tests/fixtures/coverage_analysis/table1_demographics.csv +3 -0
- package/skills/self-review/tests/fixtures/coverage_clean.md +13 -0
- package/skills/self-review/tests/fixtures/coverage_manuscript.md +11 -0
- package/skills/self-review/tests/fixtures/panel_collapse.json +27 -0
- package/skills/self-review/tests/fixtures/panel_good.json +32 -0
- package/skills/self-review/tests/fixtures/panel_monoculture.json +32 -0
- package/skills/self-review/tests/fixtures/refadeq_letter.md +13 -0
- package/skills/self-review/tests/fixtures/refadeq_original_fixed.md +42 -0
- package/skills/self-review/tests/fixtures/refadeq_original_uncited.md +40 -0
- package/skills/self-review/tests/fixtures/scope_bad.md +9 -0
- package/skills/self-review/tests/fixtures/scope_clean.md +8 -0
- package/skills/self-review/tests/fixtures/scope_surrogate.md +8 -0
- package/skills/self-review/tests/fixtures/style_bad.md +13 -0
- package/skills/self-review/tests/fixtures/style_clean.md +11 -0
- package/skills/self-review/tests/fixtures/table1_by_exposure.csv +11 -0
- package/skills/self-review/tests/test_artifact_coverage.sh +44 -0
- package/skills/self-review/tests/test_claim_artifact.sh +50 -0
- package/skills/self-review/tests/test_classical_style.sh +44 -0
- package/skills/self-review/tests/test_cohort_arithmetic.sh +49 -0
- package/skills/self-review/tests/test_confounding_completeness.sh +66 -0
- package/skills/self-review/tests/test_panel_diversity.sh +55 -0
- package/skills/self-review/tests/test_panel_mode.sh +69 -0
- package/skills/self-review/tests/test_reference_adequacy.sh +68 -0
- package/skills/self-review/tests/test_reviewer_team_consistency.sh +138 -0
- package/skills/self-review/tests/test_scope_coherence.sh +46 -0
- package/skills/setup-medsci/SKILL.md +110 -0
- package/skills/setup-medsci/references/setup-checklist.md +51 -0
- package/skills/setup-medsci/skill.yml +30 -0
- package/skills/sync-submission/SKILL.md +382 -0
- package/skills/sync-submission/scripts/author_registry_example.yaml +36 -0
- package/skills/sync-submission/scripts/blind_sweep.py +203 -0
- package/skills/sync-submission/scripts/check_asset_anonymization.py +300 -0
- package/skills/sync-submission/scripts/check_cross_artifact_stale.py +211 -0
- package/skills/sync-submission/scripts/cover_letter_drift_check.py +451 -0
- package/skills/sync-submission/scripts/cross_document_n_check.py +486 -0
- package/skills/sync-submission/scripts/detect_copy_divergence.py +136 -0
- package/skills/sync-submission/scripts/preflight_gate.py +458 -0
- package/skills/sync-submission/scripts/scope_drift_check.py +362 -0
- package/skills/sync-submission/scripts/sync_submission.py +169 -0
- package/skills/sync-submission/skill.yml +43 -0
- package/skills/sync-submission/tests/fixtures/copy_ok.md +5 -0
- package/skills/sync-submission/tests/fixtures/copy_stale.md +5 -0
- package/skills/sync-submission/tests/fixtures/ssot.md +5 -0
- package/skills/sync-submission/tests/test_asset_anonymization.sh +99 -0
- package/skills/sync-submission/tests/test_copy_divergence.sh +44 -0
- package/skills/sync-submission/tests/test_cross_artifact_stale.sh +80 -0
- package/skills/sync-submission/tests/test_cross_document_n.sh +132 -0
- package/skills/sync-submission/tests/test_preflight_gate.sh +112 -0
- package/skills/sync-submission/tests/test_scope_drift.sh +122 -0
- package/skills/sync-submission/tests/test_vN_docx_assertion.sh +51 -0
- package/skills/verify-refs/SKILL.md +177 -0
- package/skills/verify-refs/references/manual_checkpoint_guide.md +100 -0
- package/skills/verify-refs/scripts/verify_cli.sh +62 -0
- package/skills/verify-refs/scripts/verify_refs.py +782 -0
- package/skills/verify-refs/skill.yml +44 -0
- package/skills/verify-refs/tests/fixtures/pagination_placeholder.bib +17 -0
- package/skills/verify-refs/tests/test_pagination_placeholder.sh +42 -0
- package/skills/version-dataset/SKILL.md +143 -0
- package/skills/version-dataset/references/manifest_schema.md +72 -0
- package/skills/version-dataset/scripts/version_dataset.py +242 -0
- package/skills/version-dataset/skill.yml +35 -0
- package/skills/version-dataset/tests/test_version_dataset.sh +52 -0
- package/skills/write-paper/SKILL.md +1148 -0
- package/skills/write-paper/references/exemplar_methods/README.md +38 -0
- package/skills/write-paper/references/exemplar_methods/ai_validation_tripod_claim.md +47 -0
- package/skills/write-paper/references/exemplar_methods/diagnostic_accuracy_stard.md +50 -0
- package/skills/write-paper/references/exemplar_methods/observational_cohort_strobe.md +43 -0
- package/skills/write-paper/references/journal_profiles/AJNR.md +185 -0
- package/skills/write-paper/references/journal_profiles/AJR.md +149 -0
- package/skills/write-paper/references/journal_profiles/Abdominal_Radiology.md +139 -0
- package/skills/write-paper/references/journal_profiles/Academic_Radiology.md +90 -0
- package/skills/write-paper/references/journal_profiles/Annals_of_Internal_Medicine.md +150 -0
- package/skills/write-paper/references/journal_profiles/Artificial_Intelligence_in_Medicine.md +82 -0
- package/skills/write-paper/references/journal_profiles/British_Journal_of_Radiology.md +161 -0
- package/skills/write-paper/references/journal_profiles/CVIR.md +157 -0
- package/skills/write-paper/references/journal_profiles/Chest.md +270 -0
- package/skills/write-paper/references/journal_profiles/Clinical_Radiology.md +160 -0
- package/skills/write-paper/references/journal_profiles/Clinical_and_Molecular_Hepatology.md +147 -0
- package/skills/write-paper/references/journal_profiles/Diabetes_Metabolism_Journal.md +163 -0
- package/skills/write-paper/references/journal_profiles/Diagnostic_and_Interventional_Radiology.md +216 -0
- package/skills/write-paper/references/journal_profiles/Endocrinology_and_Metabolism.md +167 -0
- package/skills/write-paper/references/journal_profiles/European_Journal_of_Preventive_Cardiology.md +192 -0
- package/skills/write-paper/references/journal_profiles/European_Radiology.md +159 -0
- package/skills/write-paper/references/journal_profiles/Hepatology_Communications.md +110 -0
- package/skills/write-paper/references/journal_profiles/Hepatology_International.md +106 -0
- package/skills/write-paper/references/journal_profiles/IEEE_TMI.md +180 -0
- package/skills/write-paper/references/journal_profiles/INSI.md +163 -0
- package/skills/write-paper/references/journal_profiles/Investigative_Radiology.md +86 -0
- package/skills/write-paper/references/journal_profiles/JACC_Advances.md +197 -0
- package/skills/write-paper/references/journal_profiles/JACC_Asia.md +168 -0
- package/skills/write-paper/references/journal_profiles/JACR.md +87 -0
- package/skills/write-paper/references/journal_profiles/JAMA.md +188 -0
- package/skills/write-paper/references/journal_profiles/JAMA_Network_Open.md +170 -0
- package/skills/write-paper/references/journal_profiles/JCSM.md +266 -0
- package/skills/write-paper/references/journal_profiles/JKMS.md +201 -0
- package/skills/write-paper/references/journal_profiles/JMIR.md +88 -0
- package/skills/write-paper/references/journal_profiles/JMIR_Medical_Education.md +86 -0
- package/skills/write-paper/references/journal_profiles/JNIS.md +227 -0
- package/skills/write-paper/references/journal_profiles/JVIR.md +158 -0
- package/skills/write-paper/references/journal_profiles/Journal_of_Clinical_Endocrinology_and_Metabolism.md +191 -0
- package/skills/write-paper/references/journal_profiles/Journal_of_Stroke.md +176 -0
- package/skills/write-paper/references/journal_profiles/KJR.md +185 -0
- package/skills/write-paper/references/journal_profiles/Korean_Circulation_Journal.md +184 -0
- package/skills/write-paper/references/journal_profiles/Korean_Journal_of_Internal_Medicine.md +178 -0
- package/skills/write-paper/references/journal_profiles/Lancet_Gastroenterology_and_Hepatology.md +127 -0
- package/skills/write-paper/references/journal_profiles/Liver_International.md +165 -0
- package/skills/write-paper/references/journal_profiles/Medical_Image_Analysis.md +147 -0
- package/skills/write-paper/references/journal_profiles/NEJM.md +147 -0
- package/skills/write-paper/references/journal_profiles/Nature_Medicine.md +181 -0
- package/skills/write-paper/references/journal_profiles/Neuroradiology.md +151 -0
- package/skills/write-paper/references/journal_profiles/Nutrition_Metabolism_and_Cardiovascular_Diseases.md +184 -0
- package/skills/write-paper/references/journal_profiles/PLOS_Medicine.md +166 -0
- package/skills/write-paper/references/journal_profiles/RYAI.md +124 -0
- package/skills/write-paper/references/journal_profiles/Radiology.md +173 -0
- package/skills/write-paper/references/journal_profiles/Skeletal_Radiology.md +135 -0
- package/skills/write-paper/references/journal_profiles/Stroke.md +210 -0
- package/skills/write-paper/references/journal_profiles/The_BMJ.md +121 -0
- package/skills/write-paper/references/journal_profiles/The_Lancet.md +112 -0
- package/skills/write-paper/references/journal_profiles/The_Lancet_Digital_Health.md +104 -0
- package/skills/write-paper/references/journal_profiles/World_Journal_of_Hepatology.md +106 -0
- package/skills/write-paper/references/journal_profiles/npj_Digital_Medicine.md +93 -0
- package/skills/write-paper/references/paper_types/ai_validation.md +270 -0
- package/skills/write-paper/references/paper_types/animal_study.md +194 -0
- package/skills/write-paper/references/paper_types/case_report.md +237 -0
- package/skills/write-paper/references/paper_types/cross_national.md +328 -0
- package/skills/write-paper/references/paper_types/letter.md +127 -0
- package/skills/write-paper/references/paper_types/meta_analysis.md +181 -0
- package/skills/write-paper/references/paper_types/nhis_cohort.md +297 -0
- package/skills/write-paper/references/paper_types/original_article.md +221 -0
- package/skills/write-paper/references/paper_types/technical_note.md +131 -0
- package/skills/write-paper/references/section_guides/discussion.md +155 -0
- package/skills/write-paper/references/section_guides/introduction.md +108 -0
- package/skills/write-paper/references/section_guides/methods.md +144 -0
- package/skills/write-paper/references/section_guides/results.md +113 -0
- package/skills/write-paper/references/section_guides/step7_1_classical_qc.md +67 -0
- package/skills/write-paper/references/section_guides/step7_4a_audit_recovery.md +74 -0
- package/skills/write-paper/references/section_guides/title_abstract.md +123 -0
- package/skills/write-paper/references/section_templates/methods_statistical.md +147 -0
- package/skills/write-paper/scripts/check_placeholders.py +182 -0
- package/skills/write-paper/skill.yml +48 -0
- package/skills/write-paper/tests/test_placeholders.sh +107 -0
- package/skills/write-protocol/SKILL.md +243 -0
- package/skills/write-protocol/references/ethics_checklist.md +150 -0
- package/skills/write-protocol/references/protocol_template.md +304 -0
- package/skills/write-protocol/skill.yml +34 -0
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# npj Digital Medicine
|
|
2
|
+
|
|
3
|
+
## Journal Identity
|
|
4
|
+
|
|
5
|
+
- **Full name**: npj Digital Medicine
|
|
6
|
+
- **Abbreviation**: npj Digit. Med.
|
|
7
|
+
- **Publisher**: Nature Portfolio (Springer Nature)
|
|
8
|
+
- **ISSN**: 2398-6352 (online)
|
|
9
|
+
- **Frequency**: Continuous (online only)
|
|
10
|
+
- **Impact Factor**: High-impact digital health journal
|
|
11
|
+
- **Open Access**: Yes (CC BY 4.0 or CC BY-NC-ND 4.0)
|
|
12
|
+
- **APC**: ~EUR 2,490 (check current rates)
|
|
13
|
+
|
|
14
|
+
## Manuscript Types and Word Limits
|
|
15
|
+
|
|
16
|
+
| Type | Abstract | Manuscript Body | References | Notes |
|
|
17
|
+
|------|----------|----------------|------------|-------|
|
|
18
|
+
| Article | Structured | No strict limit (concise recommended) | No cap | Primary research |
|
|
19
|
+
| Review | Structured | No strict limit | No cap | |
|
|
20
|
+
| Brief Communication | Unstructured | Shorter than Article | No cap | |
|
|
21
|
+
| Perspective | Unstructured | ~3,000 | No cap | |
|
|
22
|
+
| Comment | Unstructured | ~1,500 | No cap | |
|
|
23
|
+
| Matters Arising | Brief summary | ≤ 1,200 | 15 | No APC; on npj Digit. Med. papers only |
|
|
24
|
+
|
|
25
|
+
## Abstract Format
|
|
26
|
+
|
|
27
|
+
Structured with three headings:
|
|
28
|
+
1. **Background**
|
|
29
|
+
2. **Methods**
|
|
30
|
+
3. **Results**
|
|
31
|
+
|
|
32
|
+
Typical length 250-350 words (no explicit cap stated).
|
|
33
|
+
|
|
34
|
+
## Keywords
|
|
35
|
+
|
|
36
|
+
Not explicitly required in guidelines.
|
|
37
|
+
|
|
38
|
+
## Required Sections
|
|
39
|
+
|
|
40
|
+
Nature-style order (Methods after Discussion):
|
|
41
|
+
1. **Introduction**
|
|
42
|
+
2. **Results**
|
|
43
|
+
3. **Discussion**
|
|
44
|
+
4. **Methods** (placed after Discussion)
|
|
45
|
+
5. **Data Availability Statement**
|
|
46
|
+
6. **Code Availability Statement** (if custom code used)
|
|
47
|
+
7. **Acknowledgements** (including funding)
|
|
48
|
+
8. **Author Contributions** (CRediT recommended)
|
|
49
|
+
9. **Competing Interests** (mandatory, even if none)
|
|
50
|
+
10. **References**
|
|
51
|
+
11. **Figure Legends** (after References)
|
|
52
|
+
12. **Tables** (at end)
|
|
53
|
+
|
|
54
|
+
## Citation Style
|
|
55
|
+
|
|
56
|
+
- Nature referencing style (numbered, square brackets)
|
|
57
|
+
- Numbered sequentially in order of appearance
|
|
58
|
+
- More than 5 authors: first author only, then "et al."
|
|
59
|
+
- Journal names: italicized, abbreviated with full stops
|
|
60
|
+
- Volume numbers: **bold**
|
|
61
|
+
- URLs: cited parenthetically in text, not in reference list
|
|
62
|
+
- Example: `Schott, D. H., Collins, R. N. & Bretscher, A. Secretory vesicle transport velocity... *J. Cell Biol.* **156**, 35-39 (2002).`
|
|
63
|
+
|
|
64
|
+
## Reporting Guidelines
|
|
65
|
+
|
|
66
|
+
| Study Type | Required Checklist |
|
|
67
|
+
|------------|-------------------|
|
|
68
|
+
| Randomized trials | CONSORT |
|
|
69
|
+
| Systematic reviews | PRISMA |
|
|
70
|
+
| Observational studies | STROBE |
|
|
71
|
+
| Diagnostic/prognostic | STARD, TRIPOD |
|
|
72
|
+
| AI diagnostic accuracy | STARD-AI |
|
|
73
|
+
| AI intervention trial | CONSORT-AI |
|
|
74
|
+
| AI prediction model | TRIPOD+AI |
|
|
75
|
+
| Qualitative research | COREQ or SRQR |
|
|
76
|
+
| Case reports | CARE |
|
|
77
|
+
|
|
78
|
+
Nature Portfolio Reporting Summary required with revised manuscript.
|
|
79
|
+
|
|
80
|
+
## Special Notes
|
|
81
|
+
|
|
82
|
+
- **Initial submission formatting is relaxed**; strict formatting required only at acceptance.
|
|
83
|
+
- **Methods section after Discussion** (Nature family convention, not standard IMRAD).
|
|
84
|
+
- **No Supplementary Methods allowed**: all methods must be in main manuscript.
|
|
85
|
+
- **Single-blind peer review**; typical first decision ~4-6 weeks; desk reject rate ~50%+.
|
|
86
|
+
- **ORCID required** for corresponding author before final submission.
|
|
87
|
+
- **Data Availability and Code Availability** statements mandatory.
|
|
88
|
+
- **LLM/AI policy**: LLMs cannot be authors; document use in Methods section.
|
|
89
|
+
- **Figures**: 300 dpi minimum; panel labels lowercase bold (a, b, c); colorblind-accessible palettes required (avoid red/green).
|
|
90
|
+
- **Supplementary Information**: single merged PDF; large tables as separate "Supplementary Data" files.
|
|
91
|
+
- **Preprints** encouraged and do not compromise novelty.
|
|
92
|
+
- **Manuscript transfer service**: rejected papers can transfer to other Nature Portfolio journals with referee reports.
|
|
93
|
+
- **Statistics section mandatory**: must include test name, n, alpha level, one-tailed vs two-tailed, exact P values.
|
|
@@ -0,0 +1,270 @@
|
|
|
1
|
+
# AI Validation Study — Template for Radiology
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
5
|
+
Template for studies that develop, validate, or compare AI/ML models for medical imaging tasks. Must follow at least one of STARD-AI, TRIPOD+AI, or CLAIM depending on the study type. This template extends the standard IMRAD structure with AI-specific requirements.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Applicable Reporting Guidelines
|
|
10
|
+
|
|
11
|
+
Select based on study type (multiple may apply):
|
|
12
|
+
|
|
13
|
+
| Study Type | Primary Guideline | Also Consider |
|
|
14
|
+
|------------|------------------|---------------|
|
|
15
|
+
| Diagnostic accuracy of AI | STARD-AI | CLAIM |
|
|
16
|
+
| AI prediction model (development) | TRIPOD+AI (Type 1a/1b) | CLAIM |
|
|
17
|
+
| AI prediction model (validation) | TRIPOD+AI (Type 2a/2b/3) | CLAIM |
|
|
18
|
+
| Any AI study in medical imaging | CLAIM 2024 | STARD-AI or TRIPOD+AI |
|
|
19
|
+
| AI-assisted reader study | STARD-AI + reader study guidelines | CLAIM |
|
|
20
|
+
| LLM/MLLM evaluation | CLAIM + custom LLM reporting | -- |
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Title
|
|
25
|
+
|
|
26
|
+
- Include the AI/ML method, clinical task, and study type.
|
|
27
|
+
- Good: "Validation of a Deep Learning Model for Automated Detection of Intracranial Hemorrhage on Noncontrast CT: A Multicenter Study"
|
|
28
|
+
- Good: "Large Language Model Performance in Radiology Board-Style Questions: A Multi-Agent Validation Study"
|
|
29
|
+
- Avoid: vague terms like "novel," "state-of-the-art," or "revolutionary."
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Abstract (Structured, 250 words)
|
|
34
|
+
|
|
35
|
+
Follow the target journal's format. Include:
|
|
36
|
+
- **Purpose**: Clinical problem + study objective.
|
|
37
|
+
- **Materials and Methods**: Dataset size and source, model type, reference standard, primary metric.
|
|
38
|
+
- **Results**: Primary performance metric with 95% CI, key comparison result.
|
|
39
|
+
- **Conclusion**: Clinical implication, not just "the model performed well."
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Introduction (3-4 paragraphs)
|
|
44
|
+
|
|
45
|
+
### Paragraph 1: Clinical Problem
|
|
46
|
+
- The specific clinical task and its importance.
|
|
47
|
+
- Current diagnostic performance, error rates, or workflow bottlenecks.
|
|
48
|
+
- Why AI could help (workload, accuracy, speed, access).
|
|
49
|
+
|
|
50
|
+
### Paragraph 2: Current AI Landscape
|
|
51
|
+
- Prior AI approaches for this task (brief, cite key studies).
|
|
52
|
+
- Gaps: limited validation, single-center, no reader comparison, no generalizability data.
|
|
53
|
+
- For LLM studies: current evidence on LLM/MLLM performance in medical domains.
|
|
54
|
+
- For NLP/LLM extraction studies: name 2-3 closest prior extraction or report-mining papers/systems
|
|
55
|
+
and state the substantive delta (task, dataset, input constraints, method, validation, or workflow),
|
|
56
|
+
not merely that the new system is "novel."
|
|
57
|
+
|
|
58
|
+
### Paragraph 3: Study Objective
|
|
59
|
+
- Precise aim with study design mentioned.
|
|
60
|
+
- Hypothesis if applicable.
|
|
61
|
+
- Template: "The purpose of this study was to {develop and validate / externally validate / compare} {model/system} for {task} using {dataset description}."
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## Materials and Methods
|
|
66
|
+
|
|
67
|
+
### 4.1 Study Design
|
|
68
|
+
- Retrospective vs prospective.
|
|
69
|
+
- Single-center vs multicenter.
|
|
70
|
+
- Development vs validation vs both.
|
|
71
|
+
- Dates of data collection.
|
|
72
|
+
- If development+validation: describe the temporal or geographic separation.
|
|
73
|
+
|
|
74
|
+
### 4.2 Dataset
|
|
75
|
+
|
|
76
|
+
#### Source and Collection
|
|
77
|
+
- Institution(s), imaging modality, date range.
|
|
78
|
+
- How cases were identified (consecutive, sampled, queried).
|
|
79
|
+
- Inclusion and exclusion criteria (be specific).
|
|
80
|
+
|
|
81
|
+
#### Dataset Splitting (for development studies)
|
|
82
|
+
- Training / validation / test split ratios and method.
|
|
83
|
+
- **Critical**: confirm patient-level splitting (not image or exam level).
|
|
84
|
+
- Temporal split preferred over random split (state which was used).
|
|
85
|
+
- If external test set: describe source and independence.
|
|
86
|
+
|
|
87
|
+
#### Dataset Characteristics
|
|
88
|
+
- Total cases, positive/negative distribution.
|
|
89
|
+
- Demographics: age, sex, relevant clinical variables.
|
|
90
|
+
- Image characteristics: scanner models, protocols, acquisition parameters.
|
|
91
|
+
- Case complexity distribution if relevant.
|
|
92
|
+
|
|
93
|
+
### 4.3 Reference Standard
|
|
94
|
+
- How ground truth was established (pathology, follow-up, expert consensus, clinical diagnosis).
|
|
95
|
+
- Number of annotators, their experience level.
|
|
96
|
+
- Annotation process: independent reading, consensus, adjudication.
|
|
97
|
+
- Blinding: annotators blinded to model output and clinical information?
|
|
98
|
+
- Inter-annotator agreement reported (kappa, ICC).
|
|
99
|
+
- Timing between index test and reference standard.
|
|
100
|
+
|
|
101
|
+
### 4.4 AI Model
|
|
102
|
+
|
|
103
|
+
#### For Traditional DL Models
|
|
104
|
+
- Architecture (e.g., ResNet-50, U-Net, YOLO v8) with citation.
|
|
105
|
+
- Input: image size, preprocessing steps (normalization, augmentation).
|
|
106
|
+
- Training: optimizer, learning rate (schedule), batch size, epochs, early stopping criteria.
|
|
107
|
+
- Loss function.
|
|
108
|
+
- Hardware: GPU model, training time.
|
|
109
|
+
- Framework and version (PyTorch 2.x, TensorFlow 2.x).
|
|
110
|
+
|
|
111
|
+
#### For LLM/MLLM Studies
|
|
112
|
+
- Model name and version (e.g., GPT-4o, Claude 3.5 Sonnet, Gemini 1.5 Pro).
|
|
113
|
+
- API access date range (models change over time).
|
|
114
|
+
- Temperature and other generation parameters.
|
|
115
|
+
- Prompt design: system prompt, few-shot examples, chain-of-thought.
|
|
116
|
+
- Full prompts in supplement (or verbatim in methods if short).
|
|
117
|
+
- If multi-agent: agent roles, interaction protocol, consensus mechanism.
|
|
118
|
+
- Input format: text-only, image+text, structured data.
|
|
119
|
+
- For report-text extraction: list each supplied text field separately (e.g., findings, impression,
|
|
120
|
+
clinical history, indication, prior diagnosis, referral text). State whether fields that may contain the
|
|
121
|
+
target label were masked, excluded, or evaluated in a sensitivity analysis.
|
|
122
|
+
- For fine-tuning, LoRA, prompt-engineering, or multi-agent claims: include a same-backbone zero-shot or
|
|
123
|
+
few-shot comparator using the identical input fields, output schema, and test split.
|
|
124
|
+
|
|
125
|
+
#### For Pipeline/System Studies
|
|
126
|
+
- End-to-end system description.
|
|
127
|
+
- Each stage: input, processing, output.
|
|
128
|
+
- Decision points and thresholds.
|
|
129
|
+
- Human-in-the-loop components.
|
|
130
|
+
|
|
131
|
+
### 4.5 Comparators (if applicable)
|
|
132
|
+
- Reader study design: number of readers, experience levels, subspecialty.
|
|
133
|
+
- Reading conditions: blinding, clinical information provided, time constraints.
|
|
134
|
+
- AI-assisted vs unassisted reading protocol.
|
|
135
|
+
- Washout period between reading sessions.
|
|
136
|
+
|
|
137
|
+
### 4.6 Statistical Analysis
|
|
138
|
+
- **Primary metric**: AUC, sensitivity, specificity, accuracy, F1 -- state which and why.
|
|
139
|
+
- **Confidence intervals**: 95% CIs for all primary metrics (bootstrap or exact binomial).
|
|
140
|
+
- **Comparison tests**: DeLong test for AUC comparison, McNemar for sensitivity/specificity.
|
|
141
|
+
- **Adaptation ablation**: when claiming benefit from fine-tuning, LoRA, prompt design, or a wrapper,
|
|
142
|
+
pre-specify the paired comparison against the same-backbone zero-shot/few-shot baseline and report the
|
|
143
|
+
uncertainty for the delta, not only the adapted model's standalone performance.
|
|
144
|
+
- **Input-contamination sensitivity**: for NLP/LLM extraction, report the primary analysis with the
|
|
145
|
+
pre-specified input fields and, when applicable, a sensitivity analysis excluding fields likely to
|
|
146
|
+
contain the answer.
|
|
147
|
+
- **Calibration**: calibration plot, Brier score, calibration slope/intercept (for prediction models).
|
|
148
|
+
- **Subgroup analyses**: pre-specified subgroups with rationale.
|
|
149
|
+
- **Multiple comparisons**: correction method if applicable.
|
|
150
|
+
- **Sample size**: justification or power analysis if prospective.
|
|
151
|
+
- **Software**: version numbers for all statistical packages.
|
|
152
|
+
|
|
153
|
+
### 4.7 Ethics
|
|
154
|
+
- IRB approval with protocol number.
|
|
155
|
+
- Informed consent status.
|
|
156
|
+
- Data de-identification method.
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## Results
|
|
161
|
+
|
|
162
|
+
> **Results = facts and numbers only.** No interpretation, no "why," no prior study
|
|
163
|
+
> comparisons. See SKILL.md Phase 4 anti-interpretation guardrails.
|
|
164
|
+
|
|
165
|
+
### 5.1 Dataset Characteristics
|
|
166
|
+
- Flow diagram (Figure 1): screening, exclusions, final cohorts.
|
|
167
|
+
- Table 1: demographics and baseline characteristics by split (train/val/test) or group.
|
|
168
|
+
- Class distribution: positive/negative cases per split.
|
|
169
|
+
|
|
170
|
+
### 5.2 Model Performance (Primary Endpoint)
|
|
171
|
+
- Table 2: Primary performance metrics with 95% CIs.
|
|
172
|
+
- ROC curve (Figure 2) with AUC and CI.
|
|
173
|
+
- At the chosen operating point: sensitivity, specificity, PPV, NPV.
|
|
174
|
+
- How the operating point was selected (Youden, clinical threshold, fixed sensitivity).
|
|
175
|
+
|
|
176
|
+
### 5.3 Reader Comparison (if applicable)
|
|
177
|
+
- Table 3: Reader performance vs AI performance.
|
|
178
|
+
- Statistical comparison (DeLong, McNemar).
|
|
179
|
+
- AI-assisted vs unassisted reader performance.
|
|
180
|
+
- Reading time comparison if measured.
|
|
181
|
+
|
|
182
|
+
### 5.4 Subgroup Analysis
|
|
183
|
+
- Performance by key subgroups (age, sex, scanner, pathology subtype, difficulty).
|
|
184
|
+
- Present as table or forest plot.
|
|
185
|
+
- State the numbers; do NOT interpret why subgroups differ (save for Discussion).
|
|
186
|
+
|
|
187
|
+
### 5.5 Error Analysis
|
|
188
|
+
- Types of errors (false positives and false negatives).
|
|
189
|
+
- Representative examples (Figure 3+): correctly classified, false positive, false negative.
|
|
190
|
+
- Describe error patterns factually; do NOT speculate on causes (save for Discussion).
|
|
191
|
+
|
|
192
|
+
### 5.6 Calibration (for prediction models)
|
|
193
|
+
- Calibration plot (Figure).
|
|
194
|
+
- Brier score, calibration slope, intercept.
|
|
195
|
+
- Hosmer-Lemeshow or similar test.
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## Discussion
|
|
200
|
+
|
|
201
|
+
> **Before writing:** Collect anchor papers and user input via SKILL.md Phase 5a
|
|
202
|
+
> interactive planning gate.
|
|
203
|
+
|
|
204
|
+
### Paragraph 1: Summary
|
|
205
|
+
- Restate key findings without repeating exact numbers.
|
|
206
|
+
- Frame in context of the study aim.
|
|
207
|
+
|
|
208
|
+
### Paragraphs 2-3: Performance in Context (anchor paper driven)
|
|
209
|
+
- Organize around anchor papers provided by the user.
|
|
210
|
+
- For each anchor paper: state their result → compare with ours → explain discrepancy.
|
|
211
|
+
- Compare to prior models on the same task (cite specific AUC/accuracy from prior studies).
|
|
212
|
+
- Compare to human reader performance (if applicable).
|
|
213
|
+
- Explain performance differences: data, methodology, population.
|
|
214
|
+
|
|
215
|
+
### Paragraph 4: Clinical Deployment Implications
|
|
216
|
+
- Where in the workflow would this fit? (triage, second reader, standalone, quality assurance)
|
|
217
|
+
- What is the intended use case?
|
|
218
|
+
- What decision, workflow step, or downstream action changes if the model is correct? State this before
|
|
219
|
+
making a clinical-utility claim.
|
|
220
|
+
- Implementation considerations: speed, hardware, integration.
|
|
221
|
+
- Regulatory pathway considerations (if relevant).
|
|
222
|
+
|
|
223
|
+
### Paragraph 5: Limitations
|
|
224
|
+
Typical AI study limitations to address honestly:
|
|
225
|
+
1. Retrospective design and selection bias.
|
|
226
|
+
2. Single-center / limited generalizability.
|
|
227
|
+
3. Reference standard limitations (imperfect ground truth).
|
|
228
|
+
4. Dataset size and class imbalance.
|
|
229
|
+
5. Temporal/geographic bias (training and test from same distribution).
|
|
230
|
+
6. For LLMs: model version changes, non-reproducibility, API dependency.
|
|
231
|
+
7. No prospective clinical validation.
|
|
232
|
+
8. No assessment of clinical outcome impact.
|
|
233
|
+
For each: (a) what it is, (b) how mitigated, (c) direction of residual bias.
|
|
234
|
+
|
|
235
|
+
### Conclusion
|
|
236
|
+
- One to two sentences: main finding and primary clinical implication.
|
|
237
|
+
- Must be a citable statement — memorable and specific.
|
|
238
|
+
|
|
239
|
+
---
|
|
240
|
+
|
|
241
|
+
## Special Required Sections
|
|
242
|
+
|
|
243
|
+
### Data Availability Statement
|
|
244
|
+
- Template: "The datasets generated and/or analyzed during the current study are {available in the [repository name] repository, [URL] / not publicly available due to [reason] but are available from the corresponding author on reasonable request}."
|
|
245
|
+
|
|
246
|
+
### Code Availability
|
|
247
|
+
- Template: "The code for {model training / analysis / evaluation} is available at {URL}."
|
|
248
|
+
- If not available: "Code is available from the corresponding author on reasonable request."
|
|
249
|
+
|
|
250
|
+
### AI Disclosure
|
|
251
|
+
- In Methods: "Large language model {name, version} was used for {specific task}. The model was accessed via {API/interface} between {dates}. Generation parameters were set to {temperature, etc.}."
|
|
252
|
+
- In Acknowledgments: "{Tool name} was used for {writing assistance / code generation / data analysis}. All AI-generated content was reviewed and verified by the authors."
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
## Common Pitfalls to Avoid
|
|
257
|
+
|
|
258
|
+
1. **Data leakage**: Preprocessing (normalization statistics) computed on full dataset before splitting.
|
|
259
|
+
2. **Image-level splitting**: Splitting by image rather than by patient allows the same patient in train and test.
|
|
260
|
+
3. **Missing CIs**: Reporting AUC = 0.95 without confidence interval is incomplete.
|
|
261
|
+
4. **No calibration**: AUC measures discrimination only; calibration is essential for prediction models.
|
|
262
|
+
5. **Overclaiming**: "Our model outperformed radiologists" when CIs overlap or test set is small.
|
|
263
|
+
6. **Missing error analysis**: Knowing where the model fails is as important as overall metrics.
|
|
264
|
+
7. **Vague prompts**: For LLM studies, not providing the exact prompts used.
|
|
265
|
+
8. **No intended use**: Not specifying where in the clinical workflow the model would be deployed.
|
|
266
|
+
9. **Cherry-picked operating point**: Choosing the threshold that looks best on the test set.
|
|
267
|
+
10. **Ignoring prevalence**: Reporting PPV/NPV without discussing the study prevalence vs real-world prevalence.
|
|
268
|
+
11. **Input-text contamination**: clinical history, indication, impression, or referral text contains the target diagnosis or label.
|
|
269
|
+
12. **Missing same-backbone baseline**: fine-tuning or prompt-engineering benefit is claimed without a zero-shot/few-shot comparator on the same task.
|
|
270
|
+
13. **Presence-only novelty**: the Introduction says the task is novel but does not position the work against the closest 2-3 prior papers or systems.
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
# Paper Type: Animal Study
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
5
|
+
- **Reporting guideline:** ARRIVE 2.0 (2020) — mandatory
|
|
6
|
+
- **Ethical approval:** IACUC (Institutional Animal Care and Use Committee) approval number required
|
|
7
|
+
- **Typical word count:** 3500–5000 words
|
|
8
|
+
- **Structure:** Abstract → Introduction → Materials and Methods → Results → Discussion → Conclusions
|
|
9
|
+
- **Key requirement:** 3Rs (Replacement, Reduction, Refinement) statement in Methods
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## ARRIVE 2.0 — Essential 10 Items
|
|
14
|
+
|
|
15
|
+
These 10 items are the minimum required for publication. **All must be present.**
|
|
16
|
+
|
|
17
|
+
| # | Item | Where in Paper |
|
|
18
|
+
|---|------|----------------|
|
|
19
|
+
| 1 | Study design | Methods: Study Design |
|
|
20
|
+
| 2 | Sample size | Methods: Sample Size |
|
|
21
|
+
| 3 | Inclusion/exclusion criteria | Methods: Animals |
|
|
22
|
+
| 4 | Randomization | Methods: Randomization |
|
|
23
|
+
| 5 | Blinding | Methods: Blinding |
|
|
24
|
+
| 6 | Outcome measures | Methods: Outcome Measures |
|
|
25
|
+
| 7 | Statistical methods | Methods: Statistical Analysis |
|
|
26
|
+
| 8 | Experimental animals | Methods: Animals |
|
|
27
|
+
| 9 | Experimental procedures | Methods: Procedures |
|
|
28
|
+
| 10 | Results | Results section |
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## Structured Abstract (250 words)
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
Background: [Scientific rationale; why this animal model was used]
|
|
36
|
+
Objective: [Specific aim and hypothesis]
|
|
37
|
+
Methods: [Species, strain, sex, N per group, intervention, primary outcome,
|
|
38
|
+
statistical test]
|
|
39
|
+
Results: [Primary outcome with effect size, 95% CI, and exact p-value]
|
|
40
|
+
Conclusions: [Main finding and translational implication]
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Introduction (400–600 words)
|
|
46
|
+
|
|
47
|
+
1. **Clinical/biological problem:** Why does this research question matter?
|
|
48
|
+
2. **Gap in knowledge:** What is unknown and why animal work is needed to address it.
|
|
49
|
+
3. **Rationale for animal model:** Why was this species/model chosen? What aspects of the human condition does it recapitulate? Cite validation literature for the model.
|
|
50
|
+
4. **Hypothesis and aims:** State explicitly. "We hypothesized that [X]. To test this, we [aim 1], [aim 2], [aim 3]."
|
|
51
|
+
5. **3Rs statement:** "All procedures were performed in accordance with the 3Rs principles (Replacement, Reduction, Refinement)."
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## Materials and Methods (1200–1800 words)
|
|
56
|
+
|
|
57
|
+
### 2.1 Ethical Approval
|
|
58
|
+
|
|
59
|
+
"All animal experiments were approved by the Institutional Animal Care and Use Committee of [Institution] (protocol number [XXXXX]) and conducted in accordance with the [National Institutes of Health Guide for the Care and Use of Laboratory Animals / Korean Animal Protection Act / relevant local regulation]."
|
|
60
|
+
|
|
61
|
+
### 2.2 Animals (ARRIVE Essential Item 8)
|
|
62
|
+
|
|
63
|
+
Report all of the following:
|
|
64
|
+
- Species, strain, substrain (e.g., Sprague-Dawley rat, Charles River, Wilmington, MA)
|
|
65
|
+
- Source (commercial vendor or in-house breeding)
|
|
66
|
+
- Sex (justify if single sex: biological rationale required)
|
|
67
|
+
- Age and weight at the start of the experiment (mean ± SD or range)
|
|
68
|
+
- Health status (specific pathogen-free, germ-free, etc.)
|
|
69
|
+
- Any genetic modification (full genotype for transgenic models)
|
|
70
|
+
|
|
71
|
+
### 2.3 Housing and Husbandry (ARRIVE Recommended)
|
|
72
|
+
|
|
73
|
+
- Housing conditions: cage type, group or individually housed, N per cage
|
|
74
|
+
- Environmental conditions: temperature (°C), humidity (%), light cycle (e.g., 12h light/12h dark, lights on at 07:00)
|
|
75
|
+
- Access to food and water (ad libitum or restricted; specify diet)
|
|
76
|
+
- Acclimatization period before experiment
|
|
77
|
+
- Any enrichment provided
|
|
78
|
+
|
|
79
|
+
### 2.4 Study Design (ARRIVE Essential Item 1)
|
|
80
|
+
|
|
81
|
+
State clearly:
|
|
82
|
+
- Design type: parallel group, crossover, factorial
|
|
83
|
+
- Control groups: sham, vehicle, naïve
|
|
84
|
+
- Number of experimental groups and treatment allocations
|
|
85
|
+
- Timeline (from baseline to final outcome measurement)
|
|
86
|
+
|
|
87
|
+
Include a figure showing the experimental design timeline if complex.
|
|
88
|
+
|
|
89
|
+
### 2.5 Sample Size Justification (ARRIVE Essential Item 2)
|
|
90
|
+
|
|
91
|
+
**Required.** Calculate using G*Power or equivalent. Report:
|
|
92
|
+
- Effect size expected (based on pilot data or literature)
|
|
93
|
+
- α (0.05) and β (0.20, i.e., 80% power)
|
|
94
|
+
- Formula used
|
|
95
|
+
- Calculated N per group
|
|
96
|
+
- Inflation for expected attrition (typically +15–20%)
|
|
97
|
+
|
|
98
|
+
"Sample size was estimated using G*Power (version 3.1.9.7) based on a two-sample t-test with an expected effect size of Cohen's d = [X] (derived from [pilot data/[Author Year]]). With α = 0.05 and 80% power, [N] animals per group were required. Accounting for an estimated [15]% attrition, [N] animals per group were enrolled."
|
|
99
|
+
|
|
100
|
+
### 2.6 Inclusion and Exclusion Criteria (ARRIVE Essential Item 3)
|
|
101
|
+
|
|
102
|
+
State pre-specified criteria applied at the time of animal selection AND during the experiment. Common exclusion reasons: failure to reach surgical endpoint, infection, weight loss >20%, death before planned outcome measurement.
|
|
103
|
+
|
|
104
|
+
"Animals were excluded if: (a) they failed to recover from anesthesia, (b) technical failure of the intervention occurred, or (c) the primary outcome could not be measured. All exclusions were recorded in the study log."
|
|
105
|
+
|
|
106
|
+
### 2.7 Randomization (ARRIVE Essential Item 4)
|
|
107
|
+
|
|
108
|
+
"Animals were randomly allocated to treatment groups using [computer-generated random numbers / block randomization / stratified randomization] with block size [N]. Allocation was performed by [person] who was not involved in [surgery/treatment/outcome assessment]."
|
|
109
|
+
|
|
110
|
+
If randomization was not performed, justify.
|
|
111
|
+
|
|
112
|
+
### 2.8 Blinding (ARRIVE Essential Item 5)
|
|
113
|
+
|
|
114
|
+
"Outcome assessment was performed by [role] who was blinded to group allocation. [Describe specifically what was blinded at each stage: surgery, treatment, outcome assessment, statistical analysis.]"
|
|
115
|
+
|
|
116
|
+
If full blinding was not possible, explain why and what steps were taken to minimize bias.
|
|
117
|
+
|
|
118
|
+
### 2.9 Anesthesia and Procedures (ARRIVE Essential Item 9)
|
|
119
|
+
|
|
120
|
+
- Anesthetic agent, dose, route (e.g., isoflurane 2–3% via inhalation, ketamine 80 mg/kg + xylazine 10 mg/kg i.p.)
|
|
121
|
+
- Monitoring during anesthesia (temperature, heart rate, respiratory rate)
|
|
122
|
+
- Analgesia (pre- and post-operative)
|
|
123
|
+
- Humane endpoints: criteria for euthanasia
|
|
124
|
+
- Specific surgical or experimental procedure: describe in enough detail for replication
|
|
125
|
+
|
|
126
|
+
### 2.10 Outcome Measures (ARRIVE Essential Item 6)
|
|
127
|
+
|
|
128
|
+
For each outcome:
|
|
129
|
+
- Primary or secondary
|
|
130
|
+
- Operational definition
|
|
131
|
+
- Measurement method and equipment (manufacturer, location)
|
|
132
|
+
- Timing of measurements
|
|
133
|
+
- Observer reliability (if applicable: ICC, kappa)
|
|
134
|
+
|
|
135
|
+
### 2.11 Statistical Analysis (ARRIVE Essential Item 7)
|
|
136
|
+
|
|
137
|
+
- State the primary outcome and the test used for the primary analysis
|
|
138
|
+
- Parametric vs. non-parametric decision (justify based on distribution)
|
|
139
|
+
- Mixed-effects models for repeated measures (preferred over repeated ANOVA)
|
|
140
|
+
- Correction for multiple comparisons (Bonferroni, FDR — state which and why)
|
|
141
|
+
- Handling of missing data
|
|
142
|
+
- Software: R (version X.X.X) or SPSS (version X.X); packages used
|
|
143
|
+
- Significance threshold: α = 0.05 (two-tailed)
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## Results (900–1200 words)
|
|
148
|
+
|
|
149
|
+
### 3.1 Animal Attrition
|
|
150
|
+
|
|
151
|
+
Report in a CONSORT-style flow diagram or table:
|
|
152
|
+
- Animals enrolled
|
|
153
|
+
- Animals excluded (reason)
|
|
154
|
+
- Animals analyzed per group
|
|
155
|
+
|
|
156
|
+
"Of [N] enrolled animals, [N] were excluded: [N] due to [reason 1], [N] due to [reason 2]. Final analysis included [N] animals per group."
|
|
157
|
+
|
|
158
|
+
### 3.2 Baseline Characteristics
|
|
159
|
+
|
|
160
|
+
Table comparing groups at baseline (weight, age, any baseline measurements). Include statistical comparison — groups should be comparable.
|
|
161
|
+
|
|
162
|
+
### 3.3 Primary Outcome
|
|
163
|
+
|
|
164
|
+
Report: mean ± SD (or median [IQR]) for each group. Effect size with 95% CI. Exact p-value.
|
|
165
|
+
|
|
166
|
+
"[Primary outcome] was significantly [higher/lower] in [Group A] compared with [Group B] ([mean ± SD] vs. [mean ± SD]; difference, [X] [units]; 95% CI, [lower–upper]; P = [exact value])."
|
|
167
|
+
|
|
168
|
+
### 3.4 Secondary Outcomes and Adverse Events
|
|
169
|
+
|
|
170
|
+
Report all pre-specified secondary outcomes. **Always report adverse events** (infections, weight loss, unexpected deaths) even if none occurred: "No adverse events were observed during the study period."
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## Discussion (600–800 words)
|
|
175
|
+
|
|
176
|
+
1. Summary of main findings (with effect size)
|
|
177
|
+
2. Mechanistic interpretation
|
|
178
|
+
3. Comparison with previous animal studies of same model or intervention
|
|
179
|
+
4. Translational relevance: how do findings relate to the human condition?
|
|
180
|
+
5. Limitations: model limitations (does not fully recapitulate human disease), single sex (if applicable), limited follow-up, sample size
|
|
181
|
+
6. Future directions
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## Common Animal Study Pitfalls
|
|
186
|
+
|
|
187
|
+
1. **Missing IACUC number** — always required; reviewers check this.
|
|
188
|
+
2. **No sample size justification** — G*Power calculation is mandatory.
|
|
189
|
+
3. **Not reporting sex** — increasing pressure to include both sexes or justify exclusion.
|
|
190
|
+
4. **Confounding housing conditions** — different cages, litters, or technicians are confounders; report and control.
|
|
191
|
+
5. **Outcome assessor not blinded** — blinding of outcome assessment is the most important bias control in animal studies.
|
|
192
|
+
6. **Inconsistent or missing humane endpoints** — specify pre-determined criteria for euthanasia.
|
|
193
|
+
7. **Reporting group means without individual data points** — show individual data (dot plots) for small N.
|
|
194
|
+
8. **Using repeated ANOVA without accounting for sphericity** — use linear mixed-effects models instead.
|