oss-skills-mcp
Guides AI agents through open-source contribution workflows, from finding issues to submitting PRs, while keeping decision-making and coding with the human contributor.
README
oss-skills-mcp
Guided open-source contribution skills, served as an MCP server.
The philosophy: the agent researches, you think and code. Each skill walks the agent through deep research for one stage of the contribution journey — finding issues, reading codebases, writing tests, responding to reviews — while the decisions and the code stay with you. The result is contributions that maintainers actually want to merge, from a human who actually learned the repo.
Works with any MCP client, including goose.
Skills
Evaluation
| Skill | What it does |
|---|---|
oss-evaluate-repo |
Assess a repo's health, governance, and trajectory before investing time |
The contribution workflow (roughly in order)
| Skill | What it does |
|---|---|
oss-find-issue |
Find unclaimed issues filed by maintainers, matched to your skills |
oss-prep-to-contribute |
Read the contribution docs and fill knowledge gaps before coding |
oss-setup-dev-env |
Get an unfamiliar repo building and testing locally |
oss-contribute |
Research an issue deeply, then implement it yourself |
oss-submit-pr |
Open a PR that follows the repo's guidelines |
oss-post-pr |
Understand review feedback and respond to it well |
oss-debug-ci |
Diagnose CI failures in unfamiliar pipelines |
Contribution types
| Skill | What it does |
|---|---|
oss-write-tests |
Add tests for untested code as a standalone contribution |
oss-write-docs |
Fix documentation gaps verified against the source |
Going deeper
| Skill | What it does |
|---|---|
oss-review-prs |
Learn a codebase and build trust by reviewing others' PRs |
oss-second-contribution |
Move from one-off contributor to regular |
oss-find-real-issues |
Find code problems that aren't in the issue tracker |
oss-explore-repo |
Guided tour of a repo's architecture and patterns |
oss-learn-stack |
Learn unfamiliar tech from how the repo actually uses it |
Install
uvx --from git+https://github.com/chiruu12/oss-skills-mcp oss-skills-mcp
goose
CLI
goose configure
Add a Command-Driven Extension with:
- Name:
oss-skills - Command:
uvx --from git+https://github.com/chiruu12/oss-skills-mcp oss-skills-mcp
Desktop
Add a custom extension with:
- Type: STDIO
- Command:
uvx - Arguments:
--from git+https://github.com/chiruu12/oss-skills-mcp oss-skills-mcp
Usage
Each skill is available as an MCP prompt — invoke oss-find-issue,
oss-contribute, and so on from your client's prompt picker. Two tools are
also exposed for programmatic access:
list_skills()— names and descriptions of all bundled skillsget_skill(name)— full skill content
Development
uv sync
uv run pytest
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.