CtrlK
BlogDocsLog inGet started
Tessl Logo

results-and-discussion-writing

Write Results and Discussion sections that separate observations from interpretation and preserve uncertainty.

60

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./writing_skills/results-and-discussion-writing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

The body is a well-organized, lean instruction skill with concrete paragraph patterns and claim-discipline rules that avoid over-claiming and over-hedging. Its only real gaps are the absence of a worked example paragraph and any inline validation/revision checkpoint, plus a slightly cluttered References section and externally-scoped reference paths.

DimensionReasoningScore

Conciseness

The body is lean with no padding: every section adds skill-specific rules (paragraph patterns, tense and claim discipline like 'prefer "is consistent with", "suggests", or "may reflect"') that Claude cannot infer generically, and it assumes Claude's competence about what Results/Discussion sections are. There is no over-explanation of concepts Claude already knows, matching the 'every token earns its place' anchor; the 'Suggested tools' list slightly duplicates frontmatter metadata but is minor.

5 / 5

Actionability

For an instruction-only skill the guidance is concrete: a numbered 5-step workflow, a 3-step Results paragraph pattern, a 4-step Discussion pattern, and specific hedge phrases to use ('is consistent with', 'suggests', 'may reflect'). It stops short of anchor 5 because there is no worked example paragraph demonstrating the patterns applied, which would make the guidance copy-paste ready for the common cases.

4 / 5

Workflow Clarity

The 5-step Workflow is clearly sequenced (decide placement → state observation before interpretation → interpret and compare → separate robust from tentative → close with uncertainties), with subsection patterns reinforcing each step. It sits at 4 rather than 5 because there is no inline validation/revision checkpoint (revision checks are delegated to an external reference file) and no error-recovery guidance, though as a non-destructive writing task no cap applies.

4 / 5

Progressive Disclosure

Structure is good: Overview, Quick Start, Workflow with patterns, Output Contract, and a References section pointing to two clearly-signaled, one-level-deep external files for deeper patterns and revision checks. It does not reach 5 because the referenced files live outside the skill directory under '../_references/' and could not be verified as present in this bundle, and the References section mixes a non-reference directive ('Avoid collapsing unsupported mechanistic speculation...') into the file list, a minor organization gap.

4 / 5

Total

17

/

20

Passed

Description

61%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 concise, in third person, and clearly states what the skill produces, with naturally phrased trigger keywords. Its main weakness is the complete absence of 'when to use it' guidance, which caps completeness at 3, and it could name one or two more concrete actions (e.g., comparing with prior work, handling figure/table references).

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when writing or revising the Results or Discussion section of a paper or manuscript, or when the user mentions results, discussion, findings, or interpretation.'

Name one or two more concrete actions to raise specificity, such as 'compare findings with prior work' or 'anchor observations to figures and tables'.

Include a few natural synonyms (paper, manuscript, findings, interpret results) so the skill triggers for phrasing users actually say.

DimensionReasoningScore

Specificity

The description names a concrete deliverable ('Write Results and Discussion sections') and two concrete quality behaviors ('separate observations from interpretation', 'preserve uncertainty'), which matches the anchor 'names domain and 1-2 concrete actions'. It does not list several specific actions (e.g., structuring paragraph patterns, comparison to literature, tense discipline), so it falls short of anchor 4, but it is far more concrete than the generic anchor 2.

3 / 5

Completeness

The 'what' is clear and specific — writing Results/Discussion sections that separate observation from interpretation — but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is clearly above anchor 2 (the 'what' is not vague) but cannot reach anchor 4 without a 'when' component.

3 / 5

Trigger Term Quality

'Results and Discussion sections' captures exactly the natural phrases a user would say ('write my results section', 'draft the discussion'), giving good keyword coverage. It stays at 4 rather than 5 because common variations and synonyms like 'manuscript', 'paper', 'findings', or 'interpret results' are missing.

4 / 5

Distinctiveness Conflict Risk

'Results and Discussion sections' carves a specific niche in scientific/manuscript writing with distinct triggers, so it is mostly distinct with only minor overlap risk against closely related writing skills (e.g., a generic manuscript-revision or scientific-writing skill). It is not a fully isolated 5 niche since the trigger terms could also appear when users ask for whole-paper editing help.

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 2 suspicious

Warning

Total

14

/

16

Passed

Repository
fernandezbaptiste/CatMaster
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.