Hugging Face

Purpose

Verify the user's Hugging Face account and search the public model hub: whoami (name, email), and model search by keyword with likes/downloads. Read-only: no repo writes ship in this skill.

Tooling

All commands go through bin/huggingface.py:

bin/huggingface.py me                        # whoami: name, email, account type
bin/huggingface.py models --query llama      # search the model hub (id, likes, downloads), 10 results

Auth

• Provider id: huggingface (credential is collected as custom.huggingface)
• Collection: user access token via the secure credential flow (credentials.request_api_access): create one at huggingface.co/settings/tokens (a fine-grained read token is enough)
• Connect placement: bearer_header
• Allowed hosts: huggingface.co
• Status check: bin/huggingface.py me (a successful whoami proves the token works)

Operating Rules

1. This skill is read-only. No repository creation, upload, or delete commands ship.
2. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/huggingface.py). Do not print, log, or transmit the token value.

Files

• SKILL.md
• bin/huggingface.py

Maturity

🧪 Draft: written from Hugging Face's public Hub API docs; not yet live-tested end-to-end.