Skip to content
alyn
aipoch

Limitation And Risk Writer skill

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 skills add aipoch/medical-research-skills --skill limitation-and-risk-writer
GitHub stars
2,037
Pack installs
898
Alyn Score
58/99
Updated
2 months ago
License
MIT

aipoch

Limitation And Risk Writer

Install Limitation And Risk Writer

Pick your agent. Every command is ready to paste.

$npx skills add aipoch/medical-research-skills --skill limitation-and-risk-writer

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads limitation-and-risk-writer when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the limitation-and-risk-writer skill”. In Codex, type $limitation-and-risk-writer.

The skill itself

SKILL.md

GitHub

Source: 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

Tips for Limitation And Risk Writer

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • This skill ships scripts. Read them before the first run, and run it in a project without secrets first.
  • • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
  • • It is part of a pack with 40 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Limitation And Risk Writer

What does the Limitation And Risk Writer 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".

How do I install Limitation And Risk Writer?

Run "npx skills add aipoch/medical-research-skills --skill limitation-and-risk-writer" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Limitation And Risk Writer work in Cursor and Codex?

Yes. Limitation And Risk Writer uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Limitation And Risk Writer free?

Limitation And Risk Writer is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.

Who made Limitation And Risk Writer?

Limitation And Risk Writer is published by aipoch in the aipoch/medical-research-skills repository, together with 39 other skills.

Similar skills. From other creators.