Hugging Face Skills（Hugging Face 官方 AI 技能包）

# Hugging Face Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能本身、它们的脚本或参考文件。这些要从 Hugging Face 的仓库安装：https://github.com/huggingface/skills

许可证：Apache-2.0，见 plugin.json。全文见 https://github.com/huggingface/skills/blob/main/LICENSE

Hugging Face Skills 由 Hugging Face 制作。这个上架页面由 Mindket 制作，Mindket 并非 Hugging Face 制作或背书。

这些说明的来源：README（https://github.com/huggingface/skills/blob/main/README.md），https://github.com/huggingface/skills/tree/main/.claude-plugin 和 https://github.com/huggingface/skills/tree/main/.cursor-plugin 下的插件和插件市场文件，gemini-extension.json、.mcp.json、agentsmd/AGENTS.md 和每个 SKILL.md，以及两个 Hugging Face 文档页面：https://huggingface.co/docs/hub/agents-cli 和 https://huggingface.co/docs/huggingface_hub/guides/cli。关于 Claude Code 和 Codex 的事实出自它们自己的文档，用到的地方都注明了。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

在 Hugging Face Hub 上做 AI 和机器学习工作用的技能。README 说它们遵循 Agent Skills 格式，是数据集创建、模型训练和评测等任务的定义。README 的表格列出了二十五个。其中 hf-cli 是起点：它教智能体用好每一条 `hf` 命令，README 说它是根据你本地安装的 `hf` 程序生成的，所以能保持最新。

客户端插件市场只提供 hf-cli。README 说，其他技能按需用 `hf skills add <skill-name>` 安装。

## README 表格里的技能

| 技能 | README 说它用来做什么 |
|---|---|
| hf-cli | Hub 的命令行程序：下载、上传和管理模型、数据集、Spaces、存储桶、仓库、论文和任务 |
| hf-cloud-aws-context-discovery | 在 AWS 任务开始时找出你本地的 AWS 环境 |
| hf-cloud-python-env-setup | 一个用于 SageMaker 和 AWS 工作的隔离 Python 环境 |
| hf-cloud-sagemaker-deployment-planner | 规划把模型部署到 Amazon SageMaker AI |
| hf-cloud-sagemaker-iam-preflight | 在部署或训练之前，准备好一个可用的 SageMaker 执行角色 |
| hf-cloud-sagemaker-production-defaults | 一个默认开启自动扩缩容、CloudWatch 告警和标签的 SageMaker 端点 |
| hf-cloud-serving-image-selection | 为 SageMaker 模型部署选择推理容器 |
| hf-mem | 估算加载 Safetensors 或 GGUF 模型权重需要多少内存 |
| huggingface-best | 根据基准测试分数为某项任务找出最好的模型 |
| huggingface-community-evals | 在本地硬件上用 inspect-ai 和 lighteval 评测 Hub 上的模型 |
| huggingface-datasets | Dataset Viewer API：拆分、行、搜索、筛选、parquet 链接和统计信息 |
| huggingface-gradio | 用 Python 写 Gradio 网页界面和演示 |
| huggingface-llm-trainer | 在 Hugging Face Jobs 上用 TRL 或 Unsloth 微调语言模型和视觉模型 |
| huggingface-local-models | 挑选用 llama.cpp 和 GGUF 在本地运行的模型 |
| huggingface-lora-space-builder | 为你的 LoRA 在 Spaces 上做一个 Gradio 演示 |
| huggingface-paper-publisher | 在 Hub 上发布和管理研究论文 |
| huggingface-papers | 阅读 Hugging Face 的论文页面和使用论文 API |
| huggingface-spaces | 在 Spaces 上构建、部署和维护应用 |
| huggingface-tool-builder | 使用 Hugging Face API 数据的脚本 |
| huggingface-trackio | 跟踪和可视化机器学习训练实验 |
| huggingface-vision-trainer | 训练目标检测、图像分类和 SAM 模型 |
| huggingface-zerogpu | 用 Gradio Spaces 和 ZeroGPU 做演示和 GPU 计算 |
| train-sentence-transformers | 训练 SentenceTransformer、CrossEncoder 和 SparseEncoder 模型 |
| transformers-js | 用 Transformers.js 在 JavaScript 和 TypeScript 里运行模型 |
| trl-training | 用 TRL 微调语言模型 |

来源：README 的表格，表格注明它由 scripts/generate_agents.py 生成。仓库里还有 hf-mcp，一个关于 Hub 的 MCP 服务器的技能，放在它自己的文件夹（hf-mcp/skills/hf-mcp）里，不在这张表格中。

## 工具包里的文件

- setup/claude-code.md：README 给 Claude Code 的三个步骤
- setup/hf-cli-and-first-run.md：安装 `hf` 程序、登录、添加更多技能，以及哪些会产生费用
- setup/codex.md：README 给 Codex 的步骤
- setup/gemini-cli.md：两条 Gemini CLI 安装命令
- setup/cursor.md：README 关于 Cursor 说了什么
- setup/other-agents.md：给不支持技能的智能体用的 AGENTS.md 备用方式

## 先准备好这些

- 能读取技能的智能体：Claude Code、Codex、Gemini CLI 或 Cursor，也就是 README 提到的四种。
- `hf` 程序，用于 `hf skills add`，也用于 hf-cli 教的那些命令（setup/hf-cli-and-first-run.md）。
- 一个 Hugging Face 账号，上传、训练、部署或读取受限模型时都需要。有些技能需要付费方案：同一个文件写明了是哪些。
- 带 `uv` 的 Python，用于训练技能里的脚本，这是它们的 SKILL.md 文件说的。

## 装到哪里

- Claude Code：hf-cli 插件，由 Claude Code 自己保管。用 `hf skills add` 添加的技能放在这个命令放的地方：当前项目，或者加上 `--global` 时的所有项目（setup/hf-cli-and-first-run.md）。
- Codex：你复制或链接到 `.agents/skills` 文件夹里的技能文件夹。
- Gemini CLI：一个扩展，带一个上下文文件 agentsmd/AGENTS.md，以及一条指向 Hugging Face 自己服务器的 MCP 配置。
- Cursor：仓库自带的插件和 MCP 文件。

## 你的数据

这些技能是带脚本和参考资料的指令。其中有几个会让智能体用你的登录身份调用 Hugging Face 的服务器、上传文件、启动付费的云端任务，或者创建公开的 Spaces。Gemini 扩展和 Cursor 插件还会接入 Hugging Face 自己的 MCP 服务器 https://huggingface.co/mcp?login，智能体发给它的内容都会到那里。SageMaker 技能在你的 AWS 账号里工作。智能体读到的内容会发给你选的模型提供方。

## 更新和卸载

- 用 `hf skills add` 添加的技能：`hf skills update` 会更新它们，`hf skills list` 列出可用的技能。两条命令都在 hf-cli 技能的命令列表里。
- 全局安装的 hf-cli 技能：Hugging Face 的 agents 页面说，`hf update` 会刷新它，`hf skills update -g` 可以单独刷新它。
- Claude Code 插件：Claude Code 的文档说，`/plugin` 的 Installed 标签页里有更新和卸载，卸载命令的写法是 `/plugin uninstall <plugin-name>@<marketplace-name>`。
- Gemini CLI、Codex 和 Cursor：setup/gemini-cli.md、setup/codex.md 和 setup/cursor.md 写明了 README 为每一种给了什么。

README.md  7 KB
setup/claude-code.md  3 KB
setup/codex.md  3 KB
setup/cursor.md  2 KB
setup/gemini-cli.md  2 KB
setup/hf-cli-and-first-run.md  5 KB
setup/other-agents.md  2 KB