CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hugging-face-datasets

Create and manage datasets on Hugging Face Hub. Supports initializing repos, defining configs/system prompts, streaming row updates, and SQL-based dataset querying/transformation. Designed to work alongside HF MCP server for comprehensive dataset workflows.

57

Quality

72%

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/data-engineering/hugging-face-datasets/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 highly actionable, well-sectioned body whose commands and APIs check out against the real scripts, weakened by significant command duplication across sections and a monolithic structure that inlines reference-grade material. The three commands referencing examples/*.json are broken as shipped since those files are missing from the bundle.

Suggestions

Deduplicate the body: remove the '# Version'/'# Dependencies' sections (frontmatter already carries them), merge 'Recommended Workflow' with 'Commands Reference' (init/config/quick_setup are shown twice), and fold 'Core Capabilities' bullets into the actual sections — this should cut the body roughly in half.

Move the DuckDB SQL function reference, the five template JSON schemas, and the Python API walkthrough into reference files (e.g. references/sql-functions.md, references/templates.md) and link them one level deep.

Ship the referenced examples/training_examples.json and examples/diverse_training_examples.json in an examples/ directory, or remove the three commands that depend on them so no documented command fails as written.

DimensionReasoningScore

Conciseness

The body is dense and operational — it teaches no concepts Claude already knows — but a 570-line body carries real duplication: '# Version' / '# Dependencies' sections restate the frontmatter, 'Core Capabilities' bullets restate the later sections, init/config/quick_setup commands appear nearly verbatim in both 'Recommended Workflow' and 'Commands Reference', and SQL examples repeat between Quick Start and Common Operations. This lands on 'mostly efficient but could be tightened' rather than score 2, since the padding is redundant-but-accurate commands rather than concept explanations.

3 / 5

Actionability

Nearly all guidance is copy-paste ready and verifiable against the actual bundle — the documented uv run commands, CLI subcommands (query/describe/sample/count/histogram/unique/transform/export/raw), and the Python API (HFDatasetSQL.query/describe/sample/count/histogram/filter_and_transform/push_to_hub/export_to_parquet) all exist in scripts/sql_manager.py and scripts/dataset_manager.py. The gap from score 5: three commands depend on examples/training_examples.json and examples/diverse_training_examples.json, which are not present in the bundle, so those commands fail as written.

4 / 5

Workflow Clarity

The recommended workflow is clearly sequenced (Discovery via MCP → Creation → Content Management), combined-workflow examples are numbered, and there are genuine checkpoints: an 'Error Handling' section, a note that 'add_rows and quick_setup return a nonzero exit status if validation or an upload fails, so automation should check their exit status', and JSON validation on upload. It falls short of score 5 because no explicit validate → fix → retry feedback loop is spelled out for the batch add_rows/push operations.

4 / 5

Progressive Disclosure

Section headers are clear and the two scripts are appropriately externalized, but bulky reference material — the DuckDB SQL function reference, five JSON template schemas, the HF path format spec, and the Python API walkthrough — is inlined in one 570-line body where a leaner SKILL.md would point to reference files. Additionally, references to examples/*.json files are dangling (the files do not exist in the bundle), which is a navigation defect. Scored against the actual bundle structure, this is 'some structure but content that should be separate is inline' with imperfectly reliable references.

3 / 5

Total

14

/

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.

A specific, well-scoped description with concrete capability verbs, but it never tells Claude when to use it — no trigger guidance at all — which is its most consequential weakness. Keywords are good but could include more natural variations (HF, huggingface, push/upload datasets, DuckDB).

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user wants to create, populate, query, or transform datasets on the Hugging Face Hub, mentions HF/huggingface datasets, or asks to push training data to the Hub.'

Add natural synonym keywords users actually say — 'HF', 'huggingface', 'upload/push datasets', 'training data', 'DuckDB' — to broaden trigger coverage.

Drop the vague tail 'for comprehensive dataset workflows', which adds no information and reads as over-claim padding.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'initializing repos, defining configs/system prompts, streaming row updates, and SQL-based dataset querying/transformation' — comprehensively covering both bundled scripts with no vague filler. This matches the anchor for multiple specific concrete actions with comprehensive coverage rather than the score-4 anchor, which requires minor gaps in coverage.

5 / 5

Completeness

The 'what' is clearly and concretely answered, but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'Designed to work alongside HF MCP server for comprehensive dataset workflows' describes an architectural relationship, not when to invoke the skill. Per the judging guideline, a missing 'Use when' clause caps completeness at 3; score 4 would require an explicit, if imperfect, 'when'.

3 / 5

Trigger Term Quality

Good natural keyword coverage: 'Hugging Face Hub', 'datasets', 'SQL', 'system prompts', 'streaming row updates' are phrases users would actually say. It falls short of the score-5 anchor because common variations are missing — e.g. 'HF', 'huggingface', 'upload/push datasets', 'training data', 'DuckDB'.

4 / 5

Distinctiveness Conflict Risk

'Hugging Face Hub' dataset management plus SQL querying is a clear niche, and the explicit division of labor with the HF MCP server further disambiguates triggers. Minor overlap risk remains with generic data-processing/SQL-analysis skills for the querying half, so it sits at 'mostly distinct' rather than the score-5 'clear niche with distinct triggers'.

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 (571 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/data-engineering/hugging-face-datasets/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.