CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scientific-writing

Core skill for the deep research and writing tool. Write scientific manuscripts in full paragraphs (never bullet points). Use two-stage process with (1) section outlines with key points using research-lookup then (2) convert to flowing prose. IMRAD structure, citations (APA/AMA/Vancouver), figures/tables, reporting guidelines (CONSORT/STROBE/PRISMA), for research papers and journal submissions.

Quality

69%

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/scientific-writing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 well-structured, comprehensive skill with a genuinely distinctive core (the two-stage outline-to-prose process and LaTeX report tooling are concrete and actionable). Its weaknesses are verbosity — long sections restating knowledge Claude already has and duplicating bundled reference files — and imperfect progressive disclosure, including bash commands pointing to scripts absent from the bundle.

Suggestions

Move Section 10 (field-specific terminology) into a new references/field_terminology.md and keep only a 2-3 line pointer, cutting ~90 lines of generally-known material.

Slim Section 8 to a short usage example plus pointers to assets/REPORT_FORMATTING_GUIDE.md and references/professional_report_formatting.md, removing the duplicated command tables and box-environment code.

Fix or remove the invocations of scripts/generate_schematic.py and scripts/generate_image.py, which do not exist in this bundle — either bundle the scripts or point to the external scientific-schematics/generate-image skills with their real locations.

DimensionReasoningScore

Conciseness

The ~690-line body contains several sections explaining knowledge Claude already has: Section 10 spends ~90 lines on field-specific terminology Claude knows well (gene nomenclature italics, IUPAC names, SI units, binomial nomenclature, person-first language), Sections 2 and 6 restate generic writing principles (past tense for methods, define abbreviations, avoid jargon), and Section 8 duplicates the LaTeX command/box-environment reference that already lives in assets/REPORT_FORMATTING_GUIDE.md and assets/scientific_report_template.tex. This is 'noticeably verbose; several unnecessary explanations or padded sections' (anchor 2); it is below anchor 3 because the padding is extensive and structural, not occasional.

2 / 5

Actionability

Mostly concrete and executable: the two-stage outline-to-prose process includes a worked example pair (outline then expanded prose), Section 8 provides copy-paste-ready LaTeX (box environments, table with \meansd/\sigthree commands, \makereporttitle skeleton, xelatex compile command), and the workflow gives sequenced steps. The gap keeping it from anchor 5: the bash commands invoke 'scripts/generate_schematic.py' and 'scripts/generate_image.py', which do not exist in this skill's bundle (no scripts/ directory), and core guidance defers to external skills (research-lookup, venue-templates) whose availability is unverifiable — minor but real executability gaps.

4 / 5

Workflow Clarity

The 'Workflow for Manuscript Development' gives a clear four-stage sequence (Planning → Drafting → Revision → Final Preparation), the two-stage writing process is well-sequenced with numbered steps, and Stage 3 embeds verification checkpoints ('Verify all citations are accurate', 'Confirm adherence to reporting guidelines', 'Check word counts'). This matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') — the revision checks exist but are listed as prose rather than explicit validate-then-proceed gates, which keeps it below anchor 5's feedback loops. No destructive/batch operation cap applies since this is a writing task.

4 / 5

Progressive Disclosure

Structure is real and one level deep — each capability section signals its reference file ('For detailed guidance, refer to references/imrad_structure.md', etc.) and all six references/ plus three assets/ files exist and match the body's citations. But significant content that clearly belongs in those separate files is inlined anyway: Section 10 (field-specific terminology) has no reference file at all, and Section 8's full command tables and box-environment code duplicate assets/REPORT_FORMATTING_GUIDE.md. The body also cites 'scripts/generate_schematic.py' paths that don't exist in the bundle, a broken navigation pointer. This lands on anchor 3 ('content that should be separate is inline') rather than anchor 4, whose 'minor organization gaps' undersell the duplication and dangling script paths.

3 / 5

Total

13

/

20

Passed

Description

71%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 specific, domain-anchored description that clearly states what the skill does, with strong concrete capability enumeration and good natural keyword coverage. Its main weaknesses are the absence of an explicit 'Use when...' trigger clause (capping completeness at 3) and a slightly vague self-referential opener that dilutes distinctiveness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when writing or revising any section of a research paper, manuscript, abstract, or journal submission.'

Include natural trigger synonyms users actually say — 'paper', 'draft', 'revise my manuscript', 'abstract', 'respond to reviewer comments' — to broaden keyword coverage.

Replace the vague opener 'Core skill for the deep research and writing tool' with a concrete capability statement to sharpen distinctiveness.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific capabilities: 'Write scientific manuscripts in full paragraphs (never bullet points)', 'two-stage process with (1) section outlines... then (2) convert to flowing prose', 'IMRAD structure, citations (APA/AMA/Vancouver), figures/tables, reporting guidelines (CONSORT/STROBE/PRISMA)'. Named standards and an explicit process give comprehensive, concrete coverage; it is not merely 'names the domain' (4) nor missing items (4's gap), so anchor 5 fits best. The only minor softness is the context-setting opener 'Core skill for the deep research and writing tool', which is not itself an action but does not reduce the concrete action coverage below the top anchor.

5 / 5

Completeness

The 'what' is clearly stated (write manuscripts in prose via a two-stage process with IMRAD, citations, figures, reporting guidelines), but there is no 'Use when...' clause or equivalent explicit trigger guidance — only the trailing fragment 'for research papers and journal submissions', which delimits scope but does not tell Claude when to invoke the skill. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3: the 'when' is weakly implied rather than explicit, fitting anchor 3 ('what' clear, 'when' missing or only weakly implied) better than anchor 4's explicit 'Use when working with PDF files' pattern.

3 / 5

Trigger Term Quality

Natural user phrases are present: 'research papers', 'journal submissions', 'scientific manuscripts', 'citations', 'figures/tables'. However, common variations users would actually say are missing: 'paper', 'draft', 'revise my manuscript', 'abstract', 'thesis', 'respond to reviewers'. Coverage is good with a few natural terms missing, which matches anchor 4 rather than anchor 5's 'comprehensive coverage of natural terms including synonyms'.

4 / 5

Distinctiveness Conflict Risk

Highly specific domain markers (IMRAD, CONSORT/STROBE/PRISMA, APA/AMA/Vancouver, journal submissions) create a clear niche with minimal conflict risk against unrelated skills. Minor overlap remains with general writing/venue-templates skills, and the generic opener 'Core skill for the deep research and writing tool' plus the reference to the external 'research-lookup' skill slightly blur boundaries — matching anchor 4 ('mostly distinct; minor overlap risk with closely related skills') rather than anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (696 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

13

/

16

Passed

Repository

fernandezbaptiste/CatMaster

Path

writing_skills/scientific-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.