CtrlK
BlogDocsLog inGet started
Tessl Logo

method-writing

Write and revise the Methods section of research papers to ensure reproducibility; use when preparing an IMRAD manuscript or responding to journal/reporting-guideline requirements (e.g., CONSORT/STROBE/PRISMA).

55

Quality

62%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./scientific-skills/Academic Writing/method-writing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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

This is a well-crafted description that clearly identifies its niche (Methods section writing for research papers) and provides explicit trigger conditions with specific reporting guideline acronyms. Its main weakness is that the 'what' portion could be more specific about the concrete actions performed beyond 'write and revise' — e.g., structuring study design, detailing statistical methods, formatting participant flow diagrams.

Suggestions

Expand the capability list with more specific actions, e.g., 'Write and revise the Methods section of research papers — including study design, participant selection, interventions, statistical analysis, and outcome measures — to ensure reproducibility.'

DimensionReasoningScore

Specificity

Names the domain (Methods section of research papers) and mentions some actions ('write and revise') plus ensuring reproducibility, but doesn't list multiple concrete sub-actions like describing statistical analyses, detailing participant recruitment, specifying materials, etc.

2 / 3

Completeness

Clearly answers both 'what' (write and revise the Methods section to ensure reproducibility) and 'when' (use when preparing an IMRAD manuscript or responding to journal/reporting-guideline requirements with specific examples like CONSORT/STROBE/PRISMA).

3 / 3

Trigger Term Quality

Includes strong natural trigger terms users would say: 'Methods section', 'research papers', 'IMRAD', 'reproducibility', 'CONSORT', 'STROBE', 'PRISMA', 'journal', 'reporting-guideline'. These cover the key variations a researcher would naturally mention.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — targets a specific section (Methods) of research papers with explicit reporting guideline references (CONSORT/STROBE/PRISMA). Unlikely to conflict with general writing skills or other academic writing skills focused on different sections.

3 / 3

Total

11

/

12

Passed

Implementation

35%

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

This skill suffers primarily from excessive verbosity and generic boilerplate that dilutes the genuinely useful content (the example and the 10-step algorithm). Roughly half the content consists of generic sections (Output Contract, Failure Handling, Validation and Safety Rules, Required Inputs, Recommended Workflow) that apply to any skill and waste tokens. The core domain knowledge is reasonable but could be delivered in about one-third the current length.

Suggestions

Remove or drastically reduce generic boilerplate sections (Output Contract, Failure Handling, Validation and Safety Rules, Required Inputs, Recommended Workflow, Quick Validation) that are not specific to methods writing—these consume ~40% of the content with zero domain value.

Condense the 'Key Features' marketing-style list into the algorithm itself; each feature should appear only where it's actionable, not as a separate summary.

Add a concrete validation checklist (e.g., a reporting-guideline compliance table) as a feedback loop so Claude can verify completeness of the drafted Methods section against CONSORT/STROBE/PRISMA items.

Either provide the referenced bundle files (imrad_structure.md, reporting_guidelines.md, writing_principles.md) or inline their essential content; hedging with 'if available' provides no actionable guidance when files are absent.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~250+ lines. It includes extensive boilerplate sections (Failure Handling, Validation and Safety Rules, Output Contract, Required Inputs, Recommended Workflow) that are generic and not specific to methods writing. The full example output alone is ~40 lines of template text. Many sections explain things Claude already knows (what IMRAD is, what a Methods section contains, basic statistical concepts). The 'Key Features' section is pure marketing copy that adds no actionable value.

1 / 3

Actionability

The skill provides a detailed example input/output pair and a 10-step algorithm, which gives concrete guidance on what to include. However, there is no executable code (expected for a writing skill), and much of the guidance is descriptive rather than prescriptive—listing categories of things to include rather than giving precise decision rules. The example output is useful but heavily templated with bracketed placeholders.

2 / 3

Workflow Clarity

The 10-step 'Methods-section algorithm' provides a clear sequence, and the 'Recommended Workflow' adds a generic 4-step process. However, there are no meaningful validation checkpoints specific to methods writing—no checklist to verify reporting guideline compliance, no feedback loop for catching omissions. The generic 'Quick Validation' section is essentially empty ('No local script validation step is required').

2 / 3

Progressive Disclosure

The skill references three external files (imrad_structure.md, reporting_guidelines.md, writing_principles.md) which would provide good progressive disclosure, but none are provided in the bundle. The main file itself is monolithic—the full example output, the 10-step algorithm, and all the boilerplate sections could be split into separate references. The references are hedged with 'if available' which weakens their utility.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
aipoch/medical-research-skills
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.