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
62%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./scientific-skills/Academic Writing/method-writing/SKILL.mdQuality
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.'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
d3c2c0f
Table of Contents
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.