An autonomous agent skill that discovers and resolves open-source GitHub issues to build your developer profile.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oss-contributor
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install oss-contributor using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OSS Contributor?
OSS Contributor is a professional-grade automation tool designed for developers who want to contribute to the open-source community without the manual overhead of searching for tasks. By leveraging Openclaw Skills, this agent scans repositories for "good first issues," "help wanted," or documentation gaps, then handles the entire lifecycle from forking to pull request submission. It is built to operate autonomously during idle periods, making it an ideal choice for maintaining a consistent GitHub presence and supporting community projects.
This skill is specifically engineered to respect maintainer etiquette. It ensures all contributions are high-quality, follows project-specific contributing guidelines, and includes a mandatory AI disclosure block in every pull request. By using this skill, developers can focus on high-level strategy while the agent handles the tedious work of repo discovery, environment setup, and initial implementation.
OSS Contributor Use Cases
- Automating contributions during agent idle time to build a consistent and impressive GitHub activity heat map.
- Discovering trending repositories that match your specific technical interests or job search targets.
- Building a professional portfolio by resolving low-to-medium complexity bugs and documentation gaps in popular projects.
- Scaling community support for Openclaw Skills by automating the resolution of documented issues across related ecosystems.
How OSS Contributor Works
- The skill parses CLI arguments and loads repository configurations, including blocklists and preferred languages.
- It scans configured repositories or searches for trending projects matching your interests using the GitHub REST API.
- Candidate issues are triaged by complexity (Low, Medium, High) based on labels, body length, and keyword analysis.
- Potential contributions are ranked by repository popularity and issue age before being presented for confirmation.
- Upon approval, the agent forks the target repository and clones it to a temporary local workspace.
- A sub-agent implements the fix, follows the project's specific CONTRIBUTING.md rules, and runs existing test suites.
- The agent opens a Pull Request using the repository's native template and appends a mandatory AI disclosure block.
- Success and failure data are logged to local memory files to track daily limits and prevent duplicate attempts.
OSS Contributor Setup
Ensure that a valid GH_TOKEN is available in your environment. You can then configure your preferences in a JSON file located at ~/clawd/oss-contributor.json to define your target languages and topics. Use the following commands to get started:
# Run the skill to discover issues in a specific repo
/oss-contributor --repos owner/repo --labels bug --limit 3
# Run in dry-run mode to see what the agent would do without making changes
/oss-contributor --repos openclaw/openclaw --dry-run
# Execute in headless mode for automated contributions
/oss-contributor --auto --languages typescript --limit 5
OSS Contributor Data Schema & Taxonomy
The skill manages its state and configuration through three primary JSON files located in the workspace:
| File | Purpose |
|---|---|
oss-contributor.json |
User configuration for repos, topics, languages, and daily PR limits. |
oss-activity.json |
Historical log of PRs opened, failed, and repositories contributed to by date. |
oss-history.json |
A deduplication registry that tracks attempted issues and their merge status. |
It organizes data using a clean taxonomy of repository owners, issue numbers, and complexity ratings to ensure efficient processing of Openclaw Skills tasks.
OSS Contributor Advanced Features
- Real-time repository discovery based on trending topics and specific GitHub star thresholds.
- Headless automation mode designed for integration with cron jobs or Openclaw Skills heartbeats.
- Multi-agent orchestration allowing for concurrent processing of up to three repository fixes at once.
- Intelligent PR template matching that automatically detects and populates project-specific contribution forms.
- Telegram integration for receiving instant notifications when the agent successfully opens a new pull request.
SKILL.md
Loading
Related Openclaw Skills
Claudia Agent RMS
A sophisticated relationship management system that builds social graphs and tracks inter-agent commitments on Moltbook.
Memory Setup
A technical workflow for establishing durable, searchable long-term memory within an AI agent workspace.
SnapService Website Screenshot API
A free, cloud-based screenshot service that enables AI agents to capture website visuals via a simple API.
CLAWLOGIC Prediction Market Agent
A comprehensive toolset for AI agents to create, seed, analyze, and trade in decentralized prediction markets.
Keychat
A sovereign, end-to-end encrypted messaging plugin for agents using Signal Protocol over Nostr relays.
Web Autopilot
A sophisticated RPA engine that transforms manual browser recordings into intelligent, reusable TypeScript automation tools.
METADATA
Featured*
