OSS Promoter

Batch promote open source projects to tech weeklies and communities using GitHub CLI.

What This Skill Does

This skill automates the process of promoting open source projects to multiple tech weeklies and developer communities. It searches for relevant submission targets, extracts project information, generates tailored submissions, and batch-submits them using the GitHub CLI.

Instructions

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

Step 1: Gather Project Information

1. Ask for the GitHub repository URL if not provided

2. Use `gh repo view <repo> --json name,description,url,stargazerCount,readme` to extract:

- Project name

- Description

- Repository URL

- Star count

- README content (for features and usage examples)

Step 2: Load Weekly Configuration

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

2. Filter for enabled weeklies that match the project's language/topic

3. Verify each weekly's submission requirements by checking their README if necessary

Step 3: Generate Submissions

For each enabled weekly:

1. Generate a title using the weekly's `title_template`

2. Generate submission body based on the weekly's preferred format

3. For Chinese weeklies, use this template:

```markdown

项目介绍

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

核心功能

{features_from_readme}

使用示例

{usage_example}

链接

GitHub: {url}

Stars: {stars}

```

Step 4: Submit to Weeklies

For each weekly:

1. Check if a similar submission already exists using `gh issue list --repo <weekly_repo> --search "<project-name>"`

2. If `type` is "issue":

- Use `gh issue create --repo <weekly_repo> --title "<title>" --body "<body>"`

3. If `type` is "comment":

- Use `gh issue comment <issue_number> --repo <weekly_repo> --body "<body>"`

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

5. Track successful and failed submissions

Step 5: Report Results

Provide a summary table showing:

Weekly name

Submission status (success/failed/skipped)

Issue/comment URL if successful

Error message if failed

Available Commands

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

`/oss-promoter:search` - Search for new tech weeklies to add to configuration

`/oss-promoter:list` - List all configured weeklies and their enabled status

Tools and Requirements

This skill requires:

**GitHub CLI (`gh`)**: For repository information and issue operations

**WebSearch**: To discover new weeklies

**Read**: To load configuration files

**Bash**: For command execution

Important Constraints

1. **Duplicate Prevention**: Always check if a submission already exists before creating new issues

2. **Rate Limiting**: Add 2-3 second delays between submissions to avoid hitting GitHub's rate limits

3. **Format Compliance**: Check each weekly's README for specific formatting requirements before submitting

4. **Language Matching**: Skip weeklies that don't match the project's primary language or topic

5. **Respectful Submission**: Set `enabled: false` in config for weeklies that are highly specialized and don't match the project

Usage Examples

**Example 1: Promote a project**

```

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

Assistant: [Loads config, extracts project info, generates submissions, submits to each enabled weekly, reports results]

```

**Example 2: Search for new weeklies**

```

User: /oss-promoter:search

Assistant: [Uses WebSearch to find tech weeklies accepting submissions, suggests additions to config]

```

**Example 3: List configured weeklies**

```

User: /oss-promoter:list

Assistant: [Displays all weeklies from config with enabled status and submission type]

```

OSS Promoter

OSS Promoter

What This Skill Does

Instructions

Step 1: Gather Project Information

Step 2: Load Weekly Configuration

Step 3: Generate Submissions

项目介绍

核心功能

使用示例

链接

Step 4: Submit to Weeklies

Step 5: Report Results

Available Commands

Tools and Requirements

Important Constraints

Usage Examples

Reviews (0)