OSS Promoter
Batch promote open source projects to tech weeklies and communities using automated GitHub submissions.
What This Skill Does
This skill automates the process of promoting open source projects to various tech weekly newsletters and community platforms. It handles the entire workflow from gathering project information to submitting tailored content to multiple weeklies.
Step-by-Step Instructions
1. Gather Project Information
When the user wants to promote an open source project:
Ask for the GitHub repository URL if not providedUse `gh repo view <repo> --json name,description,url,stargazerCount,readme` to extract project detailsParse the README to identify core features and usage examples2. Load Weekly Configuration
Read the weeklies configuration from `${CLAUDE_PLUGIN_ROOT}/config/weeklies.json`Filter for enabled weeklies onlyReview each weekly's submission requirements (type, format, language)3. Generate Tailored Submissions
For each enabled weekly:
Apply the weekly's `title_template` with project nameGenerate submission body using the appropriate template formatFor Chinese weeklies, use this structure:```markdown
项目介绍
[{name}]({url}) - {description}
核心功能
{features_from_readme}
使用示例
{usage_example}
链接
GitHub: {url}Stars: {stars}```
For English weeklies, adapt the format to standard markdown with project highlights4. Submit to Weeklies
For each weekly:
**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>"`Before creating, check if a similar issue already exists using `gh issue list`Add delays between submissions (2-3 seconds) to respect rate limits5. Track and Report Results
Log successful submissions with issue/comment URLsReport any failures with error messagesProvide a summary of all submissions at the endAvailable 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 statusUsage Example
```
User: Promote https://github.com/anthropics/anthropic-sdk-python
Agent:
1. Fetching project details from GitHub...
2. Loading weeklies configuration...
3. Found 5 enabled weeklies
4. Generating submissions...
5. Submitting to:
- ruanyf/weekly (issue) ✓ Created #123
- HelloGitHub/HelloGitHub (comment) ✓ Added comment
- chinese-poetry/weekly (issue) ✓ Created #456
Summary: Successfully submitted to 3/5 weeklies. 2 skipped (language mismatch).
```
Important Constraints
Always verify an issue doesn't already exist before creating duplicatesRespect GitHub API rate limits - add 2-3 second delays between submissionsCheck each weekly's README for specific submission guidelines before postingDisable weeklies in config (`enabled: false`) if they don't match the project's language or topicOnly submit to weeklies where the project is genuinely relevant to avoid spamEnsure the project has meaningful content (README, examples) before batch promotingTools Used
**Bash with `gh` CLI** - GitHub operations (repo info, issue creation, comments)**Read** - Load configuration files**WebSearch** - Discover new tech weeklies for the config (optional)