hf-cli skill 是什麼、怎麼安裝使用：Hugging Face 官方命令行 Skill（下載模型、管理數據集、跑 Jobs）

本文根據 huggingface/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 huggingface/skills 在 GitHub 約 1.1 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

Hugging Face 的命令行工具這兩年變化很大：命令從 huggingface-cli 改成了 hf，認證相關的子命令也挪了位置，又新增了 Jobs、存儲桶、推理端點等一批功能。模型憑舊記憶敲出來的命令經常已經不存在。hf-cli 技能就是一份與當前版本同步的命令參考。

description 的範圍：用 Hugging Face Hub CLI（hf）下載、上載和管理 Hub 上的模型、數據集、Spaces、存儲桶、倉庫、論文、Jobs 等。具體場景包括處理認證、管理本地緩存、在 Hugging Face 的基礎設施上運行或定時運行任務、管理倉庫及其討論與合併請求、瀏覽模型和數據集、閱讀與搜尋論文、管理合集、查詢數據集、配置 Spaces、設定 Webhook、部署和管理推理端點。用戶提到 hf、huggingface 或想做任何與 Hugging Face 生態相關的事時都應使用。

SKILL.md 開頭有兩句要緊的話：hf 命令取代了已棄用的 huggingface-cli；認證命令現在都在 hf auth 下（例如 hf auth whoami）。正文按子命令分組列出用法——hf auth、hf cache、hf datasets、hf jobs、hf models、hf spaces、hf endpoints 等。文件註明是由 huggingface_hub 庫自動生成的，可以用 hf skills add --force 重新生成以匹配你安裝的版本。

怎麼安裝

按倉庫 README，Claude Code 先登記市場並安裝基礎的 CLI 技能，其餘技能再用 hf 命令行添加：

text
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface/skills

bash
hf skills add hf-cli

Codex 的做法是把倉庫 skills/ 下需要的文件夾複製或軟連結到 .agents/skills；Gemini CLI 用 gemini extensions install https://github.com/huggingface/skills.git --consent。

倉庫整體介紹和其他安裝方式，詳見本站《huggingface/skills 是什麼、怎麼安裝：Hugging Face 官方 Agent Skills（hf-cli、模型訓練、數據集、Spaces、Gradio）》。

hf-cli 就是上面第一步安裝的那個基礎技能，裝好後再用它添加其他 Hugging Face 技能。

怎麼用

• 「下載這個模型的 GGUF 量化文件到本地 models 目錄」。
• 「把 ./data 上載成一個私有數據集倉庫」。
• 「看看我的本地緩存佔了多少空間，清掉三個月沒用過的模型」。

這個技能只有一份 SKILL.md（篇幅較長，是完整的命令清單）。

適合誰 / 侷限

適合經常和 Hugging Face Hub 打交道的算法工程師、研究者和本地模型玩家。它只是命令參考，訓練、評測、搭建演示等流程在該庫的其他技能裏；國內網絡訪問 Hub 可能不穩定，這不是技能能解決的。

注意事項

• 許可：Apache-2.0。
• 令牌：上載、訪問私有或受限倉庫需要你的 Hugging Face 訪問令牌，用 hf auth login 在終端裏登入，不要把令牌貼進對話；令牌權限按需選擇只讀或讀寫。
• 費用：Jobs、推理端點等雲端功能按 Hugging Face 的價格計費，讓智能體啟動前先確認規格。
• SKILL.md 開頭給的 CLI 安裝方式是「下載腳本並執行」，介意的話改用 Hugging Face 官方文檔列出的其他安裝方式。