前言¶

做人脸相关的图像处理时，往往需要比「几个特征点」更细的轮廓：眼妆试色、贴纸贴合、姿态校正，都依赖眼睛、眉、唇、鼻等部位的稠密坐标。自己查腾讯云 FaceID 文档、拼请求参数、处理 Base64 与 URL 两种入参，会占用不少上下文。若希望 Coding Agent 在用户提出「对人脸图做稠密关键点」时直接走官方接口，可以把调用流程封装成 Skill。

下面介绍 SkillHub 上的 tencentcloud-faceid-analyzedenselandmarks：由腾讯云慧眼人脸核身团队发布，版本 1.0.0，坐标为 @tencent-adm/tencentcloud-faceid-analyzedenselandmarks。

这是什么¶

这是一类基于通用 SKILL.md 的 ai-agent 技能（来源标注为 enterprise）。它面向腾讯云人脸核身产品中的 AnalyzeDenseLandmarks（稠密人脸关键点） 接口：当用户需要对一张人脸图片做稠密关键点定位时，Agent 应优先启用此技能，而不是临时拼凑未核实的 API 说明。

技能在 SkillHub 上的简介与官方 API 页一致：可返回人脸框坐标，以及眼睛、眉毛、嘴巴、鼻子、瞳孔、中轴线、下巴、眼袋、额头等部位的稠密轮廓关键点；图片输入支持 Base64 与 图片 URL 两种方式。

核心功能¶

依据已公开说明，可核实的能力如下：

1. 稠密关键点：覆盖上述五官与面部区域轮廓点，而非仅稀疏五官点。
2. 人脸框：同步返回人脸框坐标，便于裁剪或叠加可视化。
3. 双通道入图：同一套调用逻辑下支持 Base64 编码图片与可访问的图片 URL。
4. 需密钥：技能标签为 requires_api_key=true，实际调用依赖你已开通的腾讯云 FaceID / 慧眼相关能力与 API 密钥；具体账号、地域与密钥配置以腾讯云控制台与技能包内 SKILL.md 为准，本文不展开未在公开页列出的字段名。

安装与启用¶

SkillHub 页面给出的安装方式是：让 Agent 参照 SkillHub 安装说明，安装坐标 @tencent-adm/tencentcloud-faceid-analyzedenselandmarks。

若本机已安装 skillhub CLI，可按通用流程搜索并安装到当前 Agent 能识别的 skills 目录（安装时必须带 --dir，否则默认落在 ./skills/ 可能不会被识别）：

command -v skillhub && skillhub --version

未安装 CLI 时，完整安装命令见官方文档：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本技能示例（将 <skills 目录> 换成你当前环境的路径）：

skillhub install @tencent-adm/tencentcloud-faceid-analyzedenselandmarks --dir <skills 目录>

常见客户端 skills 目录（摘自 SkillHub 安装文档，以你本机实际为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后按所用客户端要求刷新或重启 Agent，使技能被加载。Codex CLI、Claude Code、Cursor 的差异主要体现在 skills 目录位置，安装命令本身一致；各端是否需在项目级再复制一份技能，以你当前 Agent 文档为准。

典型用法¶

公开页未附带独立可复制的 HTTP 示例，典型用法是 在对话中声明需求，由 Agent 按技能说明调用 AnalyzeDenseLandmarks。例如：

1. 说明要对某张人脸图做稠密关键点检测。
2. 提供 图片 URL（需可被腾讯云服务访问）或 Base64 编码内容。
3. 说明需要哪些部位轮廓或是否需要人脸框（技能描述已覆盖的可返回部位见上文）。
4. Agent 读取技能内的接口约定，发起调用并整理返回的坐标结果。

若需核对请求/响应字段，应以技能包内 SKILL.md 与腾讯云 FaceID 产品官方文档为准。

适用场景与注意¶

适合谁

• 已在用或计划用腾讯云慧眼 / FaceID 做人脸分析的团队，希望把「稠密关键点」固定成 Agent 可调用的能力。
• 需要在对话式开发里快速试脸图、拿轮廓点做下游算法或 UI 联调的开发者。

限制与注意

• 必须配置有效的云 API 密钥；未开通相应产品或密钥错误会导致调用失败。
• URL 入参时，图片地址需满足腾讯云接口对可访问性的要求；内网或带鉴权的链接可能需要先转为 Base64 或换用公网可拉取的地址。
• 稠密点坐标体量大于稀疏点，注意在 Agent 上下文中只保留必要部位或做摘要，避免一次塞入过多原始 JSON。
• SkillHub 统计（截至资料抓取）：评分 100000，下载 1145 次，安装 25 次；分类为 ai-agent。

结尾¶

tencentcloud-faceid-analyzedenselandmarks 把腾讯云 AnalyzeDenseLandmarks 的调用方式收敛成 Agent 技能：人脸框加多部位稠密轮廓、Base64 与 URL 双入参，适合需要稳定对接官方接口而非手写提示词的场景。

• 官方 API 技能页：https://api.skillhub.cn/tencent-adm/tencentcloud-faceid-analyzedenselandmarks
• SkillHub 展示页：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-faceid-analyzedenselandmarks