这个 Skill 能做什么，适合哪些场景？
这是 Typefully 官方仓库提供的 Agent Skill，把 AI 代理接到 Typefully API 上，覆盖 X（Twitter）、LinkedIn、Threads、Bluesky、Mastodon 和 Substack Notes 六个平台。技能核心是一个零依赖的 Node.js 18+ 脚本，所有命令输出 JSON，便于代理解析。它支持创建草稿、串联线程、附加媒体和标签、排期、计划发布、查看队列与配额，以及处理用户粘贴的 Typefully 草稿 URL。采用 MIT 许可证，需自备 Typefully API 密钥。
- 通过 ./scripts/typefully.js 调用 Typefully API，创建、更新、列出和删除草稿
- 用 --schedule/--plan/--publish 排期或立即发布，next-free-slot 让 Typefully 自动选最佳时段
- 一次调用跨多平台发布同一内容（--platform x,linkedin 或 --all），线程用 --- 分行
- 上传媒体、管理标签、查看队列时间线和 publishing_quota 发布配额
- 解析粘贴的 Typefully 草稿 URL，直接映射到 drafts:get 命令
- 内容创作者想在自己的 IDE 或终端里让 AI 代理代管 X / LinkedIn 的日常发帖与排期
- 团队运营需要把同一条公告同时发到 X 和 LinkedIn，或为每个平台定制不同文案
- Substack 作者想在写作流程中顺手发一条 Substack Note
- 社交媒体管理员需要查看某账户本周的发布队列、空闲时段和配额余量
- 用户在对话中直接粘贴一个 Typefully 草稿链接，想让代理读取并修改该草稿
- 需要发布到 Instagram、TikTok、Facebook 等未支持平台的用户——技能只覆盖 X、LinkedIn、Threads、Bluesky、Mastodon 和 Substack Notes
- 没有 Typefully 账号或 API 密钥的人——认证失败时技能明确指示停止，不会兜底爬网页
- 希望全自动无人值守发布的场景——发布不可逆且公开，技能要求发布前确认
如何安装这个 Skill？
- 核心功能完全依赖 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 恢复，仅在用户逐条确认后使用。
- 本评估为静态源码审查，未实际执行；置信度为低。
- Shell / 命令行
- 网络访问
- 本地文件系统
Node.js 18+Typefully API key
通用 CLI 安装（适用于 Claude Code、Cursor、Windsurf 等）：
npx skills add typefully/agent-skillsClaude Code 作为插件市场安装：
/plugin marketplace add typefully/agent-skills
/plugin install typefully@typefully-skillsCursor 添加远程规则：在设置中 Rules & Command → Project Rules → Add Rule → Remote Rule (GitHub)，填入 https://github.com/typefully/agent-skills.git
手动安装：克隆仓库后把 skills/typefully/ 复制到项目的 .cursor/skills/ 或 .claude/skills/ 目录。
安装后需配置 API 密钥：
./scripts/typefully.js setup或设置环境变量：
export TYPEFULLY_API_KEY=your_key_here如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 帮我起草一条关于新版本发布的推文，排到明早九点
- 把这段文字同时发到 X 和 LinkedIn：
- 创建一个关于 AI 趋势的 Twitter 线程
- 看看我最近排期了哪些帖子，还有多少发布配额
技能由自然语言请求触发：当用户要求起草、排期、发布或检查推文/帖子/线程，或粘贴 Typefully 草稿 URL 时即应使用。所有操作走脚本命令，每个命令输出 JSON。常用流程：先用 setup 配好密钥和默认社交集（social set，即一个身份绑定的平台集合）；草稿默认发到默认社交集，单参数命令需加 --use-default。发布不可逆且公开，除非用户明确说"立即发布"，代理应先确认。计划草稿（--plan）排在日历上但不会自动发布，需用 drafts:schedule 确认。示例：
./scripts/typefully.js drafts:create --text "Launch day!" --platform x,linkedin --schedule next-free-slot
./scripts/typefully.js queue:get --start-date 2026-02-01 --end-date 2026-02-29
./scripts/typefully.js drafts:publish 456 --use-default这个 Skill 有哪些优点和局限？
- 官方维护，基于 Typefully API，支持六平台的完整草稿/排期/队列工作流
- 零依赖的 Node.js 脚本，命令输出 JSON，便于代理可靠解析
- 安全设计合理：发布前强制确认、认证失败即停止、不鼓励抓取网页兜底
- 有面向特定场景的参考文档（X 分析、LinkedIn 提及、X Article、评论流程）
- 强绑定 Typefully 账号和 API 密钥，不能独立使用
- 仅支持六个平台，Instagram/TikTok 等主流平台不在覆盖范围
- frontmatter 使用了 allowed-tools 权限语法，移植到其他平台需少量调整
- Substack Notes 不支持线程，且与媒体/链接卡片互斥等平台限制较多，容易踩坑
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Typefully 社媒发布技能 本页 | 64 · 推荐 | ★ 61 | 24 天前 | MIT |
| LinkedIn 职位搜索技能 | 55 · 谨慎使用 | ★ 47k | 17 天前 | MIT |
| Job Scraper — 本地运行的职位搜寻技能 | 54 · 谨慎使用 | ★ 47k | 17 天前 | MIT |
| X 文章发布助手 | 56 · 谨慎使用 | ★ 874 | 9 个月前 | MIT |
| Crowdcast 多智能体社会模拟 | 50 · 谨慎使用 | ★ 11 | 5 个月前 | — |
README 提到官方的 Typefully MCP Server（https://support.typefully.com/en/articles/13128440-typefully-mcp-server）可作为 Claude Code 中提供原生工具访问的替代方案；若追求更深度集成可考虑它，本技能则更适合任何支持 Agent Skills 的代理。
FollowSkills 如何评估这个 Skill？
最小权限：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 与代码行为可交叉核对。扣分点：证据来自单一来源（官方仓库自测），无独立第三方验证，测试文件在证据中截断，未执行复现，静态置信度受限。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →