feat: add OSS Hunter skill for automated contribution hunting

skills/oss-hunter/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: oss-hunter
+description: Automatically hunt for high-impact OSS contribution opportunities in trending repositories.
+risk: safe
+source: https://github.com/jackjin1997/ClawForge
+metadata: {"openclaw":{"emoji":"🎯","category":"developer"}}
+---
+
+# OSS Hunter 🎯
+
+A precision skill for agents to find, analyze, and strategize for high-impact Open Source contributions. This skill helps you become a top-tier contributor by identifying the most "mergeable" and influential issues in trending repositories.
+
+## When to Use
+
+- Use when the user asks to find open source issues to work on.
+- Use when searching for "help wanted" or "good first issue" tasks in specific domains like AI or Web3.
+- Use to generate a "Contribution Dossier" with ready-to-execute strategies for trending projects.
+
+## Quick Start
+
+Ask your agent:
+- "Find me some help-wanted issues in trending AI repositories."
+- "Hunt for bug fixes in langchain-ai/langchain that are suitable for a quick PR."
+- "Generate a contribution dossier for the most recent trending projects on GitHub."
+
+## Workflow
+
+When hunting for contributions, the agent follows this multi-stage protocol:
+
+### Phase 1: Repository Discovery
+Use `web_search` or `gh api` to find trending repositories.
+Focus on:
+- Stars > 1000
+- Recent activity (pushed within 24 hours)
+- Relevant topics (AI, Agentic, Web3, Tooling)
+
+### Phase 2: Issue Extraction
+Search for specific labels:
+- `help-wanted`
+- `good-first-issue`
+- `bug`
+- `v1` / `roadmap`
+
+```bash
+gh issue list --repo owner/repo --label "help wanted" --limit 10
+```
+
+### Phase 3: Feasibility Analysis
+Analyze the issue:
+1. **Reproducibility**: Is there a code snippet to reproduce the bug?
+2. **Impact**: How many users does this affect?
+3. **Mergeability**: Check recent PR history. Does the maintainer merge community PRs quickly?
+4. **Complexity**: Can this be solved by an agent with the current tools?
+
+### Phase 4: The Dossier
+Generate a structured report for the human:
+- **Project Name & Stars**
+- **Issue Link & Description**
+- **Root Cause Analysis** (based on code inspection)
+- **Proposed Fix Strategy**
+- **Confidence Score** (1-10)
+
+## Limitations
+
+- Accuracy depends on the availability of `gh` CLI or `web_search` tools.
+- Analysis is limited by context window when reading very large repositories.
+- Cannot guarantee PR acceptance (maintainer discretion).
+
+---
+
+## Contributing to the Matrix
+
+Build a better hunter by adding new heuristics to Phase 3. Submit your improvements to the [ClawForge](https://github.com/jackjin1997/ClawForge).
+
+*Powered by OpenClaw & ClawForge.*

skills/oss-hunter/bin/hunter.py

@@ -0,0 +1,56 @@
+import os
+import json
+import subprocess
+import sys
+
+def run_gh_command(args):
+    try:
+        result = subprocess.run(['gh'] + args, capture_output=True, text=True, check=True)
+        return result.stdout
+    except subprocess.CalledProcessError as e:
+        print(f"Error running gh command: {e.stderr}", file=sys.stderr)
+        return None
+
+def hunt():
+    print("🎯 Hunting for high-impact OSS issues...")
+    
+    # 1. Find trending repos (stars > 1000 created/updated recently)
+    repos_json = run_gh_command(['api', 'search/repositories?q=stars:>1000+pushed:>2026-02-01&sort=stars&order=desc', '--jq', '.items[] | {full_name: .full_name, stars: .stargazers_count, description: .description}'])
+    
+    if not repos_json:
+        print("No trending repositories found.")
+        return
+    
+    repos = [json.loads(line) for line in repos_json.strip().split('\n')[:10]]
+    
+    dossier = []
+    
+    for repo in repos:
+        name = repo['full_name']
+        print(f"Checking {name}...")
+        
+        # 2. Search for help-wanted issues
+        issues_json = run_gh_command(['issue', 'list', '--repo', name, '--label', 'help wanted', '--json', 'number,title,url', '--limit', '3'])
+        
+        if issues_json:
+            try:
+                issues = json.loads(issues_json)
+                for issue in issues:
+                    dossier.append({
+                        'repo': name,
+                        'stars': repo['stars'],
+                        'number': issue['number'],
+                        'title': issue['title'],
+                        'url': issue['url']
+                    })
+            except json.JSONDecodeError:
+                pass
+    
+    print("\n--- 📂 OSS CONTRIBUTION DOSSIER ---")
+    for item in dossier:
+        print(f"\n[{item['repo']} ★{item['stars']}]")
+        print(f"Issue #{item['number']}: {item['title']}")
+        print(f"Link: {item['url']}")
+
+if __name__ == "__main__":
+    hunt()