用途
publish-skill 用于向 acedergren/agentic-tools 仓库添加一个新技能，并使其可通过 npx skills add 安装。它把“创建技能”到“可被安装”的完整流程固化为一套可执行步骤，适合需要发布新技能到该仓库的开发者。
主要能力
该技能覆盖以下环节：
- 脚手架初始化：在技能目录下用
npx skills init <skill-name>生成skills/<skill-name>/SKILL.md。 - 编写技能：编辑 SKILL.md，frontmatter 必须且只能有两个字段——
name和description。 - 提交前评估：对新技能运行
/skill-judge，目标分数 ≥ 84/120（C 级）后再推送。 - 提交与推送：用 git 添加、提交并推送到 main 分支。
- 验证可安装性：用
npx skills add acedergren/agentic-tools@<skill-name> -g -y验证。
使用方式
1. 脚手架
cd ~/Projects/agentic-tools/skills
npx skills init <skill-name>
# Creates skills/<skill-name>/SKILL.md
2. 编写技能
编辑 skills/<skill-name>/SKILL.md。frontmatter 必须恰好包含两个字段：
---
name: skill-name-with-hyphens # lowercase, letters/numbers/hyphens, ≤64 chars
description: "Use when [trigger conditions]. [WHAT]. Keywords: ..."
---
description 规则——三项均为必需：
- WHAT：它做什么？
- WHEN：以 “Use when...” 开头
- KEYWORDS：末尾放置可搜索词
3. 提交前评估
对新技能运行 /skill-judge。推送前目标 ≥ 84/120（C 级）。
关键检查项：
- 不写 Claude 已知的 “What is X” 解释
- 有带原因的显式 NEVER 清单
- SKILL.md < 300 行（重引用内容 → 放入 references/ 子目录）
- 无多余 frontmatter 字段（license、metadata、version）
4. 提交并推送
git add skills/<skill-name>/
git commit -m "feat(skills): add <skill-name> skill"
git push origin main
5. 验证可安装
npx skills add acedergren/agentic-tools@<skill-name> -g -y
如果找不到该技能，检查：
- 目录名与 frontmatter 中的 name 字段一致
- SKILL.md 位于
skills/<skill-name>/SKILL.md（未嵌套更深）
本仓库的安装命令
# Single skill
npx skills add acedergren/agentic-tools@<skill-name> -g
# All skills
npx skills add acedergren/agentic-tools --all -g -y
# List available without installing
npx skills add acedergren/agentic-tools -l
适用场景
- 需要向 acedergren/agentic-tools 仓库新增技能并让其可被
npx skills add安装。 - 需要确保技能描述符合 WHAT/WHEN/KEYWORDS 规范，从而能被正确触发。
- 需要在提交前用
/skill-judge做质量把关。
限制与 NEVER 清单
- 未先运行
/skill-judge绝不推送技能——评估不通过的技能无法正确触发，因为其 description 缺少 WHAT/WHEN/KEYWORDS。 - 绝不使用多余 frontmatter 字段——只有 name 和 description 有效；license、metadata、version 会在某些 agent 中导致解析错误。
- 绝不把 “When to use” 只写在正文——agent 只读取 description 来决定是否加载；正文内容在触发时不可见。
- 绝不用空格或特殊字符命名技能——
my skill!会破坏安装；应使用my-skill。
关于该技能的收费、价格、平台支持范围等更多信息，资料暂未提供。