auto-skill-hunter

---
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

```bash
node skills/skill-hunter/src/hunt.js
```

### Common Commands

```bash
# 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 2
```

## Core Workflow

1. Extract unresolved problems and topic signals from recent chat/session memory.
2. Search ClawHub with trending feeds and query endpoints.
3. 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/downlo