CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scientific-writing

Drafts, revises, and audits scientific manuscripts or reports with explicit evidence provenance, reporting-guideline coverage, authorship accountability, confidentiality controls, and local consistency checks. Use for manuscript sections, references, declarations, tables, figures, or submission preparation when scientific accuracy and traceability matter.

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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-engineered, highly actionable skill body: a 12-step workflow with embedded validation commands, feedback loops, and fail-closed human gates, backed by a real bundle whose files all exist. Minor deductions for unsignaled reference files, time-sensitive dates outside a deprecation section, and the promotional citation tail.

DimensionReasoningScore

Conciseness

The body is dense and free of padding — no explanations of concepts Claude already knows, and lists are tight — but there are minor trimming targets: time-sensitive dates outside any 'old patterns/deprecated' section ("rechecked on 2026-10-01", "21 July 2026", "January 2026"), and a tail self-citation section that is not core instruction. Not 5: those few tokens don't earn their place; not 3: nothing rises to 'unnecessary explanation', only minor trims.

4 / 5

Actionability

Every workflow step ships copy-paste-ready commands with full arguments (e.g. `python3 scripts/scaffold_manuscript.py --output-dir ./draft-workspace --document-id local-draft --study-design randomized_trial --guideline consort-2025`, plus seven other fully-specified script invocations), a concrete ID scheme (E/C/N/M/O/R), and an exact inline claim marker format. Fully executable with the common cases covered.

5 / 5

Workflow Clarity

A clearly sequenced 12-step workflow with explicit validation checkpoints at steps 6, 7, 8, 11, and 12, feedback loops ("Resolve every mismatch manually", "re-run every affected audit", fix-and-re-validate), and human approval gates for every consequential action. The revision section adds a 7-step per-change loop. This matches the anchor 5 pattern of validate → fix → retry with checklists.

5 / 5

Progressive Disclosure

Good structure: the body is an overview with one-level-deep references that all exist on disk, each contextually signaled ("See references/evidence_workflow.md") and enumerated in a Bundled files section. Not 5: two reference files (`references/source_ledger.md`, `references/citation_styles.md`) appear only in the file listing with no contextual pointer from the workflow steps where they'd be relevant, so navigation into them is not well-signaled.

4 / 5

Total

18

/

20

Passed

Description

92%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 strong description in third-person voice that states concrete capabilities and an explicit, well-scoped 'Use for...' trigger clause. The only weakness is that a few natural synonyms (papers, journal articles, peer review) are absent, keeping trigger coverage from being exhaustive.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ("Drafts, revises, and audits scientific manuscripts or reports") plus five named capability areas ("explicit evidence provenance, reporting-guideline coverage, authorship accountability, confidentiality controls, and local consistency checks") — comprehensive and specific, matching the anchor 5 example's breadth. Not 4: the coverage of actions and capability areas exceeds the 'several specific actions; minor gaps' anchor with no meaningful gap.

5 / 5

Completeness

Explicitly answers both questions: 'what' is "Drafts, revises, and audits scientific manuscripts or reports with explicit evidence provenance..." and 'when' is a concrete "Use for manuscript sections, references, declarations, tables, figures, or submission preparation when scientific accuracy and traceability matter" clause. This mirrors the anchor 5 exemplar structure exactly.

5 / 5

Trigger Term Quality

Good natural-term coverage: "manuscript sections, references, declarations, tables, figures, or submission preparation when scientific accuracy and traceability matter" — phrases users would naturally say. Not 5: common synonyms like "papers", "journal articles", or "peer review" are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

A clear niche — scientific manuscript production with evidence provenance, authorship accountability, and submission preparation — with triggers distinct from general writing, document, or dataviz skills. Not 4: generic words like "tables" and "figures" are qualified by the manuscript/submission framing and the "scientific accuracy and traceability" condition, leaving minimal overlap risk.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

K-Dense-AI/scientific-agent-skills

Path

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.