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).
69
62%
Does it follow best practices?
Impact
Pending
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 defines 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.' Overall, it scores well on completeness and distinctiveness.
Suggestions
Expand the capability list with more specific actions, e.g., 'Write and revise the Methods section of research papers—including study design, participant descriptions, statistical analysis plans, and procedural details—to ensure reproducibility.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Methods section of research papers) and mentions some actions ('write and revise') plus the goal ('ensure reproducibility'), but doesn't list multiple specific concrete actions like structuring subsections, describing statistical analyses, or formatting participant details. | 2 / 3 |
Completeness | Clearly answers both 'what' (write and revise the Methods section of research papers 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', 'reporting-guideline', and 'journal'. These cover the key terms a researcher would naturally use when seeking this help. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — targets a very specific niche (Methods sections of research papers with reporting guidelines). Unlikely to conflict with general writing skills or other academic writing skills due to the explicit IMRAD and guideline references. | 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.
The skill provides a comprehensive and detailed example of a Methods section output, which is its strongest asset. However, it is significantly bloated with generic boilerplate sections (Failure Handling, Output Contract, Required Inputs, Quick Validation) that add no Methods-writing-specific value and waste tokens. The core actionable content—the 10-step algorithm and the example—is solid but buried in unnecessary scaffolding.
Suggestions
Remove or drastically reduce the generic boilerplate sections (Failure Handling, Output Contract, Required Inputs, Recommended Workflow, Quick Validation) which contain no Methods-writing-specific guidance and waste significant token budget.
Add explicit validation checkpoints within the writing workflow, such as 'Cross-check draft against the selected reporting checklist item-by-item; flag any items not addressed' as a concrete feedback loop.
Condense the 'Key Features' and 'When to Use' sections into a brief 2-3 line summary—Claude doesn't need a feature list to understand the skill's purpose.
Move the full example output to a separate reference file (e.g., references/example_rct_methods.md) and keep only a brief example snippet inline to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~200+ lines. It includes many generic sections (Failure Handling, Validation and Safety Rules, Output Contract, Recommended Workflow, Required Inputs) that are boilerplate and not specific to Methods writing. The 'Key Features' section is a marketing-style bullet list that restates what the skill does rather than instructing. Claude already knows how to write Methods sections, handle missing inputs, and follow IMRAD conventions—much of this is redundant. | 1 / 3 |
Actionability | The full example output is a strong concrete artifact showing exactly what a Methods section should look like, and the 10-step algorithm provides specific guidance. However, much of the surrounding content is vague and generic ('Validate the request against the skill boundary', 'Select the documented execution path'). The skill is a writing/documentation skill so code isn't expected, but the actionable parts are diluted by boilerplate. | 2 / 3 |
Workflow Clarity | The 10-step 'Methods-section algorithm' provides a reasonable sequence, but there are no explicit validation checkpoints or feedback loops within the writing process (e.g., 'check draft against CONSORT checklist item-by-item before finalizing'). The generic 'Recommended Workflow' section (validate → select → produce → validate) adds nothing specific. For a skill involving compliance with reporting guidelines, explicit checklist verification steps would be expected. | 2 / 3 |
Progressive Disclosure | The skill references external files (references/imrad_structure.md, references/reporting_guidelines.md, references/writing_principles.md) which is good progressive disclosure. However, the main file itself is monolithic with too much inline content—the full example output, the 10-step algorithm, and all the boilerplate sections could be better organized. The references are mentioned as 'optional, if present' 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 | |
8277276
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.