1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | huggingface-paper-publisher-huggingface-skills |
| 作者/维护者 | Hugging Face（官方） |
| 来源链接 | https://github.com/huggingface/skills/tree/main/skills/huggingface-paper-publisher |
| 许可证 | Apache-2.0（数据来自 GitHub API；为所属合集仓库 huggingface/skills 整体许可证） |
| GitHub Stars | 10,909（数据来自 GitHub API；为所属合集仓库 huggingface/skills 整体数字，非本技能个体热度） |
| Forks | 724（同上，仓库整体数字） |
| 最新版本 | SKILL.md 内标注 Version 1.0.0；仓库未建立正式 GitHub Release 流程，随主分支持续更新 |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
huggingface-paper-publisher 是 Hugging Face 官方发布的论文发布与管理技能，覆盖研究论文从索引到展示的完整链路：
- 论文索引：通过 arXiv ID 将论文加入 Hugging Face Paper Pages（hf.co/papers），支持先查重再索引
- 关联模型/数据集：把论文链接写入模型卡或数据集卡的 YAML 元数据，Hub 会自动生成
arxiv:<ID>标签，使论文与其开源实现互相可发现 - 作者身份认领：发起并查询论文作者身份认领流程
- 主页可见性管理：控制已认领论文是否展示在个人主页
- 研究文章生成：提供
standard（传统学术格式）、modern（类 Distill 简洁网页风格）、arxiv（arXiv 排版）、ml-report（机器学习实验报告）四套 Markdown 模板，含自动目录与 LaTeX 公式支持
所有操作由单一脚本 scripts/paper_manager.py 承载，采用 PEP 723 内联依赖声明，uv run 即可执行，无需手工搭建 Python 环境；目录下还配有 references/、examples/、templates/ 三个辅助目录。
3. 适用场景
固定分类：内容创作与知识管理
适用于在 Hugging Face 生态内发表研究成果的场景：研究者或 ML 工程师完成一篇论文后，希望将其索引到 hf.co/papers、认领作者身份、把论文与自己发布的模型/数据集互相关联以提升可发现性，或希望用现成模板快速产出一篇排版专业的研究报告/技术文章，而不必手工处理 Markdown 与引用格式。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——Hugging Face 官方文档明确列出该技能，通过
/plugin marketplace add huggingface/skills注册后/plugin install huggingface-paper-publisher@huggingface/skills安装 - Codex：✅ 原生支持——官方文档确认技能遵循 Agent Skills 标准，复制或软链接到
.agents/skills目录即可被自动发现 - OpenClaw：❓ 未验证——官方文档未提及，本次材料不足以判断
- Hermes Agent：❓ 未验证——官方文档未提及，本次材料不足以判断
5. 推荐理由
Hugging Face 生态里“读论文”与“发论文”是两个方向的独立需求：读的一侧已有官方技能覆盖，发的一侧此前缺位。本技能补上这一环——把索引论文、关联模型数据集、认领作者身份、生成排版专业的研究文章这几个此前需要手工在网页上逐步操作的动作，收进一套可复用的脚本化流程，对经常在 Hub 上发布模型/数据集并希望论文获得更好可发现性的研究者与 ML 工程师直接有用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 Hugging Face 官方发布并维护。所属合集仓库 huggingface/skills 整体 10,909 星、724 复刻，该数字代表整个合集，不代表本技能自身独立热度；本技能自身目前未见第三方平台的独立评价或采用数据 |
| 可用性 | 8 | SKILL.md 与配套脚本、模板、参考文档齐全；核心操作经单一脚本 paper_manager.py（uv run 直接执行，依赖随脚本声明，无需额外环境搭建）完成；需要用户提供具备写入权限的 HF_TOKEN；最近一次改动发生于 2026-03-23 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
- 代码执行范围：脚本仅执行 Hugging Face Hub 论文管理相关操作（索引、元数据关联、认领查询、本地生成 Markdown 文件），无越界行为
- 联网外发：仅与 Hugging Face Hub 官方 API 通信，未见其他外发目标
- 凭据处理：需要用户提供写权限
HF_TOKEN，经python-dotenv/环境变量加载，脚本内未见明文存储或额外外泄路径 - 可疑指令：SKILL.md 与脚本内容未见混淆代码或提示词注入迹象
- 作者信誉：发布方为 Hugging Face 官方，无造假迹象
- License：明确，仓库级 Apache-2.0
- 维护时间：最近一次改动 2026-03-23
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| huggingface-papers-huggingface-skills | 官方零依赖技能，读取并理解 HF 论文页或 arXiv 论文，定位关联的开源实现 | 面向“读”论文的消费端；本技能面向“发”论文的生产端，二者是同一官方生态里方向互补的一对工具，可配合使用 |
| academic-research-skills | 将文献检索、写作、审稿模拟等学术研究全流程封装为带质量关卡的多智能体流程 | 覆盖面更广（从选题到审稿的完整科研写作生命周期），但不针对 Hugging Face Hub 的论文页发布、模型/数据集关联与作者认领这些平台特定操作 |
| 手工在 hf.co 网页操作 | Hugging Face Hub 自带的网页端论文提交、认领与关联入口 | 无需额外工具即可完成基础操作，但索引、关联、认领需逐步手动点击，且不提供开箱即用的排版模板生成能力 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
研究文章生成功能提供四种模板风格（传统学术、类 Distill 简洁网页风格、arXiv 排版、机器学习实验报告），覆盖从正式论文到实验记录的不同写作场景。
10. 安装使用方式
Claude Code：
/plugin marketplace add huggingface/skills
/plugin install huggingface-paper-publisher@huggingface/skillsCodex：将仓库中 skills/huggingface-paper-publisher 目录复制或软链接到 $REPO_ROOT/.agents/skills 或 $HOME/.agents/skills，Codex 会按 Agent Skills 标准自动发现。
通用（任意支持该标准的 Agent）：克隆 https://github.com/huggingface/skills 后，将 skills/huggingface-paper-publisher 目录复制进本地 skills 目录。
安装后注意事项：使用前需配置具备写权限的 HF_TOKEN 环境变量；脚本通过 uv run scripts/paper_manager.py <子命令> 调用，各子命令（index / link / claim / list-my-papers / toggle-visibility / create）的路径均相对于该 SKILL.md 所在目录，执行前需先切换到该目录或使用完整路径。
11. 注意事项
- 认领作者身份（claim authorship）流程需等待 Hugging Face 官方团队人工审核，非即时生效
- 生成的研究文章为本地 Markdown 文件，发布到 hf.co/papers 仍需经过官方索引流程
- 该技能是所属合集仓库 huggingface/skills 中的一个子目录，需按上方安装方式定位到具体子目录，而非安装整个仓库