huangrichao2020 pretty-skills-creator
创 — 让创建新 skill 像"填一个表"一样简单。
一句话
pretty-skills-creator = 创建 skill 的 5 步流水线。
ps create <name> --title "..." --description "..." --triggers a b c
→ 校验输入（name / title / description / triggers）
→ 生成 4 件套：xxx讲解.pdf.placeholder.md + manifest.yaml + SKILL.md + CHANGELOG.md
→ 装到本地 store（ps create 自动软链 5 agent）
→ 你填细节 + 准备图 → 跑 build_case_pdf.py → ps contribute → 提 PR
v3.20 改造
| 改动 | 原因 |
|---|---|
| ❌ 删 web.html | GitHub 不能预览 + PPT 时代已废 |
| ❌ 删 4 风格 HTML 模板 | 替代方案 = xxx讲解.pdf（GitHub 原生预览） |
| ❌ 删 --style 参数 | PPT 风格 picker 没了，PDF 是统一的 PIL 合并 |
| ✅ 加 xxx讲解.pdf.placeholder.md | 占位说明，告诉用户怎么跑 build_case_pdf.py |
必备参数
| 参数 | 校验 | 说明 |
|---|---|---|
--title |
≥ 5 字 | Skill 标题（中文 / 英文都行） |
--description |
≥ 100 字 | 一句话定位 + 详细说明（多行用 | 或 \n） |
--triggers |
≥ 3 个 | 触发词（用户自然语言） |
可选参数
| 参数 | 默认 | 说明 |
|---|---|---|
--contributor |
@anonymous |
你的标识 |
--tags |
（无） | 标签列表 |
--related |
（无） | 关联资源描述 |
--out-dir |
（必填） | 输出目录 |
--dry-run |
false |
只看输出，不写文件 |
--created |
2026-07-10 |
创建日期 YYYY-MM-DD |
完整流程
Step 1 · 写参数
ps create my-new-skill \
--title "我的新 skill 标题" \
--description "$(cat <<EOF
这是一个非常厉害的新 skill，解决了 XXX 问题。
它的核心思路是 YYY，用法是 ZZZ。
适用场景：AAA / BBB / CCC。
EOF
)" \
--triggers 触发词1 触发词2 触发词3 触发词4 \
--contributor "huangrichao2020" \
--tags "tag1" "tag2" \
--related "knowhub 路径 / 关联 skill" \
--out-dir "$HOME/.pretty-skills/store"
Step 2 · 校验
脚本会自动校验：
- ✅ name 合法（kebab-case，2-64 字符）
- ✅ title ≥ 5 字
- ✅ description ≥ 100 字
- ✅ triggers ≥ 3 个
Step 3 · 生成 4 件套
~/.pretty-skills/store/my-new-skill/
├── xxx讲解.pdf.placeholder.md # 怎么跑 build_case_pdf.py 的说明
├── manifest.yaml # 符合 pretty-skills manifest schema
├── SKILL.md # agent 加载入口
└── CHANGELOG.md # 变更记录
Step 4 · 准备图 + 跑 build_case_pdf.py
cd ~/.pretty-skills/store/my-new-skill
# 1. 准备 AI 出图（每页 1 张）
# 用 matrix / DALL-E / 即梦 任意工具
mkdir images
# 把 PNG 放到 images/slide-01.png / slide-02.png / ...
# 2. 跑 PIL 合并 → xxx讲解.pdf
python3 ../../tools/build_case_pdf.py "my-new-skill"
# 工具路径：pretty-skill/tools/build_case_pdf.py · v3.20 极简版（5 行核心）
Step 5 · 软链到 5 agent + 提 PR
ps add my-new-skill # 软链到 ~/.claude/ ~/.codex/ ~/.mavis/ ~/.cursor/ ~/.windsurf/
cd ~/.pretty-skills/store/my-new-skill
# 改 SKILL.md / manifest.yaml 补细节
ps contribute my-new-skill
ps contribute 会：
- fork 主项目
- clone fork → 创建分支
- copy 4 件套 → commit
- push 分支
- 提 PR with
auto-deploy-placeholder+skill-status:placeholder标签 - 主项目自动 merge + 部署 Git Pages
跟 pretty-skills（管）的关系
- pretty-skills（管）：管理所有 skill 的增删改查
- pretty-skills-creator（创）：创建新 skill 的入口
- 二者是父子：装好 pretty-skills 后，
ps create就调 pretty-skills-creator
缺能力时体验会差
- ❌ 没
python3→ps create整个不能用 - ❌ 没
gh/gh auth→ps contribute不能用 → 退路：手动用bash scripts/push.sh或网页提 PR - ❌ 没 matrix MCP / AI 出图 API → 跑不出真 PDF → 退路：用占位图跑骨架（check-3f 跑通 F3 必填）
跑 ps doctor 看完整体检。