CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hugging-face-paper-publisher

Publish and manage research papers on Hugging Face Hub. Supports creating paper pages, linking papers to models/datasets, claiming authorship, and generating professional markdown-based research articles.

49

Quality

62%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./backend/cli/skills/writing/hugging-face-paper-publisher/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

38%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 well-structured and command-heavy, but roughly half the documented CLI surface (claim, convert, validate, visibility commands) does not exist in the shipped script, the same commands are repeated four times across redundant sections, and the existing quick_reference.md bundle file is never referenced. Verification steps are absent around the mutating and batch operations.

Suggestions

Reconcile the documented commands with scripts/paper_manager.py: either implement claim/check-authorship/list-my-papers/toggle-visibility/convert/validate or remove those sections, and fix the Python example to call link_paper_to_repo().

Collapse 'Commands Reference', 'Integration Examples', and 'Common Patterns' (which repeat the Usage Instructions commands) into a single section, or move them into the existing references/quick_reference.md and link to it.

Add validation checkpoints around mutating and batch workflows (e.g. run check after index, run validate after link) with explicit fix-and-retry guidance, which would also lift the workflow_clarity cap.

DimensionReasoningScore

Conciseness

The ~615-line body repeats the same CLI invocations three to four times across 'Usage Instructions', 'Commands Reference', 'Integration Examples', and 'Common Patterns', and pads capability sections with bullet lists like 'Modern Template Features'. This matches the level-2 anchor 'noticeably verbose; several unnecessary explanations or padded sections' — it goes beyond the 'some unnecessary explanation' of level 3.

2 / 5

Actionability

Guidance is concrete with copy-paste-style commands, but a substantial portion is not actually executable: the documented subcommands 'claim', 'check-authorship', 'list-my-papers', 'toggle-visibility', 'convert', and 'validate' do not exist in scripts/paper_manager.py (only index, check, link, create, info, citation, search are registered), and the Python example calls pm.link_paper() when the actual method is link_paper_to_repo(). This matches level 3 ('some concrete guidance but incomplete... missing key details') rather than 4, where gaps would be minor.

3 / 5

Workflow Clarity

Workflows 1-3 are clearly sequenced with numbered steps, but batch/destructive operations lack validation checkpoints: the batch-link for-loop mutates multiple repo READMEs with no post-check, the link workflow that rewrites YAML frontmatter has no verify step, and the 'validate' command it leans on is not implemented. Per the rubric, batch operations without validation cap workflow clarity at 3.

3 / 5

Progressive Disclosure

The bundle provides references/quick_reference.md (216 lines of command reference) but the body never mentions it — a buried reference. Meanwhile the body inlines its own ~90-line 'Commands Reference', the YAML card examples, template structure, and patterns that clearly belong in that reference file, matching the level-2 anchor 'content that clearly belongs in separate files is inlined; or references are buried'.

2 / 5

Total

10

/

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.

The description is specific, third-person, and covers the skill's concrete capabilities well, but it lacks any 'Use when' trigger guidance and omits key natural trigger terms like 'arXiv' and 'citations'. It reads as a capability list rather than a routing description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when publishing or indexing a research paper on the Hugging Face Hub, linking arXiv papers to models/datasets, or claiming paper authorship.'

Include the natural trigger terms 'arXiv' and 'citations' (and possibly 'Paper Page') so users and Claude can route on the phrases they would actually say.

Tighten 'generating professional markdown-based research articles' to something more distinct, or drop it, to reduce overlap with generic writing/markdown skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'creating paper pages, linking papers to models/datasets, claiming authorship, and generating professional markdown-based research articles' — which comprehensively cover the skill's capabilities in third-person voice, matching the level-5 anchor ('Extract text and tables from PDF files, fill forms, merge documents'). Not 4 because the action list is comprehensive rather than having minor gaps.

5 / 5

Completeness

The 'what' is clear (publish/manage/link/claim/generate), but there is no 'Use when...' or equivalent trigger clause — only 'Publish and manage research papers on Hugging Face Hub.' Per the rubric guideline, a missing explicit trigger clause caps completeness at 3 ('Has a clear what but when is missing or only weakly implied').

3 / 5

Trigger Term Quality

Good natural-keyword coverage: 'research papers', 'Hugging Face Hub', 'paper pages', 'models/datasets', 'authorship', 'markdown-based research articles'. However it omits the most distinctive natural trigger users would say for this skill — 'arXiv' (the primary indexing source) and 'citations' — so it falls short of the level-5 comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The 'Hugging Face Hub' paper-publishing niche is mostly distinct with clear triggers. Minor overlap risk remains with general writing/markdown skills via 'generating professional markdown-based research articles', and with generic Hugging Face model-management skills, so it does not fully reach the clear-niche level-5 anchor.

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 (637 lines); consider splitting into references/ and linking

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

synthetic-sciences/openscience

Path

backend/cli/skills/writing/hugging-face-paper-publisher/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.