为 AI 代理配置营销与创作者自动化技能时用：克隆并安装…

当你要让 Codex、Claude Code、Cursor 等 AI 代理快速具备 YouTube 研究、Readwise 搜索、图表生成、视频制作、AI 媒体生成、品牌合作调研和 Buffer 排期发布能力时，使用并定制该技能集合。

适用场景

解决思路

1. 运行 `git clone https://github.com/rbrown101010/codex-marketing-skills.git`，再运行 `cd codex-marketing-skills` 克隆并进入仓库。
2. 把技能安装到 Codex：运行 `mkdir -p "$HOME/.codex/skills"`，再运行 `cp -R skills/youtube-researcher "$HOME/.codex/skills/"`；替换 `skills/youtube-researcher` 可安装其他技能。
3. 把技能安装到 Claude Code：运行 `cp -R skills/youtube-researcher "$HOME/.claude/skills/"`，按需调整路径。
4. 配置 YouTube Researcher 密钥：设置 `export SUPADATA_API_KEY="your_key_here"` 和 `export SERPAPI_KEY="your_key_here"`。
5. 配置 Buffer Publisher 密钥：设置 `export BUFFER_API_KEY="your_key_here"`。
6. 配置 Gen Media 密钥：设置 `export FAL_KEY="your_key_here"`。
7. 用环境变量或系统 secret manager 保存密钥，绝不把 secrets 提交到仓库；参考 `docs/requirements.md` 获取完整设置清单。
8. YouTube Researcher：用 `SERPAPI_KEY` 请求 `https://serpapi.com/search`，参数为 `engine=youtube`、`search_query=<query> site:youtube.com/c/<channel_id>`、`api_key=SERPAPI_KEY`，搜索指定频道视频。
9. YouTube Researcher：用 `SUPADATA_API_KEY` 请求 `https://api.supadata.ai/v1/youtube/transcript/<video_id>`，带 `Authorization: Bearer <SUPADATA_API_KEY>` 获取视频 transcript。
10. 分析创作者 hook：取 transcript 中 `start < 30` 的前 30 秒文本，打印视频标题与 hook。
11. Readwise CLI Control：安装并认证 Readwise CLI 后，运行 `readwise search "marketing frameworks"` 搜索 highlights。
12. 运行 `readwise export --book "Building a Second Brain" --format markdown` 导出指定书籍 highlights。
13. 运行 `readwise reader list --limit 20` 列出最近 Reader 保存内容。
14. Readwise Python 集成：用 `subprocess.run(["readwise", "search", query, "--format", "json"], capture_output=True, text=True)` 调 Readwise，再用 `json.loads(result.stdout)` 解析，输出 `h['text']` 和 `h['title']`。
15. Excalidraw Diagrams：安装 `excalidraw-cli` 后，运行 `excalidraw-cli create diagram.json --output funnel.excalidraw` 从 JSON 定义生成图表。
16. 运行 `excalidraw-cli export funnel.excalidraw --format png --output funnel.png` 导出 PNG。
17. Excalidraw Python：构造包含 `type=excalidraw`、`version=2`、`source=https://excalidraw.com`、`elements` 的 JSON，写入 `temp_diagram.json`，再运行 `excalidraw-cli create temp_diagram.json --output output_path`。
18. 创建营销漏斗示例：用 `rectangle` 元素定义 `Awareness`、`Interest`、`Purchase`，坐标/宽高按示例设置，调用 `create_excalidraw_diagram(elements, "marketing_funnel.excalidraw")`。
19. 复制 `skills/paper-mcp` 和 `skills/paper-deck-style` 到 agent 技能目录，用于编辑 Paper boards 和创建 polished decks；需 Paper 桌面应用与本地 MCP server。
20. Paper MCP：启动 Paper 桌面应用和本地 MCP server，使用 `MCP_SERVER = "http://localhost:8080"`。
21. 通过 `POST {MCP_SERVER}/boards/{board_id}/cards`，JSON 含 `title`、`content`，创建 Paper 卡片。
22. 通过 `GET {MCP_SERVER}/boards/{board_id}/cards` 获取 board 所有卡片。
23. 创建 campaign planning board 示例：设置 `board_id = "campaign-q4-2026"`，创建 `Audience` 卡片 `Target: SaaS founders, 30-45, technical background` 和 `Channels` 卡片 `LinkedIn, YouTube, email newsletter`。
24. Remotion：具备 Node.js 和 Remotion CLI 后，运行 `npx remotion render src/index.ts LaunchVideo output.mp4` 渲染 composition。
25. 运行 `npx remotion preview src/index.ts` 在浏览器预览。
26. Remotion React：在 `src/LaunchVideo.jsx` 中使用 `useCurrentFrame`、`useVideoConfig`、`interpolate`，根据 frame 在 `[0, 30]` 内将 opacity 从 0 插值到 1，设置 `extrapolateRight: 'clamp'`，渲染标题 `New Product Launch`。
27. HyperFrames GSAP：在 `plugin-workflows/hyperframes-gsap/animate.js` 中导入 gsap，定义 `animateCTA(element)`，用 `gsap.timeline().from(element, { scale: 0.8, opacity: 0, duration: 0.5 }).to(element, { scale: 1.05, duration: 0.3, yoyo: true, repeat: 1 })`。
28. Gen Media：安装 `genmedia` CLI 并设置 `FAL_KEY` 后，运行 `genmedia list` 列出可用模型。
29. 运行 `genmedia run fal-ai/flux/schnell --prompt "product shot of a coffee mug on a desk" --output mug.png` 生成图片。
30. 运行 `genmedia run fal-ai/ltx-video --prompt "camera pan over a modern office" --duration 5 --output office.mp4` 生成视频。
31. Gen Media Python：用 `subprocess.run(["genmedia", "run", model, "--prompt", prompt, "--output", output, "--api-key", FAL_KEY])` 包装生成图片；示例 prompt 为 `bold text 'Marketing Automation' over abstract tech background`，输出 `thumbnail.png`。
32. Brand Deal Researcher：使用 Gmail API 读取 `token.json`，scope 为 `https://www.googleapis.com/auth/gmail.readonly`，构建 `gmail` `v1` service。
33. 查询未读赞助邮件：设置 `query = "is:unread (subject:sponsorship OR subject:partnership OR subject:collaboration)"`，调用 `service.users().messages().list(userId='me', q=query).execute()`。
34. 对每条 message 调用 `service.users().messages().get(userId='me', id=msg['id']).execute()`，提取 `Subject` header 和 `snippet`，返回并打印 deals。
35. Buffer Publisher：设置 `BUFFER_API_KEY`，定义 `BASE_URL = "https://api.bufferapp.com/1"`。
36. 调用 `GET {BASE_URL}/profiles.json`，参数 `access_token=BUFFER_API_KEY`，列出所有已连接社交 profile。
37. 调用 `POST {BASE_URL}/updates/create.json`，数据包含 `profile_ids[]`、`text`、`access_token`，可选 `scheduled_at`，创建/排队/排期 Buffer post。
38. 排期 LinkedIn 示例：从 profiles 中找到 `p["service"] == "linkedin"`，用 `create_post(linkedin_profile["id"], "Excited to share our new marketing automation toolkit! 🚀", scheduled_at="2026-05-25T10:00:00Z")` 排期。
39. 链式技能：先 `search_readwise("content marketing")`，再 `search_youtube_channel("competitor", "content strategy")`，再 `create_excalidraw_diagram(strategy_elements, "strategy.excalidraw")`，最后对每个 content idea 调 `create_post(linkedin_profile["id"], idea["text"])`。
40. 错误处理：定义 `ensure_env_var(name)`，用 `os.getenv(name)` 检查缺失环境变量；缺失时向 `sys.stderr` 打印 `Error: <name> environment variable not set.` 并 `sys.exit(1)`；对 `BUFFER_API_KEY` 调用它。
41. 限流：处理 `video_list` 时，每个视频获取 transcript 后调用 `time.sleep(1)`，避免触发 API rate limits。
42. 排障 API key not found：运行 `echo $BUFFER_API_KEY` 确认输出；如未设置，运行 `export BUFFER_API_KEY="your_key_here"`。
43. 排障 Skill not loaded by agent：运行 `ls "$HOME/.codex/skills/youtube-researcher"` 确认显示 `SKILL.md` 和相关文件。
44. 排障 CLI permission denied：运行 `which excalidraw-cli` 检查；如缺失，运行 `npm install -g excalidraw-cli`。
45. 排障 MCP server 无响应：运行 `curl http://localhost:8080/health`，应返回 `{"status": "ok"}`。
46. 排障 Readwise CLI 认证失败：运行 `readwise logout` 再运行 `readwise login` 重新认证。
47. 进一步文档：查看 `docs/requirements.md`、各 `skills/` 子文件夹下的 README、`plugin-workflows/` 中的插件工作流说明。
48. 贡献新技能：在 `skills/` 创建清晰命名文件夹；包含带 requirements 和 examples 的 README；在主仓库表格添加条目；绝不提交 secrets 或 API keys。

适用边界 · 注意事项

• 没有相应 API key、CLI、Paper 桌面应用、MCP server、Gmail/Buffer 账号或 fal.ai/SerpApi/Supadata 等第三方服务时，不要使用对应技能。
• 无法安全保存环境变量或 secret manager 中的密钥、或可能把 secrets 提交到仓库时，不要使用。
• 只需要通用开发工作流、不涉及营销/创作者内容研究、图表、视频或社媒发布时，不适用。