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.

Quality

60%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/hugging-face-paper-publisher/SKILL.md

The canonical home for this skill is hugging-face-paper-publisher in administrakt0r/AI-Agents-Safe-Coding-Skills

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 rich with concrete, copy-paste-ready commands and clearly numbered workflows, but it is severely bloated by triple duplication of the same commands, and it references a scripts/ directory that does not exist in the bundle, leaving every command unexecutable. Restructuring into an overview plus reference files, and shipping the actual script, would address its two weakest dimensions.

Suggestions

Ship the actual scripts/paper_manager.py (or remove the commands) — the body's central usage instructions all invoke a file that is not in the bundle, making the skill unusable as provided.

Delete the 'Commands Reference' and 'Common Patterns' sections: they restate the exact commands and workflows already shown in Methods 1–5 and Integration Examples, cutting the file roughly in half.

Move the paper templates, YAML model/dataset card examples, and Troubleshooting section into references/ files (e.g. references/templates.md, references/yaml-cards.md) and keep SKILL.md as a concise overview with one-level-deep, clearly signaled links.

DimensionReasoningScore

Conciseness

The 620-line body duplicates the same commands three times — Methods 1–5, then 'Commands Reference' (restating every command verbatim), then 'Common Patterns' (restating the workflows again) — plus padded sections like 'Future Enhancements', 'Integration with tfrere's Research Template', and 'Modern Template Features' that earn no tokens. It is not a 1 because most content is skill-specific commands and metadata rather than explanations of concepts Claude already knows, but the pervasive repetition is well beyond the 'some unnecessary explanation' of a 3.

2 / 5

Actionability

Commands are concrete and well-formed (e.g. 'uv run scripts/paper_manager.py link --repo-id "username/model-name" --repo-type "model" --arxiv-id "2301.12345"') with complete YAML card examples. However, the referenced 'scripts/paper_manager.py' does not exist — the bundle has no scripts/, references/, or assets/ directories — so every command is unexecutable as shipped and the 'from scripts.paper_manager import PaperManager' example is unverifiable, which is a key missing detail rather than a minor gap.

3 / 5

Workflow Clarity

Workflows 1–3 are clearly numbered and sequenced, and Error Handling / Troubleshooting sections exist, which puts this above a 2. But the batch-link loop in 'Advanced Usage' and the README-modifying link workflows include no validation or verification step in their sequences, so the rubric's cap for batch/destructive operations without validation applies.

3 / 5

Progressive Disclosure

This is a monolithic 620-line SKILL.md with substantial content inlined that clearly belongs in separate files — full paper templates, YAML card examples, the command reference, and troubleshooting. No references/ files exist, and the scripts/ directory the body repeatedly points to is absent from the bundle entirely. Section headers exist so it is above a 1, but there is no file-level disclosure at all.

2 / 5

Total

10

/

20

Passed

Description

66%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 solid, third-person description with concrete, well-chosen capability statements and good natural keywords. Its main weaknesses are the complete absence of a 'Use when...' trigger clause (capping completeness at 3) and the omission of 'arXiv', the term at the heart of every workflow in the skill body.

Suggestions

Append an explicit trigger clause, e.g. 'Use when publishing an arXiv paper to Hugging Face, linking papers to model or dataset cards, claiming paper authorship, or generating a markdown research article.'

Include 'arXiv' as a keyword — every command in the body is keyed on an arXiv ID, so a user asking about arXiv-to-Hub publishing should surface this skill.

Trim 'Publish and manage' to the capabilities the bundle actually ships (the referenced scripts/ directory does not exist) or add a mention of visibility/search only if those commands are real.

DimensionReasoningScore

Specificity

The description lists four concrete actions — 'creating paper pages, linking papers to models/datasets, claiming authorship, and generating professional markdown-based research articles' — which matches the anchor for several specific actions with minor gaps. It is not a 5 because the body covers additional capabilities (arXiv indexing, paper search, visibility management, HTML conversion) that the description omits.

4 / 5

Completeness

It clearly answers 'what' ('Publish and manage research papers on Hugging Face Hub. Supports creating paper pages...') but contains no 'when' — no 'Use when...' clause or equivalent trigger guidance, which caps this dimension at 3 per the rubric guidelines. It is above 2 because the 'what' is concrete and multi-part, not vague.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'research papers', 'Hugging Face Hub', 'paper pages', 'models/datasets', 'claiming authorship', 'research articles' are phrases users would naturally say. It falls short of a 5 because 'arXiv' — the central identifier in every workflow in the body — is absent, along with common variations like 'HF', 'cite', or 'model card'.

4 / 5

Distinctiveness Conflict Risk

'Publish and manage research papers on Hugging Face Hub' plus 'claiming authorship' carves a clear niche with low conflict risk. It is not a 5 because 'generating professional markdown-based research articles' overlaps with generic academic-writing/markdown skills and 'manage research papers' is broad enough to brush against general HF Hub management skills.

4 / 5

Total

15

/

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

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 45 missing

Warning

Total

13

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/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.