CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hugging-face-jobs

Run any workload on fully managed Hugging Face infrastructure. No local setup required—jobs run on cloud CPUs, GPUs, or TPUs and can persist results to the Hugging Face Hub.

Quality

65%

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

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

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.

The body is highly actionable with concrete MCP/CLI/Python examples, tables, and error-recovery guidance, and its workflow is reasonably checkpointed. However, it is badly overlong due to heavy repetition (especially the token guide, which is both inlined and supposedly in a reference file), and its progressive disclosure is undermined by referenced bundle files that are not present in the skill directory.

Suggestions

Cut the inline 'Token Usage Guide' section (~190 lines) down to the essential 'always use secrets={"HF_TOKEN": "$HF_TOKEN"}' rule plus a pointer to references/token_usage.md, and merge the duplicate 'Common Failure Modes' and 'Troubleshooting' sections into references/troubleshooting.md.

Include the references/ and scripts/ files in the skill bundle (references/token_usage.md, hardware_guide.md, hub_saving.md, troubleshooting.md; scripts/generate-responses.py, cot-self-instruct.py, finepdfs-stats.py) so the body's pointers resolve, and use one consistent script path convention.

Fix MCP examples that pass local file paths as the 'script' value (e.g., "your_script.py", "inference.py" in the token, scheduling, and custom-image sections) to use inline script strings or URLs, consistent with the document's own warning.

DimensionReasoningScore

Conciseness

At ~1030 lines the body is noticeably verbose with several padded/redundant sections: token usage is covered four separate times (Prerequisites checklist, a ~190-line inline 'Token Usage Guide' despite references/token_usage.md existing, the Saving Results section, and Key Takeaways); 'Common Failure Modes' and 'Troubleshooting' restate the same fixes; and the secrets snippet is repeated ~8 times. It does not hit level 1 because it rarely explains concepts Claude already knows from scratch — the problem is repetition, not elementary teaching.

2 / 5

Actionability

Mostly executable, copy-paste-ready guidance: concrete hf_jobs() MCP calls with CLI and Python API equivalents, a hardware flavor table, exact timeout formats, and cost worked-examples. Minor gaps keep it from 5: several examples pass local paths as the MCP 'script' value ("your_script.py", "inference.py", "my_script.py") that the document itself warns will fail, and some snippets are placeholders the user must adapt.

4 / 5

Workflow Clarity

A clear sequence is assembled from Key Directives, the Prerequisites Checklist (auth, plan, hf_whoami), and the Verification Checklist before submission, with error-recovery feedback in Token Verification and Common Failure Modes — matching 'clear sequence with most checkpoints present; minor validation gaps'. Validation for the risky parts (token asserts, persistence checks) is present, so the batch-operations cap at 3 does not apply; it falls short of 5 because no single ordered end-to-end workflow (auth → hardware → submit → persist → report URL) is stated and there is no post-submission 'verify job started' step.

4 / 5

Progressive Disclosure

The body clearly signals references ("See references/hardware_guide.md for detailed specifications", "See: references/troubleshooting.md") and organized sections, but the actual bundle contains no references/, scripts/, or assets/ directories — all seven referenced files (4 references, 3 scripts) are dangling. Additionally, ~190 lines of token guidance that belongs in references/token_usage.md are fully inlined, and script paths are inconsistent ("hf-jobs/scripts/..." in Patterns vs "scripts/..." in Resources). This matches 'some structure; content that should be separate is inline' rather than level 4's 'most content appropriately placed'.

3 / 5

Total

13

/

20

Passed

Description

61%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 clearly states what the skill does with a distinctive Hugging Face Jobs niche and decent trigger terms, but it omits any explicit 'when to use' guidance and its action list is generic ('any workload') rather than comprehensive. It sits solidly in the middle of the scale.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to run Python jobs on cloud GPUs/TPUs, run batch inference or training without local hardware, or process datasets at scale on Hugging Face infrastructure.'

Replace the generic 'Run any workload' with 2-3 more specific capability phrases (e.g., 'run batch inference, fine-tune models, process large datasets, schedule recurring jobs') to sharpen specificity and trigger terms.

DimensionReasoningScore

Specificity

The description names the domain ("fully managed Hugging Face infrastructure") and 1-2 concrete actions ("Run any workload", "persist results to the Hugging Face Hub"), matching the 'names domain and 1-2 concrete actions' anchor. It is not comprehensive — the skill also handles scheduling, monitoring, and batch inference, and "any workload" is generic — so it does not reach the 'lists several specific actions' level of 4.

3 / 5

Completeness

The 'what' is clear (run workloads on managed HF infrastructure and persist results), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. The 'when' is only weakly implied by 'No local setup required', not stated.

3 / 5

Trigger Term Quality

Natural phrases a user would say are present: "workload", "jobs", "cloud CPUs, GPUs, or TPUs", "persist results to the Hugging Face Hub", "No local setup required" — good keyword coverage per the level-4 anchor. A few common variations are missing (train/fine-tune, batch inference, run remotely/on a GPU), keeping it below the comprehensive level 5.

4 / 5

Distinctiveness Conflict Risk

"Fully managed Hugging Face infrastructure" plus Hub persistence carves a clear niche that would not fire for generic cloud-execution or document skills, fitting 'mostly distinct; minor overlap risk'. There is minor overlap risk with closely related HF skills (e.g., a model-trainer skill) since 'any workload' includes training, so it is not the minimal-conflict level 5.

4 / 5

Total

14

/

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 (1039 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: 13 missing

Warning

Total

13

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

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