guizang-social-card-skill

环境要求

• Node.js 环境（需可用 npx 命令）
• Claude Code / Codex 等可执行 shell 的 Agent 环境
• 已安装 git（手动克隆与后续更新时需要）
• 网络可访问 GitHub 仓库

安装与启动步骤

1. 1一行命令安装

   README 推荐方式，用 npx skills 直接从 GitHub 仓库添加该 Skill，安装完即可在 Agent 中调用。

   npx skills add https://github.com/op7418/guizang-social-card-skill --skill guizang-social-card-skill

   复制

2. 2手动克隆安装

   如果不想用 npx，可把仓库克隆到 Claude 的 skills 目录，这是 README 给出的标准安装路径。

   git clone https://github.com/op7418/guizang-social-card-skill ~/.claude/skills/guizang-social-card-skill

   复制

3. 3检查安装文件

   确认目录下存在 SKILL.md、assets/、references/，三者齐全说明安装完整。

   ls ~/.claude/skills/guizang-social-card-skill

   复制

4. 4后续更新技能

   已安装过想升级时进入目录执行 git pull，拉取最新版本后即可使用新特性。

   cd ~/.claude/skills/guizang-social-card-skill && git pull

   复制

5. 5向 Agent 提需求

   用自然语言描述平台、风格、张数与主题色，Agent 会按 Intake 到 Iterate 的 7 步工作流执行。

6. 6渲染导出 PNG

   Agent 会拷贝种子模板、替换 <!-- POSTERS_HERE --> 占位后执行渲染脚本，产出可发布图片。

   node render.mjs

   复制

关键配置

如何确认成功

执行 ls ~/.claude/skills/guizang-social-card-skill 能看到 SKILL.md、assets/、references/ 即安装成功。

常见问题

注意事项

• 主题色只能从 10 套预设中挑选，禁止自定义 hex 值。
• 网络取图会落到本地并写入 SOURCES.md，是否标注来源由你决定。
• 交付阶段默认不自动核查，需要你主动要求 Agent 运行 validator。
• 小红书与公众号对 Live Photo 时长限制不同（5s / 3s），发布前需按平台调整。