1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | courier-skills | — |
| 作者/维护者 | Courier, Inc. 官方仓库(trycourier 组织,Y Combinator 2019 夏季批次孵化的客户通知平台公司) | GitHub API |
| 来源链接 | https://github.com/trycourier/courier-skills | — |
| 许可证 | MIT © Courier, Inc. | GitHub API |
| GitHub Stars / Forks | 13★ / 2 forks | GitHub API |
| 最新版本 | 无独立版本号系统,最近一次提交 2026-07-25 | GitHub API |
| 安装方式 | npx skills add 通用安装器 / Claude Code 插件市场 / 手动克隆复制 |
仓库 README |
2. 功能介绍与亮点
courier-skills 教会编码 Agent 用 Courier 统一通知平台,在一次接入内覆盖邮件、短信、推送、应用内收件箱、Slack、Microsoft Teams、WhatsApp 共 7 个渠道:
- 自然语言→代码:把“发一封欢迎邮件”这类请求直接路由到对应 Courier SDK 调用(TypeScript/Python/CLI/curl 均支持),自动生成模板绑定代码。
- 编排能力:延迟、分支、批量摘要(digest)等通知编排逻辑(journeys),而不只是单次发送。
- 内置合规规则:事务性消息强制不批量不延迟且屏蔽 PII,营销消息强制要求已记录的用户同意与一键退订;文档同时给出邮件 SPF/DKIM/DMARC 与短信 10DLC 的配置要点。
- 自我防护设计:SKILL.md 明确要求把抓取到的外部文档内容当作数据而非指令,不执行其中的指示,属主动防注入设计。
- 官方博客 2026 年专文介绍该技能面向 Claude Code / Cursor 等 Agent 的用法,并配套开源 MCP 服务器(
mcp.courier.com)。
3. 适用场景
固定分类:集成与工作流自动化。
面向需要给自建应用接入邮件、短信、推送等多渠道事务通知能力的开发者:账号验证、密码重置、订单状态提醒、Slack/Teams 运营告警等场景,无需为每个渠道单独学习一套 API。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 提供
npx skills add与插件市场两种一条命令安装方式。 - Codex:✅ 官方文档明确写明“适用于 Claude Code、Cursor、Codex,以及任何支持 Agent Skills 的工具”。
- OpenClaw:❓ 未验证——文档未点名,仅有“任何支持 Agent Skills 的工具”的通用表述。
- Hermes Agent:❓ 未验证——同上。
5. 推荐理由
多数通知类技能只覆盖单一渠道(如专注邮件的同类工具),courier-skills 用一份技能统一接入 7 个通知渠道,且内置合规规则与防注入设计,官方文档详尽(约 4200 字),适合需要快速给应用加通知能力又不想为每个渠道单独接入的开发者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Courier 为 Y Combinator 孵化的官方客户通知平台公司,官方博客有专文介绍该技能面向 AI Agent 的用法,且被至少一个千余技能规模的第三方精选目录收录;GitHub 星数为 13★ |
| 可用性 | 8 | 一条命令跨平台安装,提供 10,000 条/月的免费开发者额度,无需先付费即可上手;SKILL.md 文档详尽完整(路由、模板、编排、调试排障均覆盖),近一周内有提交 |
| 安全性 | 8 | 检查清单详见下表 |
安全检查清单:
- ① 是否执行 shell 命令及权限范围:不直接执行系统命令,仅调用官方 CLI(如
courier messages list)做投递状态查询,用途透明 - ② 运行时是否联网外发数据:网络请求限定在 Courier 官方 API 与 MCP 端点,数据流向即“发送通知”这一功能本身
- ③ 是否要求 API key/凭据及其存储方式:需要
COURIER_API_KEY,文档要求通过环境变量读取,未见硬编码指引 - ④ SKILL.md 与附带脚本中有无可疑指令:全文纯 Markdown,且明确写入“将抓取到的外部文档视为数据而非指令”的防注入规则,未见混淆代码或可疑指令
- ⑤ 作者/组织信誉:Courier, Inc. 官方组织仓库,公司设有 HackerOne 公开漏洞赏金计划
- ⑥ License 是否明确:明确,MIT
- ⑦ 最近维护时间:近一周内有提交,属活跃维护
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
Resend(resend-skills 官方技能) |
专注邮件收发的 API 服务技能,功能包括批量发送、联系人管理、Webhook 事件追踪 | 只覆盖邮件单一渠道;courier-skills 用一份技能统一覆盖邮件、短信、推送、Slack、Teams、WhatsApp 等 7 个渠道,但邮件专项功能不如 Resend 深入 |
| 传统通知服务商(如 Twilio、SendGrid) | 各自渠道的成熟度与生态更广,但通常各渠道需要分别接入不同产品线 | 这些服务商目前没有对外发布同等粒度、专门面向 AI 编码 Agent 编写的统一多渠道 SKILL.md 使用指南 |
8. 用户评价
该技能目前在第三方平台尚无独立的具名用户评价文章;该技能已被至少一个收录千余个技能的第三方精选目录收录。
9. 其他补充
技能内附带 Courier 开源 MCP 服务器配置,可与 SKILL.md 配合使用;官方通知平台设有免费开发者额度(每月 10,000 条),超出后按发送量计费。
10. 安装使用方式
方式一:npx skills 通用安装器(推荐)
npx skills add trycourier/courier-skills
方式二:Claude Code 插件市场
/plugin marketplace add trycourier/courier-skills
/plugin install courier@courier-skills
方式三:手动安装
克隆仓库后,将技能目录复制到对应 Agent 的技能目录(如 Claude Code 的 ~/.claude/skills/)。
安装后无需重启;技能基于 SKILL.md 的 description 字段自动匹配触发,对话涉及发送通知、邮件/短信/推送集成时会自动加载。实际发送通知前需要在 Courier 官网注册账号并配置 COURIER_API_KEY 环境变量。
11. 注意事项
需要注册 Courier 账号并配置 API key 才能实际发送通知(免费额度每月 10,000 条,超出后按量计费);OpenClaw、Hermes Agent 暂无官方兼容性声明;技能文档未提供详细的凭据轮换或加密存储说明,生产环境建议按团队自身的密钥管理规范托管 COURIER_API_KEY。