- name
- auto-skill-hunter
- description
- Proactively discovers, ranks, and installs high-value ClawHub skills by mining unresolved user needs and agent context. Use when new tasks are unsolved, when capability gaps appear, when users ask for better tools, or as a scheduled patrol for continuous skill growth.
- tags
- [meta, evolution, learning, proactive]
Auto Skill Hunter
Auto Skill Hunter continuously expands an agent's capability stack with task-relevant skills, then explains why each selected skill is worth trying.
When to Use
Use this skill when at least one of the following is true:
- The user asks for a task that current skills cannot solve reliably.
- Similar issues keep appearing across recent sessions.
- The user explicitly asks to discover/install better skills.
- The agent needs proactive capability growth on a timer.
High-Value Outcomes
- Faster discovery of practical skills for real unresolved tasks.
- Lower manual browsing effort on ClawHub.
- Better skill stack diversity through complementarity scoring.
- Safer adoption via bounded install count and runnable checks.
Usage
node skills/skill-hunter/src/hunt.jsCommon Commands
# 1) Full automatic patrol
node skills/skill-hunter/src/hunt.js --auto
# 2) Targeted hunt for a specific unresolved problem
node skills/skill-hunter/src/hunt.js --query "Cannot reliably fetch web pages and summarize key insights"
# 3) Preview only (no write/install)
node skills/skill-hunter/src/hunt.js --dry-run
# 4) Cap per-run installation count
node skills/skill-hunter/src/hunt.js --max-install 2Core Workflow
- Extract unresolved problems and topic signals from recent chat/session memory.
- Search ClawHub with trending feeds and query endpoints.
- Score candidates with multi-factor ranking:
- issue relevance - profile and personality fit (USER.md + personality state) - complementarity with already installed skills - quality signals such as stars/downloads (when available)
- Install top candidates with a runnable entry and self-test fallback.
- Produce a concise recommendation report with strengths, scenarios, and selection reasons.
Best-Fit Scenarios
- A user asks for a task that current skills cannot solve well.
- Recent sessions show repeated failures or unresolved tickets.
- The agent needs proactive capability growth without manual curation.
- The team wants a lightweight "discover -> test -> keep/remove" loop.
Operating Modes
- Auto patrol mode:
--autofor periodic capability growth. - Targeted mode:
--query "..."when a specific user problem is known. - Safe preview mode:
--dry-runbefore enabling real installs.
Recommended Execution Policy
- Start with
--dry-runin new environments. - Use
--max-install 1~2to avoid noisy bulk installs. - Re-run with a focused
--querywhen no candidate passes threshold. - Keep only skills that survive at least one real task run.
Scheduled Trigger Recommendation
For continuous value, run Auto Skill Hunter on a timer:
- Every 30 min for high-change or fast-moving projects
- Every 60 min for normal workflows
- Every 120 min for stable environments
This cadence keeps capability coverage fresh and reduces reaction lag when new user needs appear.
Suggested Cron-Style Routine
# High-change projects
*/30 * * * * node /path/to/workspace/skills/skill-hunter/src/hunt.js --auto --max-install 1
# Normal projects
0 * * * * node /path/to/workspace/skills/skill-hunter/src/hunt.js --auto --max-install 2Installation Policy
- Defaults to max 2 installations per run (configurable with
--max-installor env). - Skips already-installed skills.
- Falls back to scaffold mode when remote clone fails.
Safety and Quality Guardrails
- Never overwrite existing skill folders.
- Prefer small, frequent patrols over large one-shot installs.
- Keep report output concise and action-oriented.
- Disable outbound reporting during local tests with
SKILL_HUNTER_NO_REPORT=1.