promote

Batch promote open source projects to tech weeklies and communities.

SKILL.md

GitHub

OSS Promoter Skill

Batch promote open source projects to tech weeklies and communities.

What this skill does

  1. Search for weeklies: Use WebSearch to find new tech weeklies that accept submissions
  2. Extract project info: Use gh to get repo description, README, stars, etc.
  3. Generate submissions: Create tailored issue content for each weekly
  4. Batch submit: Use gh issue create or gh issue comment to submit

Usage

When the user wants to promote an open source project:

  1. First, ask for the GitHub repo URL if not provided
  2. Load the weeklies config from ${CLAUDE_PLUGIN_ROOT}/config/weeklies.json
  3. Use gh repo view <repo> --json name,description,url,stargazerCount,readme to get project info
  4. For each enabled weekly in the config:
    • Generate title using the title_template
    • Generate body using the project info
    • If type is "issue": use gh issue create --repo <weekly_repo> --title "<title>" --body "<body>"
    • If type is "comment": use gh issue comment <issue_number> --repo <weekly_repo> --body "<body>"
  5. Track submissions and report results

Commands

  • /oss-promoter:promote <repo-url> - Promote a project to all enabled weeklies
  • /oss-promoter:search - Search for new weeklies to add to config
  • /oss-promoter:list - List all configured weeklies and their status

Submission Template

For Chinese weeklies, use this template:

## 项目介绍

[{name}]({url}) - {description}

## 核心功能

{features_from_readme}

## 使用示例

{usage_example}

## 链接

- GitHub: {url}
- Stars: {stars}

Tools Available

  • WebSearch - Search for new weeklies
  • Bash with gh - GitHub CLI for repo info and issue creation
  • Read - Read config files

Important Notes

  • Always check if an issue already exists before creating a new one
  • Respect rate limits - add delays between submissions if needed
  • Some weeklies require specific formats - check their README first
  • Set enabled: false for weeklies that are language/topic specific and don't match the project