← Explore all skills

DATA AND RESEARCH / Hugging Face

Hugging Face Dataset Workflows

Discovers a Hub dataset's subsets, splits, rows and parquet shards, while separating read-only exploration from optional repository creation and uploads.

“Use this skill for Hugging Face Dataset Viewer API workflows that fetch subset/split metadata, paginate rows, search text, apply filters, download parquet URLs, and read size or statistics.”

01 / THE REASONING

Why this made the selection.

  • Requires resolving config and split before row work, making the sampling population explicit.
  • Separates metadata and parquet discovery from bulk downloads; callers can hand off exact shard URLs and query parameters rather than an unexplained sample.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/huggingface-datasets/SKILL.md, including upload and raw-trace sections
  • skills/hf-cli/SKILL.md: setup, authentication, datasets, download/upload and repository commands (supporting instructions, not CLI implementation)
  • README.md installation and marketplace scope
  • LICENSE
  • Pinned Skills installer README source-format sections; current Dataset Viewer pagination documentation through Context7

Our findings

  • Read inputs are dataset namespace/repo, config, split, offset/length and optional URL-encoded query/where/orderby parameters. Outputs are metadata, row windows, parquet URLs, sizes/statistics and optional Croissant metadata from datasets-server.huggingface.co.
  • The original SKILL.md's upload examples use npx @huggingface/hub or hf and may create repositories. Private/gated reads use a bearer HF token; no token was read or supplied during this review.
  • hf-cli documents parquet URL discovery and DuckDB SQL as a separate handoff. Its own generated command list is version-specific and includes write operations; installing the dataset instructions does not install or constrain those CLIs.
  • Useful workflow output should distinguish a preview from a complete extract and retain config/split, selection predicates, source licence and fetch identity. The original install receipt and artifact:null are unchanged.

Not established by this review

  • No Dataset Viewer data request, Hub account call, dataset download, CLI installation or upload was performed.
  • No dataset quality/licence audit, token-scope verification, pagination completeness test or CLI dependency audit; source retrieval is not a dataset runtime test.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add huggingface/skills/skills/huggingface-datasets

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/huggingface/skills/tree/c3ff942be3e07116b475253f0a8fc4f54682c1a8/skills/huggingface-datasets
  1. Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
  2. Choose your AI tools and project or global scope in the installer, then review its permissions before using the skill.

Before you start

  • Node.js/npm for this installer
  • An agent that supports the Agent Skills format
  • Network access
  • HF token and repository permissions for private data or uploads

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. Pinned dataset workflow ↗Checked

    https://github.com/huggingface/skills/blob/c3ff942be3e07116b475253f0a8fc4f54682c1a8/skills/huggingface-datasets/SKILL.md

    Supports: summary, upstreamDescription, whySelected, bestFor, review, limitations, access

  2. https://github.com/huggingface/skills/blob/c3ff942be3e07116b475253f0a8fc4f54682c1a8/skills/hf-cli/SKILL.md

    Supports: review, limitations, compatibility

  3. https://github.com/huggingface/skills/blob/c3ff942be3e07116b475253f0a8fc4f54682c1a8/README.md

    Supports: install, compatibility

  4. https://github.com/huggingface/skills/blob/c3ff942be3e07116b475253f0a8fc4f54682c1a8/LICENSE

    Supports: license

  5. https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md

    Supports: install

  6. https://github.com/huggingface/dataset-viewer/blob/main/docs/source/quick_start.md

    Supports: review, limitations

  7. https://github.com/huggingface/dataset-viewer/blob/main/docs/source/filter.md

    Supports: limitations

Evidence & Ask