CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

results-and-discussion-writing

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

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

71%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 lean, well-organized instruction skill with genuinely useful, non-generic writing discipline (paragraph patterns, claim vocabulary, anti-overcorrection). Its main defects are structural: both external reference links are broken (the files do not exist), and one guideline is misfiled under References, which undermines the otherwise good progressive-disclosure design.

Suggestions

Fix the broken references: either create ../_references/section-patterns-and-story.md and ../_references/style-and-revision-checks.md with the promised content, or remove the links and inline the essential patterns.

Move the misfiled bullet 'Avoid collapsing unsupported mechanistic speculation into factual statements' out of 'References' and into 'Tense and claim discipline', where it duplicates existing guidance.

Add one compact worked example (a weak claim sentence rewritten with 'is consistent with / suggests') to make the claim-discipline rules copy-paste applicable.

DimensionReasoningScore

Conciseness

The ~50-line body is tight and assumes Claude's competence (no explanation of what Results/Discussion sections are, no writing tutorial padding), and every section adds skill-specific discipline. Minor trimming is possible: the mechanistic-speculation rule appears in both 'Tense and claim discipline' ("Do not let mechanistic speculation read like fact") and again in 'References' ("Avoid collapsing unsupported mechanistic speculation into factual statements"), and anti-hedging advice is likewise stated twice. This matches 'efficient; minor instances that could be trimmed', not the 3 anchor's 'some unnecessary explanation'.

4 / 5

Actionability

For an instruction-only skill the guidance is concrete: numbered paragraph patterns (question/observation/takeaway; interpretation/support/comparison/limitation), a default-selection rule, and specific hedging vocabulary ("is consistent with", "suggests", "may reflect") that can be applied directly. It stops short of the 5 anchor because there are no worked examples (e.g., a before/after sentence pair or a sample paragraph) covering common cases.

4 / 5

Workflow Clarity

The 5-step Workflow is clearly sequenced (placement decision → observation-first Results → meaning/comparison/uncertainty Discussion → robust-vs-tentative separation → closing scope), with concrete paragraph patterns to execute each step. The destructive/batch validation cap does not apply to a writing task, but self-check/revision checkpoints (e.g., 'verify each observation is anchored to a figure') are only implicit and the revision pass is deferred to a reference file, so it fits 'clear sequence with most checkpoints; minor validation gaps' rather than the 5 anchor's explicit validation steps.

4 / 5

Progressive Disclosure

The body is well-sectioned and its two references are clearly signaled with markdown links and one-line descriptions of what each contains. However, both referenced paths ([../_references/section-patterns-and-story.md] and [../_references/style-and-revision-checks.md]) do not exist — there are no bundle files anywhere in the skill directory — so the promised navigation is broken. Additionally, the 'References' section opens with a misplaced guideline bullet ('Avoid collapsing unsupported mechanistic speculation...') that is a rule, not a reference. This lands at 'some structure but could be better organized' rather than the 4 anchor, whose references must actually resolve.

3 / 5

Total

15

/

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.

A concise, third-person description with a clear 'what' and decent natural keywords, but it lacks any 'when to use' trigger clause and does not enumerate several concrete actions. It reads like a scope statement rather than an invokable capability description.

Suggestions

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

Enumerate concrete actions beyond 'write', such as 'structure result paragraphs around question-observation-takeaway, anchor observations to figures and tables, compare findings with prior work, and flag limitations.'

Include a few natural synonyms users would say (manuscript, paper, findings, figures, tables) to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("Results and Discussion sections") and offers one core action ("Write") plus two qualifying constraints ("separate observations from interpretation", "preserve uncertainty"). These read more as qualities of the output than a list of several concrete capabilities, so it sits at the 'domain and 1-2 concrete actions, not comprehensive' anchor rather than the 'lists several specific actions' anchor.

3 / 5

Completeness

The 'what' is clear (write Results/Discussion sections with separation of observations and interpretation), but there is no 'Use when...' clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Terms like "Results and Discussion sections", "observations", "interpretation", and "uncertainty" are natural phrases a user drafting a paper would say, giving good keyword coverage. It falls short of the 5 anchor because common synonyms such as "manuscript", "paper", "findings", or "figures/tables" are missing.

4 / 5

Distinctiveness Conflict Risk

"Results and Discussion sections" carves out a fairly distinct niche within scientific-writing skills, with the observations-vs-interpretation discipline adding differentiation. Minor overlap risk remains with closely related skills (e.g., general paper-writing or abstract-writing skills), so it fits 'mostly distinct; minor overlap risk' rather than the 'clear niche with minimal conflict' anchor.

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

Path

writing_skills/results-and-discussion-writing/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.