oss-claudecode
Open Source Software contribution toolkit for Claude Code. Complete tools for both contributors and maintainers.
English | 한국어
Installation
Quick Install (Recommended)
# 1. Add the marketplace
/plugin marketplace add jay05410/oss-claudecode
# 2. Install the plugin
/plugin install oss-claudecode
Manual Install (Development)
# Clone and load directly
git clone https://github.com/jay05410/oss-claudecode.git
claude --plugin-dir ./oss-claudecode
Setup
GitHub Token (Required)
The plugin uses GitHub MCP to fetch issues, PRs, and repository data. Set up your token:
# 1. Create a token at: https://github.com/settings/tokens
# Required scopes: repo, read:user
# 2. Set environment variable
export GITHUB_TOKEN=ghp_your_token_here
# 3. Add to your shell profile (~/.bashrc, ~/.zshrc)
echo 'export GITHUB_TOKEN=ghp_your_token_here' >> ~/.zshrc
The GitHub MCP server starts automatically when the plugin is enabled.
Usage
Natural Language (Just Talk!)
No commands needed. Just describe what you want:
"I'm a backend developer with 3 years experience. I want to contribute to kotest."
→ Analyzes kotest, recommends suitable issues
"Analyze issue #28934 in facebook/react"
→ Deep analysis with implementation guidance
"Review this PR: https://github.com/vercel/next.js/pull/12345"
→ Comprehensive code review
"Create a PR for my current changes"
→ Generates convention-compliant branch, commits, PR description
"Document my contribution to #123 as a blog post"
→ Creates blog post draft of your contribution journey
Explicit Skills
You can also use skills directly:
| Skill | Description |
|---|
/oss-claudecode:analyze | Analyze project structure and guidelines |
/oss-claudecode:find-issue | Find issues to contribute to |
/oss-claudecode:prep-pr | Prepare a PR |
/oss-claudecode:create-issue | Create a well-formatted issue |
/oss-claudecode:triage | Triage issues (maintainer) |
/oss-claudecode:review | Review PRs (maintainer) |
/oss-claudecode:release | Generate release notes (maintainer) |
/oss-claudecode:doc-contrib | Document your contribution |
Features
For Contributors
- Project Analysis - Understand contribution requirements instantly
- Issue Discovery - Find issues matching your skills
- Issue Analysis - Get implementation guidance for any issue
- PR Preparation - Create guideline-compliant PRs
- Contribution Documentation - Document your journey for blogs/portfolios
For Maintainers
- Issue Triage - Classify, label, prioritize incoming issues
- PR Review - Comprehensive code review with feedback
- Release Management - Generate changelogs and release notes
Project Structure
oss-claudecode/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace definition
├── .mcp.json # GitHub MCP configuration
├── agents/
│ ├── oss-orchestrator.md # Main router
│ ├── repo-analyzer.md # Project analysis
│ ├── issue-finder.md # Issue discovery
│ ├── issue-analyst.md # Issue deep-dive
│ ├── pr-creator.md # PR preparation
│ ├── pr-reviewer.md # PR review (maintainer)
│ ├── issue-triager.md # Issue triage (maintainer)
│ ├── release-helper.md # Release management
│ └── contribution-documenter.md
├── skills/
│ ├── analyze/SKILL.md
│ ├── find-issue/SKILL.md
│ ├── prep-pr/SKILL.md
│ ├── create-issue/SKILL.md
│ ├── triage/SKILL.md
│ ├── review/SKILL.md
│ ├── release/SKILL.md
│ └── doc-contrib/SKILL.md
└── templates/ # Document templates
How It Works
- Natural Language Understanding: The orchestrator agent understands your intent
- Automatic Routing: Routes to the appropriate specialized agent/skill
- GitHub Integration: Uses GitHub MCP for real-time data
- Multi-language Support: Responds in your language
Examples
Find Your First Issue
User: "I want to contribute to React but I'm a beginner"
Claude: I'll help you find beginner-friendly issues in React!
## Project Analysis
React is a JavaScript library for building UIs...
- Good First Issues: 23 open
- Help Wanted: 45 open
## Recommended Issues
🟢 Beginner-Friendly
#28934 - Fix typo in documentation
- Labels: good-first-issue, documentation
- Why: Clear scope, no code changes needed
[More recommendations...]
PR Review (Maintainer)
User: "Review https://github.com/my-project/pull/456"
Claude: ## PR Review: #456
| Aspect | Assessment |
|--------|------------|
| Decision | Request Changes |
| Risk | Medium |
## Required Changes
🔴 [src/auth.ts:45] Missing null check
...
## Summary
Thanks for this PR! Please address the null check issue...
Plugin Management
# Check installed plugins
/plugin
affaan-m
xhyqaq
Chachamaru127
obra
