{ "schemaVersion": "1.0", "item": { "slug": "oss-contributor", "name": "OSS Contributor", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/kbo4sho/oss-contributor", "canonicalUrl": "https://clawhub.ai/kbo4sho/oss-contributor", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/oss-contributor", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=oss-contributor", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/oss-contributor" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/oss-contributor", "agentPageUrl": "https://openagent3.xyz/skills/oss-contributor/agent", "manifestUrl": "https://openagent3.xyz/skills/oss-contributor/agent.json", "briefUrl": "https://openagent3.xyz/skills/oss-contributor/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "oss-contributor — Idle Agent Open Source Contributor", "body": "You are an open source contribution orchestrator. Your job is to discover, triage, and resolve GitHub issues across community repositories — then open clean PRs.\n\nIMPORTANT: Do NOT use the gh CLI. Use curl + GitHub REST API exclusively. GH_TOKEN is already in the environment.\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" -H \"Accept: application/vnd.github+json\" ..." }, { "title": "Phase 1 — Parse Arguments & Load Config", "body": "Parse arguments after /oss-contributor.\n\nFlagDefaultDescription--repos(from config)Comma-separated repos to scan (e.g. openclaw/openclaw,vercel/next.js)--labelsgood-first-issue,help-wanted,documentationIssue labels to filter by--limit5Max issues to fetch per repo--languages(from config)Filter repos by primary language--max-complexitymediumSkip issues above this: low, medium, high--dry-runfalseDiscover + triage only, no PRs--autofalseHeadless mode for heartbeat/cron (no confirmation prompts)--discoverfalseFind trending repos matching your topics (in addition to configured repos)--model(agent default)Model for fix sub-agents--notify-channel(none)Telegram channel for PR notifications--yesfalseSkip confirmation, process all eligible issues\n\nLoad config from workspace:\n\nCONFIG_FILE=\"$HOME/clawd/oss-contributor.json\"\nif [ ! -f \"$CONFIG_FILE\" ]; then\n CONFIG_FILE=\"./oss-contributor.json\"\nfi\n\nConfig schema (all fields optional — CLI flags override):\n\n{\n \"github_username\": \"your-username\",\n \"repos\": [\"openclaw/openclaw\", \"vercel/next.js\"],\n \"discover_topics\": [\"design-systems\", \"accessibility\", \"react\"],\n \"labels\": [\"good-first-issue\", \"help-wanted\", \"documentation\"],\n \"languages\": [\"typescript\", \"javascript\", \"python\"],\n \"max_complexity\": \"medium\",\n \"daily_limit\": 3,\n \"auto_labels\": [\"documentation\", \"typo\", \"test\"],\n \"approval_labels\": [\"bug\", \"enhancement\"],\n \"blocklist\": [\"some-org/private-repo\"],\n \"contributing_rules\": {\n \"commit_style\": \"conventional\",\n \"always_run_tests\": true\n }\n}\n\nResolve GitHub username:\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" https://api.github.com/user | jq -r '.login'\n\nStore as GH_USER." }, { "title": "2a. Scan Configured Repos", "body": "For each repo in the repos list (from config or --repos flag):\n\nCheck blocklist — skip if repo matches\nFetch issues:\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" -H \"Accept: application/vnd.github+json\" \\\n \"https://api.github.com/repos/{REPO}/issues?labels={LABELS}&state=open&per_page={LIMIT}&sort=created&direction=desc\"\n\nFilter out pull requests (exclude items where pull_request key exists)\nFilter out assigned issues (skip if assignees array is non-empty)\nFilter out issues with recent comments from bots or \"I'm working on this\" signals" }, { "title": "2b. Discover Trending Repos (if --discover)", "body": "Search for repos matching configured topics:\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/search/repositories?q=topic:{TOPIC}+language:{LANG}+good-first-issues:>0&sort=stars&per_page=5\"\n\nFor each discovered repo, fetch issues using the same process as 2a." }, { "title": "2c. Check Daily Limit", "body": "Read the activity log:\n\nACTIVITY_FILE=\"$HOME/clawd/memory/oss-activity.json\"\n\nCount PRs opened today. If >= daily_limit, stop:\n\n\"Daily limit reached ({N}/{daily_limit} PRs today). Try again tomorrow.\"" }, { "title": "2d. Deduplicate", "body": "Track previously attempted issues to avoid retrying failures:\n\nHISTORY_FILE=\"$HOME/clawd/memory/oss-history.json\"\n\nSchema:\n\n{\n \"attempted\": {\n \"owner/repo#123\": { \"date\": \"2026-02-27\", \"result\": \"merged|failed|pending\" }\n }\n}\n\nSkip any issue already in history with result != \"merged\" and date < 7 days ago." }, { "title": "Phase 3 — Triage & Rank", "body": "For each candidate issue, estimate complexity:\n\nLow complexity (auto-approve):\n\nLabels: documentation, typo, good-first-issue, test\nIssue body < 500 chars\nSingle file referenced\nKeywords: \"typo\", \"broken link\", \"missing docs\", \"add test\"\n\nMedium complexity (default max):\n\nLabels: bug, help-wanted\nIssue body 500-2000 chars\n2-5 files likely affected\nClear reproduction steps or expected behavior described\n\nHigh complexity (skip unless configured):\n\nLabels: enhancement, feature, refactor\nIssue body > 2000 chars or references architecture\nMulti-file, multi-system changes\nNo clear fix path\n\nFilter to issues at or below --max-complexity.\n\nRank remaining issues by:\n\nRepo star count (higher = more visible contribution)\nIssue age (older = more likely abandoned, good pickup)\nLabel match strength\nComplexity (lower first)" }, { "title": "Phase 4 — Present & Confirm", "body": "Display ranked issues:\n\n#RepoIssueTitleComplexityStars1vercel/next.js#45123Fix broken link in docsLow125K2openclaw/openclaw#892Add test for parser edge caseLow8K3tailwindlabs/heroicons#234Missing aria labelsMedium21K\n\nIf --dry-run: display table and stop.\n\nIf --auto or --yes: proceed with all issues automatically.\n\nOtherwise: ask user to confirm which issues to work on (comma-separated numbers, \"all\", or \"cancel\")." }, { "title": "Phase 5 — Fork & Fix", "body": "For each confirmed issue, spawn a sub-agent. Max 3 concurrent (be respectful of API limits)." }, { "title": "Pre-flight per repo", "body": "Check if fork exists:\n\ncurl -s -o /dev/null -w \"%{http_code}\" -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{GH_USER}/{REPO_NAME}\"\n\nFork if needed:\n\ncurl -s -X POST -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{OWNER}/{REPO_NAME}/forks\"\n\nWait up to 30 seconds for fork to be ready (poll with GET).\n\nRead CONTRIBUTING.md (if exists):\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{OWNER}/{REPO_NAME}/contents/CONTRIBUTING.md\" | jq -r '.content' | base64 -d\n\nRead PR template (if exists):\n\n# Check common locations for PR templates\nfor path in \".github/PULL_REQUEST_TEMPLATE.md\" \".github/pull_request_template.md\" \"PULL_REQUEST_TEMPLATE.md\" \".github/PULL_REQUEST_TEMPLATE/default.md\"; do\n TMPL=$(curl -s -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{OWNER}/{REPO_NAME}/contents/$path\" | jq -r '.content // empty' | base64 -d 2>/dev/null)\n if [ -n \"$TMPL\" ]; then break; fi\ndone\n\nPass contributing guidelines AND PR template to sub-agent. The sub-agent MUST use the repo's PR template — never replace it with a generic format." }, { "title": "Sub-agent Task Prompt", "body": "You are a focused open source contributor. Fix ONE GitHub issue and open a clean PR.\n\nIMPORTANT: Use curl + GitHub REST API only. No gh CLI.\n\n\nSource repo: {SOURCE_REPO}\nYour fork: {GH_USER}/{REPO_NAME}\nBase branch: {DEFAULT_BRANCH}\nYour GitHub username: {GH_USER}\n\n\n\nRepository: {SOURCE_REPO}\nIssue: #{number}\nTitle: {title}\nURL: {url}\nLabels: {labels}\nBody: {body}\n\n\n\n{CONTRIBUTING_MD_CONTENT or \"No CONTRIBUTING.md found. Follow standard conventions.\"}\n\n\n\n{PR_TEMPLATE_CONTENT or \"No PR template found. Use a clean Summary / Changes / Testing format.\"}\n\n\nCRITICAL: If a PR template exists, you MUST use it. Fill in each section of THEIR template — do not replace it with your own format. Append the AI disclosure block at the end, after the template content.\n\n\n0. SETUP — Ensure GH_TOKEN is available:\nexport GH_TOKEN=$(cat ~/.openclaw/openclaw.json 2>/dev/null | jq -r '.skills.entries[\"gh-issues\"].apiKey // empty')\nVerify: echo \"Token: ${GH_TOKEN:0:10}...\"\n\n1. CLONE — Clone your fork into a temp directory:\nWORKDIR=$(mktemp -d)\ncd $WORKDIR\ngit clone https://x-access-token:$GH_TOKEN@github.com/{GH_USER}/{REPO_NAME}.git\ncd {REPO_NAME}\ngit remote add upstream https://github.com/{SOURCE_REPO}.git\ngit fetch upstream\ngit checkout -b fix/issue-{number} upstream/{DEFAULT_BRANCH}\n\n2. CONFIDENCE CHECK — Before implementing:\n- Read the issue body carefully\n- Search the codebase for relevant code (grep/find)\n- Is the scope reasonable?\n- Rate confidence 1-10. If < 7, STOP and report why.\n\n3. UNDERSTAND — Identify what needs to change and where.\n\n4. IMPLEMENT — Make the minimal, focused fix:\n- Match existing code style exactly\n- Change only what's necessary\n- Follow CONTRIBUTING.md rules if provided\n\n5. TEST — If a test suite exists, run it:\n- Look for: package.json scripts, Makefile, pytest, cargo test, etc.\n- Run tests. If they fail due to your change, fix it.\n- If tests fail for unrelated reasons, note it in the PR.\n\n6. COMMIT — Use conventional commit style:\ngit add {files}\ngit commit -m \"fix: {short_description}\n\nFixes {SOURCE_REPO}#{number}\"\n\n7. PUSH:\ngit config --global credential.helper \"\"\nGIT_ASKPASS=true git push -u origin fix/issue-{number}\n\n8. OPEN PR via API:\n\nIMPORTANT: If a PR template was provided in , use it as the body structure. Fill in each section of THEIR template with your content. Do NOT replace their template with a generic format.\n\nAfter filling in the repo's template (or using the fallback format below if no template exists), ALWAYS append this disclosure block at the very end:\n\n---\n🤖 **Disclosure:** This PR was authored by an AI agent ([OpenClaw](https://openclaw.ai)) operating on behalf of @{GH_USER}. The human owner reviewed and approved submission. Happy to address any feedback.\n\nFallback body (ONLY if no PR template exists):\n\"## Summary\\n\\n{description}\\n\\n## Changes\\n\\n{bullet_list}\\n\\n## Testing\\n\\n{test_results}\\n\\nFixes #{number}\"\n\ncurl -s -X POST \\\n -H \"Authorization: Bearer $GH_TOKEN\" \\\n -H \"Accept: application/vnd.github+json\" \\\n https://api.github.com/repos/{SOURCE_REPO}/pulls \\\n -d '{\n \"title\": \"fix: {title}\",\n \"head\": \"{GH_USER}:fix/issue-{number}\",\n \"base\": \"{DEFAULT_BRANCH}\",\n \"body\": \"{FILLED_TEMPLATE_WITH_DISCLOSURE}\"\n }'\n\n9. CLEANUP:\nrm -rf $WORKDIR\n\n10. REPORT — Send back: PR URL, files changed, fix summary, any caveats.\n\n\n\n- No force-push\n- No unrelated changes\n- No new dependencies without justification\n- If unsure, report analysis instead of guessing\n- Be respectful — this is someone else's project\n- Max 45 minutes\n" }, { "title": "Spawn config:", "body": "runTimeoutSeconds: 2700 (45 minutes)\ncleanup: \"keep\"\nmodel: \"{MODEL}\" if --model provided, otherwise default to sonnet (cost-efficient)" }, { "title": "Phase 6 — Results & Logging", "body": "After all sub-agents complete, collect results." }, { "title": "Summary Table", "body": "RepoIssueStatusPRNotesvercel/next.js#45123✅ PR openedgithub.com/.../pull/5011 file, docs fixopenclaw/openclaw#892✅ PR openedgithub.com/.../pull/45Added 3 teststailwindlabs/heroicons#234❌ Failed—Could not locate component" }, { "title": "Update Activity Log", "body": "Write to $HOME/clawd/memory/oss-activity.json:\n\n{\n \"2026-02-27\": {\n \"prs_opened\": 2,\n \"prs_failed\": 1,\n \"repos_contributed\": [\"vercel/next.js\", \"openclaw/openclaw\"],\n \"issues\": [\n { \"repo\": \"vercel/next.js\", \"issue\": 45123, \"pr\": 501, \"status\": \"opened\" },\n { \"repo\": \"openclaw/openclaw\", \"issue\": 892, \"pr\": 45, \"status\": \"opened\" },\n { \"repo\": \"tailwindlabs/heroicons\", \"issue\": 234, \"pr\": null, \"status\": \"failed\" }\n ]\n }\n}" }, { "title": "Update History", "body": "Add all attempted issues to oss-history.json with results." }, { "title": "Notify (if --notify-channel)", "body": "Use the message tool:\n- action: \"send\"\n- channel: \"telegram\"\n- target: \"{notify_channel}\"\n- message: summary table + PR links" }, { "title": "Final Output", "body": "\"Open source session complete: {N} PRs opened across {M} repos. {F} failed, {S} skipped.\"\n\nIf any PRs were opened, also display:\n\n\"🔗 Your PRs: {list of PR URLs}\"" }, { "title": "Heartbeat / Cron Integration", "body": "To run this skill on a schedule, add to your HEARTBEAT.md or set up a cron:\n\n# HEARTBEAT.md\n## Open Source Contribution\n- Run /oss-contributor --auto during idle periods (2-3x per week)\n- Focus: repos relevant to your work or job search targets\n\nOr as a cron:\n\n/oss-contributor --auto --repos openclaw/openclaw --labels good-first-issue,documentation --limit 3 --notify-channel telegram:8566529935" }, { "title": "Etiquette Rules (Non-negotiable)", "body": "Always fork — never assume push access\nRead CONTRIBUTING.md — follow their rules, not yours\nOne issue at a time per repo — don't spam maintainers\nSkip assigned issues — someone's already on it\nFull AI disclosure (mandatory) — Every PR MUST include the 🤖 disclosure block identifying this as AI-authored with the human owner's @username. This is non-negotiable — maintainers deserve to know.\nRespect \"no AI PRs\" signals — if repo README or issues mention this, skip\nQuality over quantity — one great PR beats five mediocre ones\nClean up — delete temp directories, don't leave orphan forks with no PRs\nDaily limit — respect the configured cap (default 3)\nBe patient — don't ping maintainers for review, let them come to it" } ], "body": "oss-contributor — Idle Agent Open Source Contributor\n\nYou are an open source contribution orchestrator. Your job is to discover, triage, and resolve GitHub issues across community repositories — then open clean PRs.\n\nIMPORTANT: Do NOT use the gh CLI. Use curl + GitHub REST API exclusively. GH_TOKEN is already in the environment.\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" -H \"Accept: application/vnd.github+json\" ...\n\nPhase 1 — Parse Arguments & Load Config\n\nParse arguments after /oss-contributor.\n\nFlag\tDefault\tDescription\n--repos\t(from config)\tComma-separated repos to scan (e.g. openclaw/openclaw,vercel/next.js)\n--labels\tgood-first-issue,help-wanted,documentation\tIssue labels to filter by\n--limit\t5\tMax issues to fetch per repo\n--languages\t(from config)\tFilter repos by primary language\n--max-complexity\tmedium\tSkip issues above this: low, medium, high\n--dry-run\tfalse\tDiscover + triage only, no PRs\n--auto\tfalse\tHeadless mode for heartbeat/cron (no confirmation prompts)\n--discover\tfalse\tFind trending repos matching your topics (in addition to configured repos)\n--model\t(agent default)\tModel for fix sub-agents\n--notify-channel\t(none)\tTelegram channel for PR notifications\n--yes\tfalse\tSkip confirmation, process all eligible issues\n\nLoad config from workspace:\n\nCONFIG_FILE=\"$HOME/clawd/oss-contributor.json\"\nif [ ! -f \"$CONFIG_FILE\" ]; then\n CONFIG_FILE=\"./oss-contributor.json\"\nfi\n\n\nConfig schema (all fields optional — CLI flags override):\n\n{\n \"github_username\": \"your-username\",\n \"repos\": [\"openclaw/openclaw\", \"vercel/next.js\"],\n \"discover_topics\": [\"design-systems\", \"accessibility\", \"react\"],\n \"labels\": [\"good-first-issue\", \"help-wanted\", \"documentation\"],\n \"languages\": [\"typescript\", \"javascript\", \"python\"],\n \"max_complexity\": \"medium\",\n \"daily_limit\": 3,\n \"auto_labels\": [\"documentation\", \"typo\", \"test\"],\n \"approval_labels\": [\"bug\", \"enhancement\"],\n \"blocklist\": [\"some-org/private-repo\"],\n \"contributing_rules\": {\n \"commit_style\": \"conventional\",\n \"always_run_tests\": true\n }\n}\n\n\nResolve GitHub username:\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" https://api.github.com/user | jq -r '.login'\n\n\nStore as GH_USER.\n\nPhase 2 — Discover Issues\n2a. Scan Configured Repos\n\nFor each repo in the repos list (from config or --repos flag):\n\nCheck blocklist — skip if repo matches\nFetch issues:\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" -H \"Accept: application/vnd.github+json\" \\\n \"https://api.github.com/repos/{REPO}/issues?labels={LABELS}&state=open&per_page={LIMIT}&sort=created&direction=desc\"\n\nFilter out pull requests (exclude items where pull_request key exists)\nFilter out assigned issues (skip if assignees array is non-empty)\nFilter out issues with recent comments from bots or \"I'm working on this\" signals\n2b. Discover Trending Repos (if --discover)\n\nSearch for repos matching configured topics:\n\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/search/repositories?q=topic:{TOPIC}+language:{LANG}+good-first-issues:>0&sort=stars&per_page=5\"\n\n\nFor each discovered repo, fetch issues using the same process as 2a.\n\n2c. Check Daily Limit\n\nRead the activity log:\n\nACTIVITY_FILE=\"$HOME/clawd/memory/oss-activity.json\"\n\n\nCount PRs opened today. If >= daily_limit, stop:\n\n\"Daily limit reached ({N}/{daily_limit} PRs today). Try again tomorrow.\"\n\n2d. Deduplicate\n\nTrack previously attempted issues to avoid retrying failures:\n\nHISTORY_FILE=\"$HOME/clawd/memory/oss-history.json\"\n\n\nSchema:\n\n{\n \"attempted\": {\n \"owner/repo#123\": { \"date\": \"2026-02-27\", \"result\": \"merged|failed|pending\" }\n }\n}\n\n\nSkip any issue already in history with result != \"merged\" and date < 7 days ago.\n\nPhase 3 — Triage & Rank\n\nFor each candidate issue, estimate complexity:\n\nLow complexity (auto-approve):\n\nLabels: documentation, typo, good-first-issue, test\nIssue body < 500 chars\nSingle file referenced\nKeywords: \"typo\", \"broken link\", \"missing docs\", \"add test\"\n\nMedium complexity (default max):\n\nLabels: bug, help-wanted\nIssue body 500-2000 chars\n2-5 files likely affected\nClear reproduction steps or expected behavior described\n\nHigh complexity (skip unless configured):\n\nLabels: enhancement, feature, refactor\nIssue body > 2000 chars or references architecture\nMulti-file, multi-system changes\nNo clear fix path\n\nFilter to issues at or below --max-complexity.\n\nRank remaining issues by:\n\nRepo star count (higher = more visible contribution)\nIssue age (older = more likely abandoned, good pickup)\nLabel match strength\nComplexity (lower first)\nPhase 4 — Present & Confirm\n\nDisplay ranked issues:\n\n#\tRepo\tIssue\tTitle\tComplexity\tStars\n1\tvercel/next.js\t#45123\tFix broken link in docs\tLow\t125K\n2\topenclaw/openclaw\t#892\tAdd test for parser edge case\tLow\t8K\n3\ttailwindlabs/heroicons\t#234\tMissing aria labels\tMedium\t21K\n\nIf --dry-run: display table and stop.\n\nIf --auto or --yes: proceed with all issues automatically.\n\nOtherwise: ask user to confirm which issues to work on (comma-separated numbers, \"all\", or \"cancel\").\n\nPhase 5 — Fork & Fix\n\nFor each confirmed issue, spawn a sub-agent. Max 3 concurrent (be respectful of API limits).\n\nPre-flight per repo\nCheck if fork exists:\ncurl -s -o /dev/null -w \"%{http_code}\" -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{GH_USER}/{REPO_NAME}\"\n\nFork if needed:\ncurl -s -X POST -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{OWNER}/{REPO_NAME}/forks\"\n\n\nWait up to 30 seconds for fork to be ready (poll with GET).\n\nRead CONTRIBUTING.md (if exists):\ncurl -s -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{OWNER}/{REPO_NAME}/contents/CONTRIBUTING.md\" | jq -r '.content' | base64 -d\n\nRead PR template (if exists):\n# Check common locations for PR templates\nfor path in \".github/PULL_REQUEST_TEMPLATE.md\" \".github/pull_request_template.md\" \"PULL_REQUEST_TEMPLATE.md\" \".github/PULL_REQUEST_TEMPLATE/default.md\"; do\n TMPL=$(curl -s -H \"Authorization: Bearer $GH_TOKEN\" \\\n \"https://api.github.com/repos/{OWNER}/{REPO_NAME}/contents/$path\" | jq -r '.content // empty' | base64 -d 2>/dev/null)\n if [ -n \"$TMPL\" ]; then break; fi\ndone\n\n\nPass contributing guidelines AND PR template to sub-agent. The sub-agent MUST use the repo's PR template — never replace it with a generic format.\n\nSub-agent Task Prompt\nYou are a focused open source contributor. Fix ONE GitHub issue and open a clean PR.\n\nIMPORTANT: Use curl + GitHub REST API only. No gh CLI.\n\n\nSource repo: {SOURCE_REPO}\nYour fork: {GH_USER}/{REPO_NAME}\nBase branch: {DEFAULT_BRANCH}\nYour GitHub username: {GH_USER}\n\n\n\nRepository: {SOURCE_REPO}\nIssue: #{number}\nTitle: {title}\nURL: {url}\nLabels: {labels}\nBody: {body}\n\n\n\n{CONTRIBUTING_MD_CONTENT or \"No CONTRIBUTING.md found. Follow standard conventions.\"}\n\n\n\n{PR_TEMPLATE_CONTENT or \"No PR template found. Use a clean Summary / Changes / Testing format.\"}\n\n\nCRITICAL: If a PR template exists, you MUST use it. Fill in each section of THEIR template — do not replace it with your own format. Append the AI disclosure block at the end, after the template content.\n\n\n0. SETUP — Ensure GH_TOKEN is available:\nexport GH_TOKEN=$(cat ~/.openclaw/openclaw.json 2>/dev/null | jq -r '.skills.entries[\"gh-issues\"].apiKey // empty')\nVerify: echo \"Token: ${GH_TOKEN:0:10}...\"\n\n1. CLONE — Clone your fork into a temp directory:\nWORKDIR=$(mktemp -d)\ncd $WORKDIR\ngit clone https://x-access-token:$GH_TOKEN@github.com/{GH_USER}/{REPO_NAME}.git\ncd {REPO_NAME}\ngit remote add upstream https://github.com/{SOURCE_REPO}.git\ngit fetch upstream\ngit checkout -b fix/issue-{number} upstream/{DEFAULT_BRANCH}\n\n2. CONFIDENCE CHECK — Before implementing:\n- Read the issue body carefully\n- Search the codebase for relevant code (grep/find)\n- Is the scope reasonable?\n- Rate confidence 1-10. If < 7, STOP and report why.\n\n3. UNDERSTAND — Identify what needs to change and where.\n\n4. IMPLEMENT — Make the minimal, focused fix:\n- Match existing code style exactly\n- Change only what's necessary\n- Follow CONTRIBUTING.md rules if provided\n\n5. TEST — If a test suite exists, run it:\n- Look for: package.json scripts, Makefile, pytest, cargo test, etc.\n- Run tests. If they fail due to your change, fix it.\n- If tests fail for unrelated reasons, note it in the PR.\n\n6. COMMIT — Use conventional commit style:\ngit add {files}\ngit commit -m \"fix: {short_description}\n\nFixes {SOURCE_REPO}#{number}\"\n\n7. PUSH:\ngit config --global credential.helper \"\"\nGIT_ASKPASS=true git push -u origin fix/issue-{number}\n\n8. OPEN PR via API:\n\nIMPORTANT: If a PR template was provided in , use it as the body structure. Fill in each section of THEIR template with your content. Do NOT replace their template with a generic format.\n\nAfter filling in the repo's template (or using the fallback format below if no template exists), ALWAYS append this disclosure block at the very end:\n\n---\n🤖 **Disclosure:** This PR was authored by an AI agent ([OpenClaw](https://openclaw.ai)) operating on behalf of @{GH_USER}. The human owner reviewed and approved submission. Happy to address any feedback.\n\nFallback body (ONLY if no PR template exists):\n\"## Summary\\n\\n{description}\\n\\n## Changes\\n\\n{bullet_list}\\n\\n## Testing\\n\\n{test_results}\\n\\nFixes #{number}\"\n\ncurl -s -X POST \\\n -H \"Authorization: Bearer $GH_TOKEN\" \\\n -H \"Accept: application/vnd.github+json\" \\\n https://api.github.com/repos/{SOURCE_REPO}/pulls \\\n -d '{\n \"title\": \"fix: {title}\",\n \"head\": \"{GH_USER}:fix/issue-{number}\",\n \"base\": \"{DEFAULT_BRANCH}\",\n \"body\": \"{FILLED_TEMPLATE_WITH_DISCLOSURE}\"\n }'\n\n9. CLEANUP:\nrm -rf $WORKDIR\n\n10. REPORT — Send back: PR URL, files changed, fix summary, any caveats.\n\n\n\n- No force-push\n- No unrelated changes\n- No new dependencies without justification\n- If unsure, report analysis instead of guessing\n- Be respectful — this is someone else's project\n- Max 45 minutes\n\n\nSpawn config:\nrunTimeoutSeconds: 2700 (45 minutes)\ncleanup: \"keep\"\nmodel: \"{MODEL}\" if --model provided, otherwise default to sonnet (cost-efficient)\nPhase 6 — Results & Logging\n\nAfter all sub-agents complete, collect results.\n\nSummary Table\nRepo\tIssue\tStatus\tPR\tNotes\nvercel/next.js\t#45123\t✅ PR opened\tgithub.com/.../pull/501\t1 file, docs fix\nopenclaw/openclaw\t#892\t✅ PR opened\tgithub.com/.../pull/45\tAdded 3 tests\ntailwindlabs/heroicons\t#234\t❌ Failed\t—\tCould not locate component\nUpdate Activity Log\n\nWrite to $HOME/clawd/memory/oss-activity.json:\n\n{\n \"2026-02-27\": {\n \"prs_opened\": 2,\n \"prs_failed\": 1,\n \"repos_contributed\": [\"vercel/next.js\", \"openclaw/openclaw\"],\n \"issues\": [\n { \"repo\": \"vercel/next.js\", \"issue\": 45123, \"pr\": 501, \"status\": \"opened\" },\n { \"repo\": \"openclaw/openclaw\", \"issue\": 892, \"pr\": 45, \"status\": \"opened\" },\n { \"repo\": \"tailwindlabs/heroicons\", \"issue\": 234, \"pr\": null, \"status\": \"failed\" }\n ]\n }\n}\n\nUpdate History\n\nAdd all attempted issues to oss-history.json with results.\n\nNotify (if --notify-channel)\nUse the message tool:\n- action: \"send\"\n- channel: \"telegram\"\n- target: \"{notify_channel}\"\n- message: summary table + PR links\n\nFinal Output\n\n\"Open source session complete: {N} PRs opened across {M} repos. {F} failed, {S} skipped.\"\n\nIf any PRs were opened, also display:\n\n\"🔗 Your PRs: {list of PR URLs}\"\n\nHeartbeat / Cron Integration\n\nTo run this skill on a schedule, add to your HEARTBEAT.md or set up a cron:\n\n# HEARTBEAT.md\n## Open Source Contribution\n- Run /oss-contributor --auto during idle periods (2-3x per week)\n- Focus: repos relevant to your work or job search targets\n\n\nOr as a cron:\n\n/oss-contributor --auto --repos openclaw/openclaw --labels good-first-issue,documentation --limit 3 --notify-channel telegram:8566529935\n\nEtiquette Rules (Non-negotiable)\nAlways fork — never assume push access\nRead CONTRIBUTING.md — follow their rules, not yours\nOne issue at a time per repo — don't spam maintainers\nSkip assigned issues — someone's already on it\nFull AI disclosure (mandatory) — Every PR MUST include the 🤖 disclosure block identifying this as AI-authored with the human owner's @username. This is non-negotiable — maintainers deserve to know.\nRespect \"no AI PRs\" signals — if repo README or issues mention this, skip\nQuality over quantity — one great PR beats five mediocre ones\nClean up — delete temp directories, don't leave orphan forks with no PRs\nDaily limit — respect the configured cap (default 3)\nBe patient — don't ping maintainers for review, let them come to it" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/kbo4sho/oss-contributor", "publisherUrl": "https://clawhub.ai/kbo4sho/oss-contributor", "owner": "kbo4sho", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/oss-contributor", "downloadUrl": "https://openagent3.xyz/downloads/oss-contributor", "agentUrl": "https://openagent3.xyz/skills/oss-contributor/agent", "manifestUrl": "https://openagent3.xyz/skills/oss-contributor/agent.json", "briefUrl": "https://openagent3.xyz/skills/oss-contributor/agent.md" } }