OSS Promoter

Batch promote open source projects to tech weeklies and communities using automated submissions.

What this skill does

This skill helps you promote open source projects by automatically submitting them to multiple tech weeklies and community newsletters. It handles the entire workflow from gathering project information to creating tailored submissions across different platforms.

Instructions

Core Workflow

When the user wants to promote an open source project, follow these steps:

1. **Gather Project Information**

- If not provided, ask the user for the GitHub repository URL

- Use `gh repo view <repo> --json name,description,url,stargazerCount,readme` to fetch comprehensive project details

- Extract key information: name, description, stars, features, and usage examples from the README

2. **Load Weekly Configuration**

- Read the weeklies configuration from `${CLAUDE_PLUGIN_ROOT}/config/weeklies.json`

- Filter for enabled weeklies only

- Validate each weekly's submission requirements (type, repo, template)

3. **Generate Tailored Submissions**

- For each enabled weekly in the config:

- Use the weekly's `title_template` to generate an appropriate title

- Generate submission body based on the weekly's preferred format

- For Chinese weeklies, use the template format provided below

- For English weeklies, adapt the content appropriately

4. **Check for Existing Submissions**

- Before submitting, use `gh issue list` to check if the project was already submitted

- Skip duplicates and log them for the user

5. **Submit to Weeklies**

- 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>"`

- Add a 2-3 second delay between submissions to respect rate limits

6. **Track and Report**

- Keep a log of successful submissions, failures, and skipped duplicates

- Provide a summary report at the end with links to all created issues/comments

Submission Template for Chinese Weeklies

```markdown

项目介绍

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

核心功能

{features_from_readme}

使用示例

{usage_example}

链接

GitHub: {url}

Stars: {stars}

```

Available Commands

`/oss-promoter:promote <repo-url>` - Promote a project to all enabled weeklies

`/oss-promoter:search` - Search for new tech weeklies and newsletters to add to your config

`/oss-promoter:list` - List all configured weeklies with their status (enabled/disabled)

Tools to Use

**WebSearch** - For finding new weeklies when using the search command

**Bash** with `gh` CLI - For fetching repo information and creating issues/comments

**Read** - For loading the weeklies configuration file

**Write** or **Edit** - For updating the weeklies configuration if needed

Important Constraints

**Always check for duplicates** before creating issues using `gh issue list`

**Respect rate limits** by adding 2-3 second delays between API calls

**Validate weekly requirements** by reading their README/CONTRIBUTING guidelines first

**Language/topic matching** - Only submit to weeklies that match the project's primary language and topic

**Set `enabled: false`** in config for weeklies that don't match a project's scope

**Error handling** - Log failures but continue with remaining weeklies; don't stop the batch on single failures

Example Usage

```

User: "Promote my project https://github.com/user/awesome-tool to weeklies"

OSS Promoter

OSS Promoter

What this skill does

Instructions

Core Workflow

Submission Template for Chinese Weeklies

项目介绍

核心功能

使用示例

链接

Available Commands

Tools to Use

Important Constraints

Example Usage

Reviews (0)