SuperAPI AI 工具集

social-preview

营销与增长

查看项目

更新于 10-16 01:10

技能介绍

用途:为 GitHub 仓库生成 Open Graph 社交预览图(1280x640px),即仓库在 Twitter、LinkedIn、Slack、Discord 等平台被分享时显示的预览图。适用于新公开仓库分享前、项目改名换色换 logo、重大发布或营销推广前,以及审计现有仓库缺失或过期的预览图。

安装:claude skill install social-preview

用法: /social-preview generate [repo-path] 从仓库上下文创建 OG 图 /social-preview audit [repo-path] 检查是否已设置预览图、尺寸是否正确 省略 repo-path 时默认当前工作目录。

生成流程:解析命令并校验目录含 .git;扫描仓库获取项目名、描述、主语言、logo、git remote、现有预览状态;选择模板(dark 推荐、light、minimal,可沿用品牌色);生成独立 HTML(1280x640,仅系统字体、无外部依赖);渲染为 PNG(浏览器截图、Puppeteer/Playwright 或云端渲染);通过 GitHub 设置页或 API 设置预览图;用 Twitter Card Validator、Facebook Sharing Debugger、LinkedIn Post Inspector、Open Graph Debugger 验证。

审计流程:校验 git 仓库与 remote,用 gh api repos/{owner}/{repo} --jq '.description, .homepage' 获取状态,报告是否已设自定义预览、描述与主页 URL,并给出建议。

设计原则:缩略图尺寸可读、高对比度(至少 4.5:1)、无小字、2:1 比例、无外部依赖、文字精简(项目名+一行标语)、按实际分享尺寸 400x200 测试。输出 PNG 且小于 1MB。

限制:GitHub REST API 不直接支持 base64 上传社交预览图,UI 方式最可靠;避免外部字体 CDN、需联网的图片、小于 24px 的文字、复杂背景、超过 3 种颜色、圆角复杂形状及完整 URL。