Skip to content
Get packs

Hugging Face API Tool Builder

Builds reusable scripts that fetch, enrich and process Hugging Face Hub data via its API.

Source Download skill
Repository
huggingface/skills
Stars
11,253
Licence
Apache-2.0
Files
7 files

What it does

When installed, the agent can write small command-line scripts that pull information from the Hugging Face Hub (models, datasets, papers, model cards) and chain those calls together, such as listing trending models and then looking up their metadata. The skill includes example scripts the agent can follow and reuse, and it tells the agent to send your HF_TOKEN as an authorization header for higher rate limits and access to gated content.

Great for

  • Developers who repeatedly need the same Hugging Face data in a script or pipeline
  • Data analysts who want model metadata (licenses, downloads, tags) as filterable JSON
  • Researchers looking for models linked to specific arXiv papers

Skip it if

  • Users who only want a one-off answer about a model and do not need a script (the skill is oriented to reusable tools)
  • Anyone who would run agent-generated scripts on sensitive machines without reviewing them first, since the agent writes and executes code and may hold a token

Try asking

  • “Write a script that lists the 50 most-downloaded text-generation models and outputs id, downloads and license as JSON”
  • “Build a reusable tool that takes model IDs from stdin and returns NDJSON metadata for each”
  • “Create a command that finds models associated with a given arXiv paper ID”
Step-by-step guide: how to use Hugging Face API Tool BuilderInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 7 original files, the Apache-2.0 licence and an attribution note.

    huggingface-tool-builder.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip huggingface-tool-builder.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip huggingface-tool-builder.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Review any generated script before running it, especially if you set HF_TOKEN, and use a token with read-only scope
  • Ask for a specific output (for example, JSON fields or a row limit) so the agent designs a focused, composable script
  • Start with small limits when testing so you see the data shape before scaling up

What's inside

  • references/baseline_hf_api.py
  • references/baseline_hf_api.sh
  • references/find_models_by_paper.sh
  • references/hf_enrich_models.sh
  • references/hf_model_card_frontmatter.sh
  • references/hf_model_papers_auth.sh
  • SKILL.md

Redistributed unmodified from huggingface/skills under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.