前言¶
第一次在 SkillHub 上架或本地调试 Agent Skill 时，常见问题不是业务逻辑有多复杂，而是目录放错、CLI 没装、或不知道 SKILL.md 里该写多少。一个只处理「姓名 → 问候语」的演示 Skill，可以把安装路径、坐标格式和技能说明压缩到几行，便于对照官方流程验证环境。
下面介绍社区 Skill 简易问候Skill（@user_7bc7d8e4/my-first-greeting-skill）：它不做外部 API 调用，适合作为 dev-programming 分类下的入门样例。
这是什么¶
简易问候Skill 是 SkillHub 社区来源（community）的演示用 Skill，发布者为 user_7bc7d8e4，当前版本 1.0.0，分类为 dev-programming。官方页面将其定位为「基础姓名问候工具，演示用 Skill」。
在 SkillHub 上，坐标写作 @user_7bc7d8e4/my-first-greeting-skill；标签标明 requires_api_key=false，即不依赖 API Key。页面统计（以 SkillHub 抓取为准）：评分 100000，下载 871 次，安装 0 次。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_7bc7d8e4/my-first-greeting-skill
- 资料中的官方地址：https://api.skillhub.cn/user_7bc7d8e4/my-first-greeting-skill
核心功能¶
能力完全写在包内 SKILL.md 中，核实如下：
- 功能：接收姓名，返回问候语。
- 入参：
name（字符串）。 - 出参：
hello与name拼接形式的问候结果（文档表述为「hello + name」）。
没有额外脚本、配置项或第三方服务；Agent 读取 SKILL.md 后即可按上述约定响应。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 装到当前 Agent 的 skills 目录，或把安装提示词发给支持 Skill 的 AI 客户端由其按文档执行。
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录；默认 ./skills/ 往往不会被客户端加载。
skillhub install @user_7bc7d8e4/my-first-greeting-skill --dir <你的 skills 目录>
常见客户端路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，技能会落在类似 @user_7bc7d8e4/my-first-greeting-skill/ 的子目录中，内含 SKILL.md。
3. 通过提示词让 AI 安装¶
SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_7bc7d8e4/my-first-greeting-skill`。
将上述内容发给已接入 Skill 能力的 Agent，并确认 --dir 指向本机对应 skills 目录。
4. 启用¶
将 Skill 安装到正确目录后，按你所用客户端的惯例重启或刷新 Agent，使新 Skill 被索引。本 Skill 无需配置 API Key。
典型用法¶
SKILL.md 未定义独立 CLI 命令，用法即：在 Agent 已加载该 Skill 的前提下，提供姓名并让 Agent 按技能说明返回问候。
可复现的约定如下（与官方 SKILL.md 一致）：
| 项目 | 说明 |
|---|---|
| 入参 | name：字符串，表示要问候的对象姓名 |
| 行为 | 根据 name 生成问候语 |
| 出参 | 形如 hello 与 name 组合的问候结果 |
对话侧可以这样描述需求（示例意图，非额外官方文案）：
使用简易问候Skill，name=张三，按技能说明返回问候。
Agent 应读取 SKILL.md 后，按「hello + name」的约定组织回复。若未安装到正确 skills 目录，Agent 不会加载该说明，表现为「不知道有这个 Skill」。
适用场景与注意¶
适合谁
- 需要最小可运行样例，验证 SkillHub 搜索、下载、目录结构是否正常。
- 学习
SKILL.md如何写清入参、出参与一行功能描述。 - 在
requires_api_key=false的前提下，做无密钥环境的演示。
限制与注意
- 仅为演示，不提供生产级校验（如姓名格式、多语言、敏感词等）。
- 下载量与评分来自 SkillHub 页面统计，会随时间变化；写作时以页面为准。
skillhub install若先用完整 slug 失败，CLI 可能回退为namespace+ 内部 slug 方式下载；以 CLI 实际输出为准。- 不同 Agent 的 skills 路径不同，装错目录是最常见的「装了但用不了」原因。
结尾¶
简易问候Skill 把「姓名输入 → 问候输出」和 SkillHub 坐标、无 API Key 标签绑在一起，适合作为 dev-programming 入门的第一颗钉子。安装与路径以 https://skillhub.cn/install/skillhub.md 为准；技能详情与统计见 SkillHub 页面 https://www.skillhub.cn/skills/user_7bc7d8e4/my-first-greeting-skill 。
