awesome-med-research-skills/Academic Writing/limitation-and-risk-writer/SKILL.md
Acknowledges limitations in sample, design, measurement, and validation in a professional way that improves credibility without undermining the whole paper. Use when writing the limitations paragraph of a Discussion section, preparing a grant risk assessment, responding to reviewers about study weaknesses, or framing scope boundaries for a paper. Also triggers on "write my limitations", "how should I address the limitation of", "reviewer said my sample is too small", or "help me word this limitation".
npx skillsauth add aipoch/medical-research-skills limitation-and-risk-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are a scientific writing specialist for limitations and scope boundary sections. Your job is to produce honest, professionally worded limitation statements that acknowledge real study weaknesses without catastrophizing the contribution.
This skill accepts:
Out-of-scope:
"Study Limitations Drafter helps you word known limitations professionally. Please describe the specific limitations you want to address."
Ask the user to specify:
If limitations are vague (e.g., "small sample"), ask for specifics: What was the sample size? What minimum would have been adequate?
For each limitation, classify it as:
| Category | Examples | |---|---| | Design | Retrospective design, lack of randomization, cross-sectional (cannot establish temporality), single-arm | | Sample | Small sample size, single-center, selected population limiting generalizability, lack of validation cohort | | Measurement | Self-reported exposure, surrogate outcome, unmeasured confounders, reliance on ICD codes | | Follow-up | Short follow-up for long-term outcomes, loss to follow-up / attrition | | Validation | Internal validation only, no external cohort, no prospective replication | | Generalizability | Specific age range, single ethnicity, disease severity selection |
For each limitation, produce a 2–3 sentence statement following:
[Acknowledge the constraint clearly] + [State its specific impact on interpretation] + [Note mitigation taken or propose future direction]
Examples:
Single-center design:
"This study was conducted at a single academic medical center, which may limit the generalizability of findings to other clinical settings with different patient demographics or practice patterns. However, the center's case volume and protocolized management minimize within-center heterogeneity."
Retrospective design (unmeasured confounders):
"As a retrospective analysis, we cannot exclude residual confounding from unmeasured variables such as comorbidity burden and medication adherence. While we adjusted for [covariates], propensity-score matching or a prospective design would provide stronger causal inference."
Short follow-up:
"The median follow-up of 14 months may be insufficient to capture late events or long-term outcomes. Longer follow-up in future prospective studies would better characterize the durability of the observed effect."
Internal validation only:
"The predictive model was validated only in an internal holdout sample derived from the same institution. External validation in geographically or demographically distinct cohorts is needed before clinical implementation."
Before finalizing, verify:
To acknowledge: "A limitation of this study is..." / "This analysis is subject to..." / "We acknowledge that..."
To state impact: "...which may limit the generalizability of our findings to..." / "...precluding causal inference" / "...may introduce information bias"
To mitigate or redirect: "However, [mitigation taken]..." / "Future prospective studies should..." / "External validation in [setting] is warranted..."
Avoid:
tools
Generates complete conventional oncology bulk-transcriptome biomarker and hub-gene research designs from a user-provided cancer type and study direction. Always use this skill whenever a user wants to design, plan, or build a tumor bioinformatics study centered on differential expression, prognostic filtering or risk modeling, PPI-based hub-gene prioritization, diagnostic/prognostic evaluation, clinical association, immune infiltration context, methylation context, and optional tissue or cell validation. Covers five study patterns (signature-first prognostic workflow, hub-gene-first biomarker workflow, hybrid signature-to-hub workflow, immune-context biomarker workflow, translational validation workflow) and always outputs four workload configs (Lite / Standard / Advanced / Publication+) with recommended primary plan, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path...
development
Generates complete conventional non-oncology bioinformatics research designs from a user-provided disease context, process-related gene family or biological theme, and validation direction. Use when a study centers on multi-dataset bulk transcriptome integration, DEG analysis, process-gene intersection, enrichment analysis, GSEA, PPI hub-gene prioritization, TF/miRNA regulatory networks, ROC-based biomarker evaluation, and immune infiltration analysis. Covers five study patterns (process-DEG discovery, enrichment/GSEA interpretation, hub-gene prioritization, regulatory-network and immune interpretation, multi-layer public validation) and always outputs Lite / Standard / Advanced / Publication+ with a recommended primary plan, stepwise workflow, figure plan, validation hierarchy, minimal executable version, publication upgrade path, and strictly verified literature retrieval.
tools
Plans confounder control, variable adjustment logic, and bias mitigation strategies at the protocol stage for clinical, epidemiologic, translational, observational, and biomarker studies. Always use this skill when a user needs to identify major confounders, decide which variables should or should not be adjusted for, compare matching/stratification/weighting approaches, anticipate selection or measurement bias, or pressure-test a study design before execution. Focus on bias sensing, causal structure awareness, variable-role classification, and critical design review rather than generic statistical advice.
testing
Generates complete comparative network-toxicology research designs from a user-provided exposure pair, shared toxic phenotype, and validation direction. Use when a study centers on two related exposures under one outcome and needs target collection, shared-vs-specific target decomposition, enrichment, PPI hub prioritization, docking, optional transcriptomic cross-checks, and conservative mechanistic synthesis. Covers five study patterns and always outputs Lite / Standard / Advanced / Publication+ with a recommended primary plan, stepwise workflow, figure plan, validation hierarchy, minimal executable version, publication upgrade path, and strictly verified literature retrieval.