Typefully Agent Skill
让 AI 代理直接通过 Typefully 起草、排期和管理 X、LinkedIn、Threads、Bluesky、Mastodon、Substack Notes 上的社媒帖子。
最小权限：allowed-tools 仅限本地脚本 Bash(./scripts/typefully.js)；发布为不可逆公开操作，明确要求用户确认；认证失败时明确禁止搜寻凭据或回退到网页抓取；--force-overwrite-comments 等破坏性标志要求显式确认且分开回合；API key 存储路径与数据流向透明；MIT 许可与明确来源。扣分点：发布确认依赖指令遵循而非技术强制，脚本文件在证据中截断无法完整审计全部外部调用。
CLI 零依赖、输出 JSON、错误消息带 hint 和 action，含 --use-default 歧义保护与明确的配额/认证失败反馈；仓库含 vitest 测试套件与 CI 工作流覆盖关键路径。扣分点：静态审查未执行，脚本在证据中截断，无法确认所有路径与异常输入行为；SKILL.md 称 Node 18+ 而 package. 要求 >=20，存在环境要求不一致。
触发条件明确（起草/排期/发布/查看社交媒体内容、丢弃 Typefully 草稿 URL），平台边界、非适用范围（x_article 独立、substack 单帖）与字符限制均清晰，附常见话术映射表。扣分点：核心功能完全依赖海外 Typefully API，对中国大陆网络的可达性未评估且无替代路径；无中文支持声明。
信息架构分层良好（SKILL.md 主文档 + references 按需加载），有 Keep a Changelog 格式的 CHANGELOG、新鲜度检查、更新路径、许可证、排障文档，维护责任（Typefully 官方仓库）明确。扣分点：skill 声称 Node 18+ 与 package. engines >=20 不一致，README 版本徽章 1.0.0 无对应语义化版本机制，脚本未完整可见。
目标（代理端起草/排期/管理社交帖子）明确，输出为结构化 JSON 且有大量可直接复制的命令示例与常见动作对照表，边际价值相对手动操作明显。扣分点：静态审查无法验证实际产出质量，效果最终依赖 Typefully API 行为与付费配额，无真实运行输出样例佐证。
仓库内含 CI 工作流（Node 20/22 矩阵运行 vitest）与针对 analytics、comments 等关键路径的承诺测试，claim 可在本地复现（npm test），changelog 与代码行为可交叉核对。扣分点：证据来自单一来源（官方仓库自测），无独立第三方验证，测试文件在证据中截断，未执行复现，静态置信度受限。
- 核心功能完全依赖 Typefully 海外 API（api.typefully.com），中国大陆网络可达性未验证，使用前请先测试连通性。
- 发布操作不可逆且公开，务必在代理明确获得用户确认后才执行 drafts:publish / --schedule now。
- SKILL.md 声称 Node.js 18+，但 package. 要求 >=20，请安装 Node 20+ 以避免潜在不兼容。
- API key 以明文存于环境变量或本地配置文件（.typefully/config.、~/.config/typefully/config.），注意不要提交到版本库。
- --force-overwrite-comments 会服务端解析并剥离未覆盖的评论线程且不可通过 API 恢复，仅在用户逐条确认后使用。
- 本评估为静态源码审查，未实际执行；置信度为低。
这个 Skill 能做什么，适合哪些场景？
这是 Typefully 官方的 Agent Skill，把社媒写作与排期工作流交给 AI 代理执行。它内置一个零依赖的 Node.js CLI 脚本，通过 Typefully API 管理草稿、排期、队列、标签、媒体和 X 数据分析。支持在多个平台用一份草稿同步发布，也支持为不同平台定制内容。适合已使用或愿意注册 Typefully（20 万以上创作者在用）的创作者和团队。
运行 skills/typefully/ 下的 scripts/typefully.js（Node.js 18+，无外部依赖）调用 Typefully API：创建和编辑草稿（drafts:create/update）、排期或立即发布（drafts:schedule/publish）、查看队列时间线（queue:get）、管理标签和媒体上传、查询 X 分析数据，以及解析用户粘贴的 Typefully 草稿 URL（?a=<social_set_id>&d=<draft_id>）直接获取草稿。所有命令输出 JSON；草稿可用 --scratchpad 附加内部笔记、--tags 打标签、--media 附图，链接预览卡在 LinkedIn/Threads/Bluesky/Substack 上自动生成并可用 --hide-link-preview 关闭。
- 独立创作者在 IDE 或终端里让 AI 代理起草推文和长推串，再决定是否排期发布。
- 社媒运营把同一条公告同时发到 X 和 LinkedIn（一份草稿多平台），或为各平台定制不同文案。
- 内容团队用「计划（plan）」模式把帖子放上日历但暂不发布，之后确认才真正排期。
- 市场人员查询某账号未来一段时间的空闲排期槽（queue:get）和发布配额（publishing_quota）。
- 用户粘贴一个 Typefully 草稿链接，让代理直接读取并继续编辑或处理草稿评论。
- 需要给帖子配图时先 media:upload 上传媒体再把 media_id 挂到草稿上。
这个 Skill 有哪些优点和局限？
- 官方维护，基于 Typefully API，一次安装覆盖 6 个平台。
- CLI 零依赖，仅需 Node.js 18+，所有命令输出 JSON 便于代理处理。
- 安全设计到位：发布需确认、有计划（plan）与排期（schedule）分离、明确的认证失败处理指引。
- 文档详尽，包含平台专属指南（X 分析、LinkedIn 提及、X Articles）和评论工作流参考。
- 必须拥有 Typefully 账号和 API key，且受其发布配额（publishing_quota）限制。
- 发布不可逆且公开，依赖代理正确遵守确认流程。
- frontmatter 使用 Claude Code 特有的 allowed-tools Bash(...) 语法，移植到其他客户端需小改。
- README 未提供自动化测试套件或各平台的实测证据；Substack Notes 不支持推串和视频媒体。
如何安装这个 Skill？
- 安装 skill：npx skills add typefully/agent-skills（兼容 Claude Code、Cursor、Windsurf 等）。Claude Code 也可用 /plugin marketplace add typefully/agent-skills 再 /plugin install typefully@typefully-skills；Cursor 可添加 GitHub 远程规则或手动把 skills/typefully/ 复制到 .cursor/skills/ 或 .claude/skills/。2. 在 https://typefully.com/?settings=api 获取 API key。3. 运行 ./scripts/typefully.js setup 配置 key 和默认 social set，或 export TYPEFULLY_API_KEY=your_key_here。需 Node.js 18+。
如何使用这个 Skill？
安装配置后直接对代理说："Draft a tweet about X"、"Create a LinkedIn post announcing [news]"、"Schedule my draft for tomorrow morning"、"Show my scheduled posts"。也可以粘贴 Typefully 草稿 URL 让代理直接拉取。发布前代理被要求先与你确认；创建草稿本身是安全操作。