Promote an open-source project across CN & EN channels — reads the repo, generates per-channel tailored copy, auto-submits issue/PR-type channels via gh, assists the rest.

Apache-2.0Auto-check passed

Install Promote

skills CLI
$ npx skills add ccplugins/awesome-claude-code-plugins --skill promote -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ccplugins/awesome-claude-code-plugins promote --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/yaohe/skills/promote .claude/skills/promote && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
promote
GitHub stars
967
Token cost
~665 tokens
SKILL.md length
181 words
Files
22
Skills in repo
68
Repo updated
First seen
Licence
Apache-2.0

At a glance

Promote an open-source project across CN & EN channels — reads the repo, generates per-channel tailored copy, auto-submits issue/PR-type channels via gh, assists the rest.

  • Works in 5 steps: 项目画像(必做,一切文案的源头) → 渠道选择 → 逐渠道生成定制稿 → …
  • The user wants to 宣传/推广/publicize/launch/submit their open-source project
  • SKILL.md covers 流程 and 红线(任何渠道通用)
  • Calls gh and git; reaches github.com

What it does

Promote is an agent skill from ccplugins/awesome-claude-code-plugins. Promote an open-source project across CN & EN channels — reads the repo, generates per-channel tailored copy, auto-submits issue/PR-type channels via gh, assists the rest. Use when the user wants to 宣传/推广/publicize/launch/submit their open-source project, or asks "帮我把这个项目投到阮一峰周刊/HelloGitHub/Show HN".

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files (for example `channels/_template.md`, `channels/appinn.md` and `channels/awesome-claude-code.md`).

The repository describes itself as: Awesome Claude Code plugins — a curated list of slash commands, subagents, MCP servers, and hooks for Claude Code. The licence is Apache-2.0.

When your agent uses it

  • The user wants to 宣传/推广/publicize/launch/submit their open-source project
  • Asks 帮我把这个项目投到阮一峰周刊/HelloGitHub/Show HN

Example prompts

  • “帮我把这个项目投到阮一峰周刊/HelloGitHub/Show HN”
  • “/promote”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 项目画像(必做,一切文案的源头)
  2. 渠道选择
  3. 逐渠道生成定制稿
  4. 分级执行
  5. 记录与复盘

What it can do on your machine

Read from SKILL.md and the folder at commit 5bd4f16. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Promote loads about 665 tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 181 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~665

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ccplugins/awesome-claude-code-plugins at commit 5bd4f16, republished under its Apache-2.0 licence (© ccplugins). 181 words, ~665 tokens.

Download SKILL.mdSave it as .claude/skills/promote/SKILL.md (or your agent's skills folder). This skill also uses 21 other files; get the full folder from GitHub.
name
promote
description
Promote an open-source project across CN & EN channels — reads the repo, generates per-channel tailored copy, auto-submits issue/PR-type channels via gh, assists the rest. Use when the user wants to 宣传/推广/publicize/launch/submit their open-source project, or asks "帮我把这个项目投到阮一峰周刊/HelloGitHub/Show HN".

promote — 开源项目一键合规宣传

核心原则:一键 ≠ 一键全发。渠道分三级自动化,越权发帖 = spam = 毁项目声誉。

流程

1. 项目画像(必做,一切文案的源头)

硬性前置闸门,任一不过就停下问用户,不进入后续步骤:

  • gh repo view <owner>/<repo> 必须成功(仓库公开可达)。本地路径则检查 git remote -v 有 GitHub remote 且已 push——稿件里的每个链接都必须真实可达,绝不写入死链
  • LICENSE 文件真实存在才可声明协议;README 说 MIT 但没有 LICENSE 文件 → 提醒用户先补

然后读 README 全文、描述、topics、star 数、最近活跃度,提炼:一句话定位(它是什么+替代/优于什么)、目标人群、3 个差异化亮点、演示素材(截图/GIF/demo URL)。

README 薄的判定(缺任一项即问用户补齐,不要编):① 一句话说清它是什么 ② 安装/使用方法 ③ 至少一个具体使用场景或示例。

2. 渠道选择

读 channels/ 下所有渠道文件的 frontmatter,按项目画像过滤:

  • 语言匹配:投 EN 渠道的条件 = 有英文 README(或 README 本身是英文);不满足时该渠道仍可列出但标注「需先补英文文档」,用户坚持投则明示风险后照办
  • 门槛匹配(如渠道要求 star 数 / 入门级 / dev-tool 类目)
  • 检查 PROMO-LOG.md(项目根目录):同一渠道 30 天内有任何记录(含 rejected)即跳过,冷却期从最新一条记录的日期起算

用 AskUserQuestion 列出推荐渠道(含自动化等级标注)让用户勾选;用户明确说"全投"则投所有合规匹配渠道。

3. 逐渠道生成定制稿

对每个选中渠道,读其 channels/<id>.md 全文,严格按其 format_spec 生成:

  • 禁止一稿多投:每渠道的标题风格、篇幅、语气、结构都不同(阮一峰自荐 ≠ Show HN 标题 ≠ V2EX 分享创造帖)
  • 文案原则:说人话、给事实(能做什么、和现有方案差在哪),禁营销腔/AI 味(震惊体、emoji 堆砌、buzzword)
  • 去 AI 味终审(必做):装了 deslop 类 skill 就调用它过一遍;没装则至少执行硬规则:禁破折号(——)、禁「不是…而是…」否定对比句、弯引号换直角引号「」、删段末总结句、删互联网黑话
  • 配图(必做):几乎所有渠道带图命中率都更高。优先级:① 项目已有截图/GIF 直接用 ② 真实运行录屏/截图(终端工具录一段 demo)③ 用可用的图像生成能力(imagegen/codex 出图/自绘 SVG 转 PNG)设计一张说明产品原理的宣传图。图片提交到项目仓库(如 docs/assets/)用 raw.githubusercontent.com URL 引用,别用外部图床。渠道规格标注图片必备的(如 ruanyf-weekly),无图不投
  • 全部稿件先写入 promo-drafts/<channel-id>.md 落盘;文件首行固定为 Title: <标题>(即使该渠道标题走 gh --title 参数不进 body),复盘时才对得上号
4. 分级执行

按渠道 frontmatter 的 automatable 字段:

  • full(issue/PR 型):先 gh auth status 确认已登录(未登录 → 让用户 gh auth login,停在这里)→ 展示最终稿 → 用户确认一次 → gh CLI 提交 → 记录返回 URL。失败就报错停,不换渠道兜底。
  • assisted(网页表单型):给出最终稿 + 提交 URL + 逐字段填写指引;有浏览器工具可代填但提交按钮由用户点。
  • manual-only(社区发帖型):只交稿件 + 建议发帖时间(见渠道文件)+ 红线提醒。任何情况下不代发。
5. 记录与复盘

把本次投递写入目标项目根目录 PROMO-LOG.md,固定表格 schema(机器可读,下次运行先读它):

markdown
| channel | date | draft | url | status |
|---|---|---|---|---|
| ruanyf-weekly | 2026-07-02 | promo-drafts/ruanyf-weekly.md | https://github.com/ruanyf/weekly/issues/NNN | submitted |
  • date 用 ISO(YYYY-MM-DD);status ∈ draft / submitted / published / rejected
  • 30 天冷却按该渠道最新一行的 date 计算,任何 status 都算

红线(任何渠道通用)

  • 不伪造用户身份发言;不注册马甲;不安排互赞互顶(HN voting ring 会连坐封域名)
  • 同一渠道 30 天内不重复投同一项目
  • 渠道规则与本 skill 冲突时,以渠道最新规则为准(提交前 spot-check 渠道规则页是否变化)

© ccplugins, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 21 other files in plugins/yaohe/skills/promote of ccplugins/awesome-claude-code-plugins.

  • SKILL.md
  • channels/_template.md
  • channels/appinn.md
  • channels/awesome-claude-code.md
  • channels/awesome-list.md
  • channels/dev-newsletters.md
  • channels/devto.md
  • channels/eleduck.md
  • channels/gitee-gvp.md
  • channels/githubdaily.md
  • channels/hellogithub.md
  • channels/indiehackers.md
  • channels/jike.md
  • channels/launch-boards.md
  • channels/lobsters.md
  • channels/oschina.md
  • channels/product-hunt.md
  • channels/reddit.md
  • channels/ruanyf-weekly.md
  • channels/show-hn.md
  • … and 2 more

Open the folder on GitHubat commit 5bd4f16

Compare with similar skills

Promote next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Promote compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Promote this skillccplugins/awesome-claude-code-plugins967—~665Automated safety check: PassApache-2.0
Counterparty Channel Disciplineaffaan-m/ECC274k—~2.3kAutomated safety check: PassMIT
Promotealirezarezvani/claude-skills28k2 repos~1.1kAutomated safety check: PassMIT
Trellis Channelmindfold-ai/Trellis15k4 repos~1.2kAutomated safety check: PassAGPL-3.0
Checkpoint Promotionwshobson/agents40k—~2kAutomated safety check: PassMIT
NanoClaw Channel Wiringnanocoai/nanoclaw31k—~2.6kAutomated safety check: NotesMIT

Similar skills

  • Per-channel strict prompts, mention gating, silent observation, and a communication autonomy policy for agents that sit in shared channels with external counterparties.

    274k GitHub stars~2.3k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Promote

    alirezarezvani/claude-skills

    Graduate a proven pattern from auto-memory (MEMORY.md) to CLAUDE.md or .claude/rules/ for permanent enforcement.

    28k GitHub starsUsed in 2 repos~1.1k tokens
    Agent WorkflowsAuto-check passed
  • Trellis Channel

    mindfold-ai/Trellis

    Use Trellis channel for live multi-agent collaboration, spawned workers, cross-agent review, progress inspection, forum channels, and channel log debugging.

    15k GitHub starsUsed in 4 repos~1.2k tokens
    DevelopmentAuto-check passed
  • Checkpoint Promotion

    wshobson/agents

    Gate fine-tuned checkpoints with drift budgets, paired comparison, and forgetting checks before promotion.

    40k GitHub stars~2k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • NanoClaw Channel Wiring

    nanocoai/nanoclaw

    Connects messaging channels to NanoClaw agent groups, sets isolation and engagement defaults, and reports which channels are wired, unwired or not configured.

    31k GitHub stars~2.6k tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • Lightning Channel Factories

    sickn33/agentic-awesome-skills

    Technical reference on Lightning Network channel factories, multi-party channels, LSP architectures, and Bitcoin Layer 2 scaling without soft forks.

    47k GitHub starsUsed in 2 repos~679 tokens
    Auto-check passed

More from ccplugins/awesome-claude-code-plugins

All 68 skills in this repo
  • AI Meeting

    ccplugins/awesome-claude-code-plugins

    Run structured AI meetings for plans, product ideas, technical designs, business decisions, feature proposals, and strategy choices.

    967 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check: notes
  • Fastapi App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new FastAPI backend with async SQLAlchemy 2.0, asyncpg, Alembic, Pydantic v2, and no deprecated APIs.

    967 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Flutter App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Flutter mobile app with clean architecture, Riverpod, FVM-pinned SDK, current packages, and no deprecated APIs.

    967 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Nextjs App

    ccplugins/awesome-claude-code-plugins

    Bootstrap a new Next.js (App Router, TypeScript) web app with current packages and no deprecated APIs.

    967 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check: notes
  • Dev Report

    ccplugins/awesome-claude-code-plugins

    Write up a coding session for a non-technical stakeholder — the context, what was built, and the engineering reasoning behind it — the way a senior engineer briefs a product manager who does not…

    967 GitHub stars~3.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Difesa Attacchi

    ccplugins/awesome-claude-code-plugins

    Aggiunge a un sito/app un agente di difesa che rileva e blocca richieste malevole (SQL injection, XSS, path traversal, brute force, bot) con rate limiting, blocklist IP e modalità lockdown che…

    967 GitHub stars~781 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Promote

What does Promote do?

Promote an open-source project across CN & EN channels — reads the repo, generates per-channel tailored copy, auto-submits issue/PR-type channels via gh, assists the rest. Promote is an agent skill from ccplugins/awesome-claude-code-plugins. Promote an open-source project across CN & EN channels — reads the repo, generates per-channel tailored copy, auto-submits issue/PR-type channels via gh, assists the rest.

When should I use Promote?

Promote fits situations like: the user wants to 宣传/推广/publicize/launch/submit their open-source project; asks 帮我把这个项目投到阮一峰周刊/HelloGitHub/Show HN.

How do I install Promote in Claude Code?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill promote -a claude-code`. Or copy the skill folder (plugins/yaohe/skills/promote in ccplugins/awesome-claude-code-plugins) into .claude/skills/promote in your project. Claude Code loads it when a task matches its description.

How do I install Promote in Codex?

Run `npx skills add ccplugins/awesome-claude-code-plugins --skill promote -a codex`. Or copy the skill folder (plugins/yaohe/skills/promote in ccplugins/awesome-claude-code-plugins) into .agents/skills/promote in your project. Codex loads it when a task matches its description.

Can I use Promote in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ccplugins/awesome-claude-code-plugins --skill promote -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/promote, .gemini/skills/promote, .github/skills/promote and .opencode/skills/promote in your project.

What does Promote need to run?

Going by SKILL.md and its folder, Promote needs the command-line tools its instructions call (gh and git).

Does Promote access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Promote safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Promote use?

Promote is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Promote use?

About 665 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Promote?

Skills that share tags, products or a category with Promote: Counterparty Channel Discipline (affaan-m/ECC, 274k stars), Promote (alirezarezvani/claude-skills, 28k stars), Trellis Channel (mindfold-ai/Trellis, 15k stars) and Checkpoint Promotion (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Promote?

ccplugins (a GitHub organization) maintains it in ccplugins/awesome-claude-code-plugins, which has 967 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on August 12, 2026.

Source: ccplugins/awesome-claude-code-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.