用途:这是 getcargohq/gtm-skills 仓库内部作者使用的技能,用于创建、添加、脚手架或审阅新的 GTM 技能(SKILL.md 等)。它不随 npx skills add 安装给客户。规范副本放在 .agents/skills,供 Codex、Claude Code、Cursor 加载。
先阅读 CONTRIBUTING.md,它是校验器执行的契约。仓库根目录下一个文件夹对应一个客户技能,安装路径为 npx skills add getcargohq/gtm-skills/<name>。
技能分两类:one-off(metadata.source: one-off,单轮运行,含确切的 cargo-ai 命令与价格)和 pipeline(metadata.source: cookbook,部署常驻流程,客户侧只说 pipeline)。命名规则:one-off 用动词+宾语(如 enrich-company-data),pipeline 用常驻名词(如 tam-building),迁移类用 x-to-cargo;文件夹名与 frontmatter 的 name 一致。同一任务同时存在两种形态时需在 evals/routing.jsonl 中固定区分。
描述部分包含四块:一句话任务、触发短语(字面引号)、专有名词、以及“跳过条件”。含冒号加空格的 YAML 值必须加引号。
one-off 结构参照 enrich-company-data/SKILL.md:Setup、Do the job、Example、What it costs、Worth knowing 等;slug 与价格不可自创,需对照 getcargohq/cargo-skills playbook 并运行 node scripts/validate.ts。pipeline 结构需包含固定小标题(Honest banner、The outcome、Example、Put it in your project、What you will be asked、What you can change、What should not change、Done when、What it costs、Composes into)。
限制与约定:pipeline 不得硬编码 credits,需运行时获取;资源需自成一格并保持隔离;不得把单词连接器动作封装为工具;不得在示例前使用 examples/example.md;CDK 工作流体必须可编译;不得使用面向客户的 cookbook 字样;不得让新技能与现有 slug 重复或命名混淆。流程最后运行 build-catalog、generate-llms-txt、typecheck、validate、format:check 等命令,并更新注册文件;pipeline 需批准后才能宣称结果。资料未提供具体价格、平台或效果数据。