Dev & Engineering

Hugging Face Hub CLI Skill

Give agents command-line control over Hugging Face Hub models, datasets, Spaces, jobs, and infrastructure.

42/ 100
Not recommended

Current benefit does not outweigh risk or uncertainty.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 11k
Last updated
18d ago
License
Apache-2.0
hugging-facehub-climodel-managementdataset-management
+2spacesmachine-learning-infrastructure

What does this skill do, and when should you use it?

This skill provides operating guidance for the Hugging Face Hub CLI, `hf`, covering authentication, caching, repositories, models, datasets, Spaces, Buckets, papers, jobs, and inference endpoints. It fits users who need agents to perform Hugging Face Hub administration and machine-learning infrastructure tasks from a shell. It also covers discussions, pull requests, collections, webhooks, extensions, and sandboxes. It is one skill in the huggingface/skills monorepo and does not represent the specialized workflows of sibling skills.

Installs and uses the hf CLI; logs in, switches, and manages access tokens; downloads and uploads model, dataset, and Space files; creates, duplicates, moves, deletes, and configures Hub repositories; manages Buckets, caches, collections, discussions, and pull requests; browses models, datasets, Spaces, and papers; runs SQL queries against dataset Parquet URLs; runs, schedules, inspects, and cancels Hugging Face Jobs; creates and manages sandboxes, Spaces, webhooks, and Inference Endpoints; and produces table, JSON, agent, or quiet output.

Good fit
  • A machine-learning developer needs to batch-download or upload model, dataset, or Space files.
  • A team needs to manage Hub repositories, branches, tags, visibility, and pull requests.
  • A user needs to run or schedule training, inference, or data-processing jobs on Hugging Face infrastructure.
  • A researcher needs to inspect dataset Parquet files, execute DuckDB SQL, or verify a local cache.
  • An operator needs to deploy, pause, scale, or maintain Hugging Face Inference Endpoints or Spaces.

How do you install this skill?

Before you use it
  • The installer executes a remote script directly through a curl-to-shell pipeline; pin or verify the script before execution.
  • The skill includes token printing, uploads, repository or bucket deletion, job execution, endpoint deployment, and endpoint deletion; require explicit per-action confirmation, least-privilege tokens, and a recovery plan.
  • The trigger description is overly broad and may invoke this CLI skill for general AI/ML requests that do not require Hugging Face operations.
  • The core service depends on overseas Hugging Face infrastructure; mainland-China reachability, proxy configuration, and offline alternatives are undocumented.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Hugging Face Hub CLI (hf)

Install the CLI with: curl -LsSf https://hf.co/cli/install.sh | bash -s. Then place this skill directory in one of Codex's standard .agents/skills locations, or install hf-cli from the huggingface/skills Claude Code plugin marketplace. The README does not provide one universal command that installs this SKILL.md into every client.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/hf-cli" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Use the hf-cli skill to log in to Hugging Face, download openai-community/gpt2, and list its files.

In a coding agent with the skill installed, request a concrete Hub operation, for example: “Use the hf-cli skill to log in to Hugging Face, download openai-community/gpt2, and list its files.” Use hf --help for command details; authentication commands are under hf auth, such as hf auth whoami. The source recommends providing credentials through the HF_TOKEN environment variable.

What are this skill's strengths and limitations?

Pros
  • Broad coverage of Hub resources, jobs, sandboxes, and inference endpoints.
  • Supports JSON and agent-oriented output formats.
  • The README says the skill is generated from the locally installed CLI and can be updated with `hf skills update`.
  • Explicitly replaces the deprecated `huggingface-cli` command.
Limitations
  • Requires shell, network access, and local filesystem access.
  • Many operations require a Hugging Face account or access token; the source does not define exact permission boundaries or costs.
  • The source provides no test suite, platform compatibility matrix, or troubleshooting guidance.
  • The command surface is large, so first-time users will need `hf --help` for detailed usage.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Hugging Face Hub CLI Skill this page 42 · Not recommended ★ 11k 18d ago Apache-2.0
Hugging Face CLI Skill 55 · Use with care ★ 38k 14d ago MIT
Azure W&B Resource Manager for .NET ✓ Microsoft · Official 42 · Not recommended ★ 2.7k 3mo ago MIT
NeMo AutoModel Model Onboarding ✓ NVIDIA · Official 60 · Recommended ★ 3.6k 12d ago Apache-2.0
Hugging Face ZeroGPU Builder 56 · Use with care ★ 11k 18d ago Apache-2.0

This skill uses the current hf command and replaces the deprecated huggingface-cli. The source provides no feature comparison with other CLIs or SDKs.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Not recommended
42/ 100 5-point scale 2.1 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust8 / 25 · 1.6/5

The evidence shows coverage of downloads, uploads, authentication, cloud jobs, sandboxes, and endpoint management, with some destructive operations exposing --yes, --dry-run, or irreversible-operation warnings. However, the curl-piped shell installer, unclear permission boundaries and sensitive-data flows, token exposure via `hf auth token` stdout, incomplete confirmation guidance, rollback coverage, and extension-install security review reduce trust. The publisher is unverified, but that status alone is not deducted.

2Reliability8 / 20 · 2.0/5

Command grouping, parameters, and the replacement of the deprecated command are reasonably clear, and the file identifies generation from `huggingface_hub v1.23.0`. Still, this is only a static command inventory: key-path tests, input-boundary coverage, dependency availability, and diagnosable abnormal-failure guidance are absent. End-to-end reliability therefore remains unproven and is scored conservatively under the static ceiling.

3Adaptability6 / 15 · 2.0/5

The description covers models, datasets, Spaces, jobs, papers, repositories, and cloud storage, with broad trigger terms. However, triggering on essentially any AI/ML or cloud-storage request is overbroad, while non-fit boundaries, input/output contracts, exclusion conditions, and Chinese-language support are not defined. Core functionality depends on huggingface.co and related overseas infrastructure, whose reachability from mainland China is not addressed, so points are deducted.

4Convention8 / 15 · 2.7/5

The evidence includes Agent Skills formatting, installation instructions, grouped commands, generated-version metadata, README installation paths, an Apache-2.0 license, a security-report channel, and CI validation of generated artifacts. It lacks task-oriented examples, troubleshooting, known limitations, stable-parameter guidance, a changelog, and clearly assigned maintenance responsibility, so it does not merit full marks.

5Effectiveness7 / 15 · 2.3/5

The command inventory directly covers many Hub-management tasks and offers agent/json output formats, so the core CLI value is plausible. However, there are no representative outputs, verified task results, end-to-end workflow examples, or comparison with manual/API alternatives. Complex cloud and destructive operations also require substantial contextual judgment, so the score is capped by static evidence and reduced for incomplete direct usability.

6Verifiability5 / 10 · 2.5/5

A pinned revision, generated-version note, README generation and CI checks, security policy, and workflow evidence provide some traceability. There is no committed test suite covering the skill's key paths and no third-party execution evidence or independently reproducible results, so verifiability remains limited under static review.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 86cdeee824b7 Review evidence[1][2][3][4][5]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Should I still use `huggingface-cli`?
No as the preferred command; the source explicitly states that `hf` replaces the deprecated `huggingface-cli`.
Do I need a token?
Authentication supports browser login or a token from huggingface.co/settings/tokens; the source recommends the `HF_TOKEN` environment variable.
Can it run cloud jobs?
Yes. The skill includes commands to run, schedule, inspect, log, wait for, and cancel Hugging Face Jobs.
Does it cover every Hugging Face workflow?
No. The repository contains 26 separate skills; this profile covers only `skills/hf-cli/SKILL.md`. Other specialized workflows must be installed separately.

More skills from this repository

All from huggingface/skills

Dev & Engineering

Hugging Face ZeroGPU Builder

Build dependable Gradio AI demos and GPU workloads on Hugging Face ZeroGPU.

★ 11k FS 56 Use with care 18d ago
Data & Analysis

Hugging Face Dataset Explorer

Explore, query, and extract Hugging Face datasets through the Dataset Viewer API.

★ 11k FS 49 Use with care 18d ago
Data & Analysis

Hugging Face LLM Trainer

Train, fine-tune, and preserve models on Hugging Face cloud GPUs.

★ 11k FS 48 Use with care 18d ago
Data & Analysis

Hugging Face Local Evaluator

Run controlled inspect-ai or lighteval evaluations for Hugging Face Hub models on local hardware.

★ 11k FS 47 Use with care 18d ago
Data & Analysis

Hugging Face Model Finder

Recommends AI models by task, benchmark performance, and available device memory.

★ 11k FS 42 Not recommended 18d ago
Dev & Engineering

Hugging Face Paper Research Assistant

Read AI papers and retrieve structured metadata from Hugging Face paper pages.

★ 11k FS 49 Use with care 18d ago
Dev & Engineering

Hugging Face MCP Assistant

Connect agents to Hugging Face Hub for searchable models, datasets, documentation, apps, and compute jobs.

★ 11k FS 36 Not recommended 18d ago
Dev & Engineering

LoRA Space Demo Builder

Build and publish a tailored Gradio Space for a Hugging Face LoRA.

★ 11k FS 51 Use with care 18d ago
Dev & Engineering

Hugging Face Spaces Builder

Build, deploy, debug, and maintain machine-learning apps on Hugging Face Spaces.

★ 11k FS 50 Use with care 18d ago
Data & Analysis

Sentence Transformers Training Assistant

Train retrieval, similarity, reranking, and sparse-search models with Sentence Transformers.

★ 11k FS 47 Use with care 18d ago
Dev & Engineering

Hugging Face Local Model Runner

Choose compatible GGUF quantizations from Hugging Face and run them locally with llama.cpp.

★ 11k FS 44 Not recommended 18d ago
Dev & Engineering

Hugging Face API Tool Builder

Turn Hugging Face API calls into reusable, composable command-line tools.

★ 11k FS 41 Not recommended 18d ago
Data & Analysis

Hugging Face Model Memory Estimator

Estimate inference memory without downloading model weights.

★ 11k FS 44 Not recommended 18d ago
Data & Analysis

Trackio Experiment Tracking

Log, monitor, and query machine-learning experiments with dashboards, diagnostic alerts, and automation-ready output.

★ 11k FS 43 Not recommended 18d ago
Dev & Engineering

Gradio Interactive App Builder

Build Gradio web interfaces, machine-learning demos, and chat apps in Python.

★ 11k FS 40 Not recommended 18d ago
Writing & Content

Hugging Face Paper Publisher

Publish, connect, and manage research papers on the Hugging Face Hub.

★ 11k FS 36 Not recommended 18d ago
Data & Analysis

Transformers.js Inference Skill

Run Hugging Face models directly inside JavaScript applications.

★ 11k FS 46 Use with care 18d ago
Data & Analysis

Hugging Face Vision Trainer

Train detection, classification, and segmentation models on Hugging Face Jobs GPUs and persist the results to the Hub.

★ 11k FS 43 Not recommended 18d ago
Automation & Ops

AWS Context Discovery

Resolve the active AWS environment before any account operation.

★ 11k FS 50 Use with care 18d ago
Automation & Ops

SageMaker Deployment Planner

Choose a practical Amazon SageMaker deployment path for your model, traffic pattern, and latency needs.

★ 11k FS 50 Use with care 18d ago

Related skills