agentsclimarketplace
Sign in

Promote github

Skill atompilot/claude-skill-promote/skills/promote-github

GitHub 开源项目推广工作流。README 审计与优化、内容营销生成（博文/帖文/Thread）、 多渠道发布策略、社区建设检查、增长指标追踪。 触发词：推广、promote、github 推广、宣传、marketing、star、README 优化、 写博文、发帖、开源推广、launch、growth、增长。From its SKILL.md

Install
npx -y skills add atompilot/claude-skill-promote --skill promote-github

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

11.0 KB, as published. Nobody here has run it

Promote GitHub — 开源项目推广 Skill

系统化推广你的 GitHub 开源项目。

触发方式

/promote-github                 # 完整推广诊断（首次使用推荐）
/promote-github readme          # README 质量审计 + 优化
/promote-github blog [渠道]     # 生成推广博文（dev.to / 掘金 / Medium）
/promote-github post [平台]     # 生成社交帖文（Twitter / HN / V2EX / Reddit）
/promote-github launch          # 生成首发 checklist
/promote-github status          # 查看增长指标

ARGUMENTS: $ARGUMENTS

Phase 0: 项目感知

每次执行的第一步，自动收集项目信息：

# 1. 仓库元数据
gh repo view --json name,description,stargazerCount,forkCount,createdAt,licenseInfo,repositoryTopics,homepageUrl

# 2. README
cat README.md

# 3. 技术栈
ls package.json go.mod Cargo.toml setup.py pyproject.toml *.xcodeproj 2>/dev/null

# 4. 项目年龄和活跃度
git log --oneline | head -20
git log --since="30 days ago" --oneline | wc -l

项目画像

📊 项目画像

仓库：{owner}/{repo}
描述：{description}
技术栈：{language} + {framework}
Stars：{stargazerCount} | Forks：{forkCount}
创建时间：{createdAt} | 最近 30 天提交：{commitCount}
License：{license}
Topics：{topics}

推广阶段：{阶段}

推广阶段判断

Stars项目年龄阶段策略侧重
0-50< 1 月🚀 冷启动README 打磨 + 首发渠道
0-50> 1 月🧊 沉默期找到产品问题或推广渠道问题
50-500任意📈 增长期内容营销 + 社区建设
500+任意🌟 成熟期生态集成 + 演讲 + 贡献者培养

命令：/promote-github（完整诊断）

Step 1: 展示项目画像

Step 2: README 快速体检

按 README 审计清单打分（详见 readme 子命令）。

Step 3: 渠道推荐

根据项目技术栈和生态推荐渠道：

技术栈/生态核心社区Awesome ListSubreddit
Claude Code / AI AgentAnthropic Discord, AI Twitterawesome-claude-coder/ClaudeAI
React / Next.jsReact Discord, Vercel Discussionsawesome-reactr/reactjs
Python / MLPyData, MLOps Communityawesome-python, awesome-mlr/MachineLearning
GoGophers Slackawesome-gor/golang
RustRust Users Forumawesome-rustr/rust
Swift / iOSSwift Forumsawesome-swiftr/iOSProgramming
DevOps / InfraCNCF Slackawesome-selfhostedr/selfhosted
CLI 工具Hacker News (Show HN)awesome-cli-appsr/commandline
通用开发工具dev.to, Hacker News—r/programming

不在表中的技术栈：

  1. 检查依赖文件识别核心框架
  2. 搜索 awesome-{framework} 是否存在
  3. 搜索框架官方 Discord / Slack / Forum

Step 4: 生成行动计划

📋 推广行动计划（{阶段}）

🔴 本周必做：
  1. [ ] {具体动作 + 预期效果}
  2. [ ] {具体动作 + 预期效果}

🟡 下周推荐：
  3. [ ] {具体动作}
  4. [ ] {具体动作}

🟢 持续进行：
  5. [ ] {具体动作}

💡 执行任何一项，直接告诉我，我帮你生成内容。

命令：/promote-github readme

逐项检查 README.md，每项 ✅ / ⚠️ / ❌ 评级。

必备元素（缺失 = ❌）

#检查项检查方式为什么重要
1首屏价值主张README 前 5 行内有一句话说明路人 10 秒决定去留
2安装/Quick Start有 install / setup / getting started 章节30 秒跑通 = 转化
3LICENSELICENSE 文件存在企业用户硬性要求

强烈推荐（缺失 = ⚠️）

#检查项检查方式为什么重要
4视觉演示引用了 .gif / .png / .mp4 / 图片 URL视觉比文字有效 10x
5Badges有 ![ 开头的 badge 图片建立信任
6对比表有 With/Without 或 vs 对比强化差异价值
7使用示例有代码块展示核心用法让用户"看到"而非"想象"
8目标用户说明了"谁应该用这个"帮读者自我筛选

加分项（缺失 = 灰色）

#检查项检查方式
9Contributing 指南有 CONTRIBUTING.md 或相关章节
10Changelog有 CHANGELOG.md
11多语言有中英文双版本
12GitHub Descriptiongh repo view --json description 精准
13Topics/Tagsgh repo view --json repositoryTopics 充分

审计输出

📋 README 审计报告

得分：{X}/13

必备元素：
  1. ✅ 首屏价值主张 — "{描述}"
  2. ❌ 安装/Quick Start — 未找到
  3. ✅ LICENSE — MIT

强烈推荐：
  4. ❌ 视觉演示 — 没有 GIF/截图
  ...

🔧 修复建议（按优先级）：
1. [❌ 安装/Quick Start] 建议添加：
   ```bash
   {从依赖文件推断}
  1. [❌ 视觉演示] 建议：
    • 录制终端 GIF：brew install vhs && vhs record
    • 或截图核心界面

要修哪些？（编号 / 全部 / 跳过）


用户确认后直接编辑 README.md。

---

## 命令：`/promote-github blog [渠道]`

### 支持渠道

| 渠道 | 语言 | 风格 | 长度 |
|------|------|------|------|
| `dev.to` | 英文 | 技术教程风 | 800-1500 词 |
| `medium` | 英文 | 叙事 + 技术 | 1000-2000 词 |
| `juejin` | 中文 | 技术实战 | 1500-3000 字 |
| `v2ex` | 中文 | 口语化 | 500-1000 字 |
| `zhihu` | 中文 | 深度分析 | 1500-3000 字 |

未指定渠道时询问用户选择。

### 生成流程

**Step 1: 选角度**

| 角度 | 适用场景 | 标题模板 |
|------|---------|---------|
| 痛点驱动 | 解决明确痛点 | "{痛点} — Here's How I Fixed It" |
| 故事驱动 | 有趣的创作背景 | "Why I Built {项目名}" |
| 教程驱动 | 明确使用场景 | "How to {动作} with {项目名}" |
| 对比驱动 | 有明确竞品 | "{项目名} vs {竞品}" |
| 趋势驱动 | 踩中技术趋势 | "{趋势} Is Changing {领域}" |

**Step 2: 生成大纲** → 用户确认

**Step 3: 生成全文**

**写作规则**：
- 标题痛点导向，不要产品名导向
- 开头用真实场景，不要"在这篇文章中"
- 代码块可直接复制运行
- 不用 "amazing" "revolutionary" 等营销词
- CTA 放末尾，一句话

生成后写入 `docs/promote/blog/{渠道}-{日期}.md`。

---

## 命令：`/promote-github post [平台]`

### 各平台模板

#### Twitter / X Thread

1/N {场景引出问题} 2/N {展示痛苦} 3/N {引出方案} 📎 建议配图 4/N {快速上手命令} 5/N {CTA + GitHub 链接}


#### Hacker News

标题：Show HN: {项目名} – {一句话（≤80 字）} 正文：2-3 段，覆盖问题、方案、差异化

⚠️ 工作日美东 8-10 AM 发 | 不用营销词 | 准备回答技术问题


#### V2EX

标题：口语化（"做了个工具解决 xxx 问题"） 节点：分享创造 / 程序员 / 开源软件 正文：故事化叙述 + 截图 + GitHub 链接

⚠️ 口语化真诚 | 认真回复评论


#### Reddit

Subreddit：{根据技术栈推荐} 正文：先说问题再引项目 | 不要 "I built" 开头 | 先给价值


#### Product Hunt

Tagline + Description + Makers Comment


生成后写入 `docs/promote/posts/{平台}-{日期}.md`。

---

## 命令：`/promote-github launch`

🚀 首发 Checklist

📦 发布前：

  • README 审计 ≥ 10/13
  • GitHub description 精准
  • Topics ≥ 3 个
  • LICENSE 存在
  • 有 GIF/截图
  • Quick Start 30 秒跑通
  • 无硬编码密钥 / debug 输出

📣 首发日（选工作日）：

  • HN Show HN（美东 8-10 AM）
  • Reddit（对应 subreddit）
  • Twitter/X Thread
  • V2EX + 掘金
  • 相关项目 Discussions/Discord

📈 首发后 48h：

  • 回复所有评论
  • 回复所有 Issues
  • PR 到 Awesome Lists
  • 记录各渠道数据

---

## 命令：`/promote-github status`

```bash
gh repo view --json stargazerCount,forkCount,watchers,openIssues
gh api repos/{owner}/{repo}/traffic/views
gh api repos/{owner}/{repo}/traffic/clones
gh api repos/{owner}/{repo}/traffic/popular/referrers

输出：

📊 {项目名} 增长报告

⭐ Stars: {count} ({趋势})
🍴 Forks: {count}
📈 14 天流量：Views {count} | Clones {count}
🔗 Top 来源：{referrer list}

💡 建议：{1-2 条具体建议}

社区建设检查

  • CONTRIBUTING.md 存在
  • 有 good first issue 标签
  • Issue/PR 模板已配置
  • 回复 issue 平均 < 24h
  • 被 awesome list 收录

避坑指南

陷阱为什么替代方案
刷 starGitHub 检测 + 虚假 star 无价值靠内容和社区自然增长
营销词技术社区反感用事实和数据说话
冷启动硬推社区反感广告先贡献价值，再自然提及
只发一次推广是持续行为按节奏持续输出
一稿多投各平台风格不同按平台定制内容
忽略反馈不回复 = 无人维护48h 内回复所有评论

内容存储

docs/promote/
├── blog/                    # 博文草稿
│   ├── devto-2026-03-11.md
│   └── juejin-2026-03-11.md
├── posts/                   # 社交帖文
│   ├── twitter-2026-03-11.md
│   └── hn-2026-03-11.md
└── status-log.md            # 增长记录

首次运行时自动创建目录：mkdir -p docs/promote/{blog,posts}

自我进化协议

本 skill 在日常使用中自动进化。无需显式触发。

何时提议进化

信号示例行为
用户发现新有效渠道"在 {社区} 发帖效果很好"提议加入渠道矩阵
渠道规则变化"HN 不允许 Show HN 带 emoji"提议更新对应模板
用户纠正内容风格"V2EX 不要这么正式"提议调整风格指南
新平台涌现用户提到 Bluesky / 小红书提议新增平台模板

确认流程

🔔 我注意到一个可以写入 skill 的改进：

{描述}

建议写入：promote-github/SKILL.md 的「{章节名}」
内容预览：
---
{内容}
---

是否写入？(Y/N)

写入后 version patch +1。

Size Guard

守护线：≤ 15KB

  • 12KB → 写入前警告

  • 15KB → 必须先压缩再写入

侧重点

新渠道发现、推广效果反馈、内容模板优化、平台规则变更。

Keep looking

Skills are one crate of 628,853. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.