oss-claudecode

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

1. Natural Language Understanding: The orchestrator agent understands your intent
2. Automatic Routing: Routes to the appropriate specialized agent/skill
3. GitHub Integration: Uses GitHub MCP for real-time data
4. 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