Antigravity Skills - Build and Discover AI Agent SkillsAntigravity Skills

Hugging Face Dataset Viewer Skill · Data Ai

Explore Hugging Face Datasets with AI Precision

Query and filter Hugging Face datasets with 9 specialized endpoints.

Paginate up to 100 rows per request and get parquet links instantly. Try it now.

  • Hugging Face
  • Dataset API
  • Machine Learning
  • Data Science
  • Parquet

About This Skill

This skill provides 9 core endpoints to interact with the Hugging Face Dataset Viewer API. It allows developers to validate datasets, list splits, and paginate through rows with a maximum length of 100 items per call.

Quick Start

  1. 1Configure your HF_TOKEN for private datasets.
  2. 2Use /is-valid to check dataset availability.
  3. 3Fetch splits and paginate rows using the /rows endpoint.
Example Command
/rows?dataset=glue&config=mrpc&split=train&offset=0&length=10

Core Capabilities

Dataset Search and Filtering

Execute text matching with /search and complex predicates using /filter to find specific data points within any dataset split.

Pagination and Preview

Retrieve first rows or paginate through large datasets using offset and length parameters with a maximum limit of 100 rows.

Metadata and Statistics

Access dataset size totals and detailed column statistics via /size and /statistics endpoints for deep data analysis.

Parquet and Split Resolution

Resolve dataset configurations and splits, and retrieve direct parquet shard links for downstream processing and external tool integration.

Usage Examples

Input

Check if 'tatsu-lab/alpaca' is valid.

Output

Dataset is valid and accessible via the API.

Before

Manually downloading a multi-GB dataset to see the schema and content.

After

Instant JSON preview of the first 5 rows via a single API call.

Input

Search for 'sentiment' in the dataset.

Output

Found 12 matches for 'sentiment' in the specified split.

SKILL.md

---
source: "https://github.com/huggingface/skills/tree/main/skills/huggingface-datasets"
name: hugging-face-dataset-viewer
description: Query Hugging Face datasets through the Dataset Viewer API for splits, rows, search, filters, and parquet links.
risk: unknown
---

# Hugging Face Dataset Viewer

## When to Use
Use this skill when you need read-only exploration of a Hugging Face dataset through the Dataset Viewer API.

Use this skill to execute read-only Dataset Viewer API calls for dataset exploration and extraction.

## Core workflow

1. Optionally validate dataset availability with `/is-valid`.
2. Resolve `config` + `split` with `/splits`.
3. Preview with `/first-rows`.
4. Paginate content with `/rows` using `offset` and `length` (max 100).
5. Use `/search` for text matching and `/filter` for row predicates.
6. Retrieve parquet links via `/parquet` and totals/metadata via `/size` and `/statistics`.

## Defaults

- Base URL: `https://datasets-server.huggingface.co`
- Default API method: `GET`
- Query params should be URL-encoded.
- `offset` is 0-based.
- `length` max is usually `100` for row-like endpoints.
- Gated/private datasets require `Authorization: Bearer <HF_TOKEN>`.

## Dataset Viewer

- `Validate dataset`: `/is-valid?dataset=<namespace/repo>`
- `List subsets and splits`: `/splits?dataset=<namespace/repo>`
- `Preview first rows`: `/first-rows?dataset=<namespace/repo>&config=<config>&split=<split>`
- `Paginate rows`: `/rows?dataset=<namespace/repo>&config=<config>&split=<split>&offset=<int>&length=<int>`
- `Search text`: `/search?dataset=<namespace/repo>&config=<config>&split=<split>&query=<text>&offset=<int>&length=<int>`
- `Filter with predicates`: `/filter?dataset=<namespace/repo>&config=<config>&split=<split>&where=<predicate>&orderby=<sort>&offset=<int>&length=<int>`
- `List parquet shards`: `/parquet?dataset=<namespace/repo>`
- `Get size totals`: `/size?dataset=<namespace/repo>`
- `Get column statistics`: `/statistics?dataset=<namespace/repo>&confi

Frequently Asked Questions

FAQ

Is this skill compatible with private Hugging Face datasets?
Yes, it supports gated and private datasets provided you include a valid HF_TOKEN in the Authorization header.
Who is the target audience for this skill?
It is designed for Developers and Data Scientists who need to explore or extract data from Hugging Face programmatically without full downloads.
How does this differ from the standard Hugging Face Python library?
This skill uses the Dataset Viewer API, allowing for lightweight exploration and filtering without downloading the entire dataset to disk.
Does it support non-English datasets?
Yes, it supports any dataset hosted on Hugging Face, provided the Dataset Viewer API is enabled for that specific repository.
What results can I expect when querying rows?
You will receive a JSON response containing the requested rows, with a maximum limit of 100 rows per individual request.

Discussion

Discussion

0 comments
U

On This Page

Trigger Phrases

Use these phrases to activate this skill in your AI coding assistant:

list splits for datasetpreview hugging face rowssearch dataset contentget parquet linkscheck dataset validity