CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ml-paper-writing

Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, conducting literature reviews, finding related work, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, citation verification workflows, and paper discovery/evaluation criteria.

63

Quality

79%

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

Quality

Content

62%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 delivers genuinely actionable, well-sequenced workflows with strong validation checkpoints, but it pays for that in token efficiency: citation and proactivity guidance each appear three times, expert writing principles are inlined at length despite a dedicated writing-guide.md reference, and the frequently-referenced templates/ directory is missing from the bundle. Structure and execution guidance are strong; compression and bundle integrity are the weak points.

Suggestions

Collapse the three citation-rule sections ("Never Hallucinate Citations", "Citation Workflow", "Workflow 2") into the single canonical citation-workflow section, keeping one short rule statement plus a pointer to references/citation-workflow.md.

Merge "Core Philosophy: Collaborative Writing" and "Balancing Proactivity and Collaboration" into one section, and replace the inlined Gopen & Swan / micro-tips tables with brief pointers to references/writing-guide.md.

Either add the templates/ directory to the bundle or fix the body's template commands and links (e.g. "cp -r templates/neurips2025/", templates/README.md) to point at paths that exist.

DimensionReasoningScore

Conciseness

The ~1,100-line body restates the same material multiple times: citation rules appear in three places ("Never Hallucinate Citations", "Citation Workflow (Hallucination Prevention)", and "Workflow 2"), and the proactive-drafting philosophy is fully duplicated between "Core Philosophy: Collaborative Writing" and "Balancing Proactivity and Collaboration". Tables of writing principles Claude already knows (Gopen & Swan, filler-word lists, reviewer-behavior tables) are inlined at length. Fits the score-2 anchor (noticeably verbose, several padded/duplicated sections); not a 3 because the duplication and padding are systematic, not incidental.

2 / 5

Actionability

Concrete, executable guidance dominates: real bash commands ("cp -r templates/neurips2025/", "latexmk -pdf main.tex"), arXiv URL patterns, LaTeX/table code, the Exa MCP install command, and per-conference requirement tables. Not a 5 because some steps are described rather than given, e.g. "Search with Semantic Scholar" with no executable API call inline (deferred to citation-workflow.md), and one command targets a templates/ directory that does not exist in the bundle.

4 / 5

Workflow Clarity

Workflows 0–5 are numbered checklists with explicit validation checkpoints and failure branches: "Verify template compiles as-is (before any changes)", "If the unmodified template doesn't compile, fix that first", "If any step fails -> mark as placeholder and report it explicitly", plus a defined "Default operating order" for entering the skill. Matches the score-5 anchor (explicit validation, error-recovery loops, checklists); not a 4 because both verification steps and failure paths are systematically present.

5 / 5

Progressive Disclosure

References exist and are mostly well signaled (reference-documents table, "Reference Files" and "LaTeX Templates" sections), but the body repeatedly points to a "templates/" directory ("cp -r templates/neurips2025/", "See [templates/README.md](templates/README.md)") that is absent from the bundle, so those commands fail. Deep-dive content that already lives in references/writing-guide.md is substantially duplicated inline in the 1,100-line body. Fits the score-3 anchor (structure present, but content that should be separate is inline and navigation partially broken); not a 4 because dangling paths and body/reference duplication are more than minor gaps.

3 / 5

Total

14

/

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 frontmatter description: third-person, specific, and compact, with an explicit "Use when..." clause covering the main task entry points. Its only weakness is missing a handful of natural synonyms (bibliography, BibTeX, rebuttal, resubmission) that would broaden trigger coverage.

Suggestions

Add a few natural synonyms users say to broaden triggering, e.g. "building bibliographies or fetching BibTeX" and "writing rebuttals or converting a paper between conference formats".

Mention resubmission/format conversion explicitly in the description since it is a full workflow in the body but absent from the when-clause.

DimensionReasoningScore

Specificity

Multiple concrete actions are listed — "Write publication-ready ML/AI papers", "drafting papers from research repos", "conducting literature reviews", "finding related work", "verifying citations", "preparing camera-ready submissions" — with a named venue list (NeurIPS, ICML, ICLR, ACL, AAAI, COLM) and concrete bundle contents (LaTeX templates, citation verification workflows, evaluation criteria). Not a 4 because coverage spans the full task lifecycle with no significant gaps.

5 / 5

Completeness

Explicitly answers both questions: the "what" ("Write publication-ready ML/AI papers... Includes LaTeX templates, citation verification workflows, and paper discovery/evaluation criteria") and the "when" ("Use when drafting papers from research repos, conducting literature reviews, finding related work, verifying citations, or preparing camera-ready submissions"). Matches the score-5 anchor with concrete trigger phrases; not a 4 because the "when" clause is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Natural user phrasing is well covered ("paper", "literature review", "related work", "citations", "camera-ready", venue names users would actually say), but common synonyms like "bibliography", "BibTeX", "rebuttal", or "format conversion" are absent. Not a 5 because a few natural trigger phrases users would say are missing; clearly above a 3 since the included terms are ones users genuinely utter.

4 / 5

Distinctiveness Conflict Risk

Clear niche — publication-ready ML conference paper writing — with venue-specific triggers that no generic writing or document skill would claim. Minimal overlap risk; matches the score-5 anchor (clear niche, distinct triggers).

5 / 5

Total

19

/

20

Passed

Validation

75%

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

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 missing, 2 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 7 deeper-than-1-level

Warning

Total

12

/

16

Passed

Repository

Galaxy-Dawn/claude-scholar

Path

skills/ml-paper-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.