CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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".

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, actionable instruction skill: a concrete limitation formula, worked examples, a phrase bank, and a validation checklist make the drafting workflow fully executable. The main defect is bundle integration — the existing references/audit-reference.md and scripts/main.py are orphaned, never referenced from SKILL.md, leaving genuinely useful functionality undiscoverable.

Suggestions

Add a section in SKILL.md (e.g., '## Tools') that links scripts/main.py for template-based generation (python scripts/main.py --issues retrospective,single_center) and references/audit-reference.md for audit paths, or remove the unused bundle files.

Trim the category table's explanatory parentheticals (e.g., "cross-sectional (cannot establish temporality)") to just the limitation names — Claude already knows these concepts.

Add worked example statements for the Measurement and Generalizability categories, which currently appear in the categorization table but have no template output.

DimensionReasoningScore

Conciseness

The body is efficient — every section serves the drafting task, and the examples and phrase bank are the skill's genuine added value. Minor over-explanation could be trimmed, e.g., the category table's parentheticals "cross-sectional (cannot establish temporality)" and "single-center" explanations restate concepts Claude already knows. It fits anchor 4 (minor instances of over-explanation) rather than anchor 3 (noticeably padded sections) or anchor 5 (nothing trimmable).

4 / 5

Actionability

Concrete, executable guidance throughout: the formula "[Acknowledge the constraint clearly] + [State its specific impact on interpretation] + [Note mitigation taken or propose future direction]", four copy-adaptable worked examples covering the common cases (single-center, retrospective, short follow-up, internal validation), a quotable phrase bank, and per-context tone assembly rules. For an instruction-only skill this is the anchor-5 equivalent of copy-paste-ready code covering common cases; it is not 4 because no key execution detail is missing.

5 / 5

Workflow Clarity

A clear five-step sequence (collect → categorize → apply formula → assemble/calibrate → check) with an explicit validation checklist in Step 5 covering acknowledgment, impact, mitigation, repetition, tone consistency, and fabrication. This matches anchor 5 (explicit validation steps plus a checklist); the skill involves no destructive or batch operations, so no workflow cap applies. It is not 4 because the validation checkpoint is fully explicit, not merely implied.

5 / 5

Progressive Disclosure

The body itself is well-sectioned with clear headers, but the provided bundle is never surfaced: neither references/audit-reference.md nor scripts/main.py is mentioned or linked anywhere in SKILL.md, so a reader would never discover that the script exists (it generates limitation statements from templates). Per the guideline to score against the actual bundle structure, this fits anchor 3 (structure present but references not clearly signaled); it is not 4 because the disconnect is total rather than a minor organization gap, and not 2 because the body's own structure is good and appropriately sized rather than a wall of inlined content.

3 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is well-constructed: third-person voice, a clear statement of what the skill does, an explicit 'Use when' clause, and unusually natural quoted trigger phrases. Its only weaknesses are minor — a few missing synonyms (caveats, threats to validity) and slight overlap risk with adjacent grant/rebuttal writing skills.

DimensionReasoningScore

Specificity

"Acknowledges limitations in sample, design, measurement, and validation" names the domain and the 'Use when' clause enumerates several concrete tasks (limitations paragraph, grant risk assessment, reviewer response, scope boundaries), matching the anchor for several specific actions with minor gaps. It is not 3 because more than 1-2 actions are listed, and not 5 because some capabilities (e.g., rewriting an existing limitations section) are absent.

4 / 5

Completeness

Explicitly answers 'what' ("Acknowledges limitations in sample, design, measurement, and validation in a professional way that improves credibility without undermining the whole paper") and 'when' ("Use when writing the limitations paragraph of a Discussion section...") with concrete quoted trigger phrases, matching anchor 5 exactly. It exceeds anchor 4 because the 'when' clause is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Directly quotes natural user phrasings ("write my limitations", "reviewer said my sample is too small", "help me word this limitation") plus domain terms like "study weaknesses" — good keyword coverage. A few natural synonyms ("caveats", "threats to validity", "weaknesses of my study") are missing, so it fits anchor 4 rather than the comprehensive coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (limitations/scope-boundary writing for research papers) with distinctive triggers like "reviewer said my sample is too small", but "grant risk assessment" and "responding to reviewers about study weaknesses" carry minor overlap risk with closely related grant-writing and rebuttal-letter skills, matching anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

aipoch/medical-research-skills

Path

awesome-med-research-skills/Academic Writing/limitation-and-risk-writer/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.