Agent skill

Huggingface Hub

by AlexAI-MCP in AlexAI-MCP/hermes-CCC

HuggingFace Hub — download models/datasets, upload artifacts, search, and manage tokens via CLI and Python API.

MITAuto-check passedAI & LLM Engineering

Install Huggingface Hub

skills CLI
$ npx skills add AlexAI-MCP/hermes-CCC --skill huggingface-hub -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AlexAI-MCP/hermes-CCC huggingface-hub --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/huggingface-hub .claude/skills/huggingface-hub && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
huggingface-hub
GitHub stars
135
Token cost
~965 tokens
SKILL.md length
73 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
MIT

At a glance

HuggingFace Hub — download models/datasets, upload artifacts, search, and manage tokens via CLI and Python API.

  • Works in 3 steps: Go to hf.co/model-card and accept terms → Use a token with read access:… → Download normally — gate is checked…
  • AI & LLM Engineering work in your project
  • SKILL.md covers Setup, Download Models, Download Datasets and Upload Models, plus 6 more sections
  • Calls huggingface-cli, pip and python; needs HF_TOKEN

What it does

Huggingface Hub is an agent skill from AlexAI-MCP/hermes-CCC. HuggingFace Hub — download models/datasets, upload artifacts, search, and manage tokens via CLI and Python API.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering. It works with Hugging Face and Python. The repository describes itself as: Hermes Agent ported to Claude Code Channel — 46 native skills, no OAuth, no external process. The licence is MIT.

When your agent uses it

  • AI & LLM Engineering work in your project

Example prompts

  • “/huggingface-hub”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Go to hf.co/model-card and accept terms
  2. Use a token with read access: huggingface-cli login
  3. Download normally — gate is checked server-side

What it can do on your machine

Read from SKILL.md and the folder at commit 8107e89. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • huggingface-cli
    • pip
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • HF_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Huggingface Hub loads about 965 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 73 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~965

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AlexAI-MCP/hermes-CCC at commit 8107e89, republished under its MIT licence (© AlexAI-MCP). 73 words, ~965 tokens.

Download SKILL.mdSave it as .claude/skills/huggingface-hub/SKILL.md (or your agent's skills folder).
name
huggingface-hub
description
HuggingFace Hub — download models/datasets, upload artifacts, search, and manage tokens via CLI and Python API.
version
1.0.0
author
hermes-CCC (ported from Hermes Agent by NousResearch)
license
MIT

HuggingFace Hub

Download models and datasets, upload artifacts, and manage your Hub presence via CLI and Python API.

Setup

bash
pip install huggingface_hub datasets transformers
huggingface-cli login   # paste your token from hf.co/settings/tokens

Or set env var:

bash
export HF_TOKEN=hf_...

Download Models

bash
# Download entire model to cache (~/.cache/huggingface/)
huggingface-cli download meta-llama/Llama-3.1-8B-Instruct

# Download to specific directory
huggingface-cli download Qwen/Qwen2.5-7B-Instruct --local-dir ./models/qwen

# Download specific file only
huggingface-cli download microsoft/phi-4 config.json

# Download GGUF quantized model
huggingface-cli download bartowski/Llama-3.1-8B-Instruct-GGUF \
  Llama-3.1-8B-Instruct-Q4_K_M.gguf --local-dir ./models/

Python API:

python
from huggingface_hub import snapshot_download, hf_hub_download

# Full model
snapshot_download("meta-llama/Llama-3.1-8B-Instruct", local_dir="./models/llama")

# Single file
hf_hub_download("meta-llama/Llama-3.1-8B-Instruct", "config.json", local_dir="./")

Download Datasets

bash
# CLI
huggingface-cli download --repo-type dataset HuggingFaceH4/ultrachat_200k

# Python (preferred)
from datasets import load_dataset

dataset = load_dataset("HuggingFaceH4/ultrachat_200k")
dataset["train_sft"].to_json("./data/train.jsonl")

Upload Models

bash
# Upload directory
huggingface-cli upload your-username/my-model ./local-model-dir

# Upload specific file
huggingface-cli upload your-username/my-model ./model.safetensors

# Create repo first if needed
huggingface-cli repo create my-new-model --type model

Python API:

python
from huggingface_hub import HfApi

api = HfApi()
api.upload_folder(
    folder_path="./fine-tuned-model",
    repo_id="your-username/my-fine-tuned-model",
    repo_type="model",
)

Search Models

bash
# CLI search
huggingface-cli search models --filter task=text-generation --filter language=ko

# Python API
from huggingface_hub import list_models

models = list_models(
    task="text-generation",
    language="ko",
    sort="downloads",
    limit=10,
)
for m in models:
    print(m.id, m.downloads)

Cache Management

bash
# Show cache info
huggingface-cli cache info

# List cached repos
huggingface-cli cache scan

# Delete specific cached model
huggingface-cli cache evict --model meta-llama/Llama-3.1-8B-Instruct

# Cache location
echo ~/.cache/huggingface/hub/

Custom cache dir:

bash
export HF_HOME=/path/to/custom/cache

Model Cards

bash
# Read model card
python -c "from huggingface_hub import ModelCard; print(ModelCard.load('Qwen/Qwen2.5-7B-Instruct'))"

Spaces

bash
# Deploy a Gradio/Streamlit app to Spaces
huggingface-cli upload your-username/my-space ./app --repo-type space

# Check Space status
huggingface-cli space info your-username/my-space

Token Management

bash
# Who am I?
huggingface-cli whoami

# List tokens
huggingface-cli token list

# Revoke
huggingface-cli token revoke TOKEN_NAME

Gated Models (Llama, Gemma, etc.)

  1. Go to hf.co/model-card and accept terms
  2. Use a token with read access: huggingface-cli login
  3. Download normally — gate is checked server-side
python
# Check if you have access
from huggingface_hub import model_info
info = model_info("meta-llama/Llama-3.1-8B-Instruct")
print(info.gated)  # False if you have access

© AlexAI-MCP, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/huggingface-hub of AlexAI-MCP/hermes-CCC.

Open the folder on GitHubat commit 8107e89

Compare with similar skills

Huggingface Hub next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Huggingface Hub compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Huggingface Hub this skillAlexAI-MCP/hermes-CCC135—~965Automated safety check: PassMIT
Chroma Vector DatabaseOrchestra-Research/AI-Research-SKILLs13k7 repos~2.3kAutomated safety check: PassMIT
Python Environment Setup for SageMakerhuggingface/skills11k2 repos~1.7kAutomated safety check: PassApache-2.0
Qwen Mtp GgufR6410418/Jackrong-llm-finetuning-guide1.7k—~1.7kAutomated safety check: PassMIT
Hugging Face TokenizersOrchestra-Research/AI-Research-SKILLs13k6 repos~3.4kAutomated safety check: PassMIT
Hugging Face Vision Trainerhuggingface/skills11k1 repos~7.5kAutomated safety check: PassApache-2.0

Similar skills

  • Chroma Vector Database

    Orchestra-Research/AI-Research-SKILLs

    Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.

    13k GitHub starsUsed in 7 repos~2.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Sets up an isolated Python environment with a supported interpreter and current boto3 before any SageMaker deployment, training or AWS automation code runs.

    11k GitHub starsUsed in 2 repos~1.7k tokens
    AI & LLM EngineeringAuto-check passed
  • Qwen Mtp Gguf

    R6410418/Jackrong-llm-finetuning-guide

    Complete agent-ready workflow for Qwen-family MTP or nextn GGUF conversion and release.

    1.7k GitHub stars~1.7k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Hugging Face Tokenizers

    Orchestra-Research/AI-Research-SKILLs

    Shows how to load, train and use fast Hugging Face tokenizers, with BPE, WordPiece and Unigram models, padding, truncation and alignment tracking.

    13k GitHub starsUsed in 6 repos~3.4k tokens
    AI & LLM EngineeringAuto-check passed
  • Hugging Face Vision Trainer

    huggingface/skills

    Official

    Trains and fine-tunes object detection, image classification and SAM or SAM2 segmentation models on Hugging Face Jobs cloud GPUs and saves the results to the Hub.

    11k GitHub starsUsed in 1 repo~7.5k tokens
    AI & LLM EngineeringAuto-check passed
  • Edge Bringup

    exeex/edge-cores

    Prepare a macOS or Ubuntu machine for edge-e3 development, diagnose missing Verilator/LLVM/Python dependencies, initialize the public repository, and answer or act on the example prompts in the root…

    110 GitHub stars~1.7k tokensUpdated 15 days ago
    AI & LLM EngineeringAuto-check: notes

More from AlexAI-MCP/hermes-CCC

All 44 skills in this repo
  • GitHub Code Review

    AlexAI-MCP/hermes-CCC

    Review GitHub pull requests with a findings-first engineering mindset.

    135 GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • GitHub PR Workflow

    AlexAI-MCP/hermes-CCC

    Run a disciplined GitHub pull request workflow from branch creation through merge.

    135 GitHub stars~1.4k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Memory

    AlexAI-MCP/hermes-CCC

    Manage durable project memory for Claude Code. An agent skill from AlexAI-MCP/hermes-CCC.

    135 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Route

    AlexAI-MCP/hermes-CCC

    Route Claude Code work by complexity, risk, and tool needs. An agent skill from AlexAI-MCP/hermes-CCC.

    135 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Skill

    AlexAI-MCP/hermes-CCC

    Create, improve, inventory, and audit Claude Code skills. An agent skill from AlexAI-MCP/hermes-CCC.

    135 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Traj

    AlexAI-MCP/hermes-CCC

    Capture Claude Code interaction trajectories in training-friendly formats.

    135 GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Questions about Huggingface Hub

What does Huggingface Hub do?

HuggingFace Hub — download models/datasets, upload artifacts, search, and manage tokens via CLI and Python API. Huggingface Hub is an agent skill from AlexAI-MCP/hermes-CCC. HuggingFace Hub — download models/datasets, upload artifacts, search, and manage tokens via CLI and Python API.

When should I use Huggingface Hub?

Huggingface Hub fits situations like: AI & LLM Engineering work in your project.

How do I install Huggingface Hub in Claude Code?

Run `npx skills add AlexAI-MCP/hermes-CCC --skill huggingface-hub -a claude-code`. Or copy the skill folder (skills/huggingface-hub in AlexAI-MCP/hermes-CCC) into .claude/skills/huggingface-hub in your project. Claude Code loads it when a task matches its description.

How do I install Huggingface Hub in Codex?

Run `npx skills add AlexAI-MCP/hermes-CCC --skill huggingface-hub -a codex`. Or copy the skill folder (skills/huggingface-hub in AlexAI-MCP/hermes-CCC) into .agents/skills/huggingface-hub in your project. Codex loads it when a task matches its description.

Can I use Huggingface Hub in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AlexAI-MCP/hermes-CCC --skill huggingface-hub -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/huggingface-hub, .gemini/skills/huggingface-hub, .github/skills/huggingface-hub and .opencode/skills/huggingface-hub in your project.

What does Huggingface Hub need to run?

Going by SKILL.md and its folder, Huggingface Hub needs the command-line tools its instructions call (huggingface-cli, pip and python) and credentials named HF_TOKEN. Our summary lists: Python 3.

Does Huggingface Hub access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Huggingface Hub safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Huggingface Hub use?

Huggingface Hub is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Huggingface Hub use?

About 965 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Huggingface Hub?

Skills that share tags, products or a category with Huggingface Hub: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), Python Environment Setup for SageMaker (huggingface/skills, 11k stars), Qwen Mtp Gguf (R6410418/Jackrong-llm-finetuning-guide, 1.7k stars) and Hugging Face Tokenizers (Orchestra-Research/AI-Research-SKILLs, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Huggingface Hub?

AlexAI-MCP (a GitHub user) maintains it in AlexAI-MCP/hermes-CCC, which has 135 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on April 8, 2026.

Source: AlexAI-MCP/hermes-CCC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.