limitation-and-risk-writer
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".
Best use case
limitation-and-risk-writer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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".
Teams using limitation-and-risk-writer should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/limitation-and-risk-writer/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How limitation-and-risk-writer Compares
| Feature / Agent | limitation-and-risk-writer | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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".
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills) # Study Limitations Drafter 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. ## When to Use - Writing the limitations subsection within a Discussion section - Drafting a risk/limitation assessment section for a grant proposal - Responding to peer-reviewer criticisms about study weaknesses - Framing the boundary conditions of the study's conclusions - Rewriting a limitations section that is either too dismissive or too self-defeating ## Input Validation This skill accepts: - A list or description of the study's limitations (design, sample, measurement, validation) - Optionally: study type, journal target, tone preference (grant vs manuscript vs rebuttal) Out-of-scope: - Fabricating limitations that the user has not identified - Providing clinical advice about whether the study's weaknesses invalidate its conclusions for patient care > "Study Limitations Drafter helps you word known limitations professionally. Please describe the specific limitations you want to address." ## Core Workflow ### Step 1 — Collect the Limitations Ask the user to specify: 1. **What are the limitations?** (design? sample? measurement? validation? generalizability? follow-up?) 2. **Study type**: to apply domain-appropriate framing (RCT bias sources differ from retrospective cohort) 3. **Context**: Is this for a manuscript limitations paragraph, grant proposal, or reviewer rebuttal? 4. **Tone**: Formal academic / pragmatic grant / defensive rebuttal If limitations are vague (e.g., "small sample"), ask for specifics: What was the sample size? What minimum would have been adequate? ### Step 2 — Categorize Each Limitation 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 | ### Step 3 — Apply the Limitation Formula 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." ### Step 4 — Assemble and Calibrate Tone - **Manuscript limitations paragraph**: start with the most important limitation, group related ones, end with a forward-looking statement about what future studies should do - **Grant proposal risk section**: frame limitations as "challenges" with a mitigation plan (how the current study design addresses or minimizes each risk) - **Reviewer rebuttal**: directly address each criticism with (a) acknowledgment, (b) contextualization of why it does not invalidate the core finding, (c) any additional analysis or text revision offered ### Step 5 — Calibration Check Before finalizing, verify: - [ ] Each limitation is acknowledged without understating or dismissing it - [ ] Each limitation has a stated impact on interpretation - [ ] Each limitation has a mitigation or future direction (avoid dead-end statements) - [ ] The limitations section does not repeat what was already said in the Results section - [ ] Tone is consistent across all limitation statements - [ ] No limitation is fabricated or exaggerated ## Limitation-Type Phrase Bank **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:** - "This limitation is common to all studies of this type" (too dismissive) - "This limitation completely undermines our conclusions" (too catastrophizing) - "Despite these limitations, our study is the first to..." (not a limitation, belongs in strengths) ## Hard Rules - Do not fabricate limitations that the user has not identified or implied - Do not suggest a study is invalid without specific grounds from the user's description - Do not use limitation statements as opportunities to make inflated claims about the study's strength
Related Skills
meta-protocol-writer
Generates a PROSPERO-compliant Meta-analysis protocol based on Title and PICOS. Use when the user wants to write a protocol for a systematic review or meta-analysis.
soft-article-writer
Generates high-quality promotional soft articles with structured outlines, tailored introductions, and optimized titles based on product info and hot topics. Use when you need to write promotional content, "soft articles" (), or marketing copy that integrates product highlights with current trends, news, or industry insights.
multi-source-news-writer
Integrates multiple news sources into a single, cohesive press release using an inverted pyramid structure and AP style. Use when you have raw news content and a topic, and need a professional press release.
cold-chain-risk-calculator
Calculate temperature excursion risks for cold chain transport. Assesses route risk, packaging suitability, and monitoring requirements for biological samples and pharmaceuticals requiring controlled-temperature shipping.
sds-msds-risk-scanner
Extract hazard codes and safety info from chemical safety datasheets.
survival-curve-risk-table
Analyze data with `survival-curve-risk-table` using a reproducible workflow, explicit validation, and structured outputs for review-ready interpretation.
study-limitations-drafter
Use study limitations drafter for academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries.
meta-results-risk-of-bias
Generates the "Risk of Bias" results section for a meta-analysis based on assessment tables and statistics. Use when the user wants to draft the risk of bias analysis text from provided data tables.
lay-press-release-writer
Transform academic papers into university press releases for general.
discharge-summary-writer
Generate hospital discharge summaries from admission data, hospital course.
table-narrative-writer
Converts biomedical table content into clear manuscript or presentation narrative by prioritizing meaningful patterns, contrasts, and interpretation boundaries rather than restating every number.
results-section-writer
Writes the full Results section of a biomedical manuscript from a sufficiently clear result structure, figure inventory, or analysis summary while preserving evidence boundaries and result hierarchy.