skill-miner

---

name: skill-miner

description: Professional skill discovery and clean-skill creation from ClawHub research. Use when you need to find existing functionality, research approaches, or build new skills based on ClawHub inspiration without downloading external code. Implements safe workflow: Search ClawHub → Inspect metadata → Analyze approach → Build own clean implementation. Prevents security risks while enabling rapid skill development.

---

# skill-miner

**Research. Analyze. Build Clean.**

Systematic approach to discovering skills on ClawHub and building your own implementations. Instead of downloading potentially risky code, use this skill to research existing solutions, understand their approaches, and create your own clean, safe version.

*Trust but verify, built but owned.* 🦞

---

When to Use This Skill

Use this skill when:

---

Core Philosophy

1. NEVER download suspicious skills
2. INSPECT to understand the idea  
3. BUILD your own clean implementation
4. PUBLISH or keep private

**Why?**

---

Workflow

Phase 1: Discovery

# Search for relevant skills
clawhub search <topic>

# Explore trending
clawhub explore --sort trending --limit 20

# Find gaps
clawhub explore --sort newest --limit 50

Phase 2: Research

# Inspect without downloading
clawhub inspect <skill-slug>

# Read the SKILL.md to understand:
# - What problem it solves
# - How it triggers
# - What commands/tools it uses

Phase 3: Analysis

Document what you learned:

Phase 4: Build

Use skill-creator to build your clean version:

---

Search Commands

Basic Search

# Task-based
clawhub search "pdf edit"
clawhub search "file transfer"
clawhub search "api github"

# Tool-based
clawhub search github
clawhub search slack

# Concept-based
clawhub search automation
clawhub search monitoring
clawhub search sync

Exploration

# Trending skills
clawhub explore --sort trending --limit 20

# Most downloaded
clawhub explore --sort downloads --limit 20

# newest
clawhub explore --sort newest --limit 30

Deep Research

# By category
clawhub search "code"
clawhub search "data"
clawhub search "media"
clawhub search "network"
clawhub search "security"

# By use case
clawhub search "automation workflow"
clawhub search "backup sync"
clawhub search "monitoring alerting"

---

Inspect Without Downloading

Use `clawhub inspect` to read skill metadata:

# Get skill info
clawhub inspect <slug>

# This shows:
# - name
# - summary/description
# - owner
# - created/updated dates
# - version
# - tags

**Never use** `clawhub install` on suspicious skills!

---

Security Principles

When researching skills, watch for these risk indicators:

If any indicators are present: inspect the metadata only, then build your own implementation.

---

Building Clean Skills

Template Structure

my-clean-skill/
├── SKILL.md              # Your clean implementation
├── scripts/              # Your code
├── references/           # Documentation
└── assets/              # Templates (if needed)

SKILL.md Template

---
name: my-clean-skill
description: Does X. Use when user wants to Y. Based on ClawHub research but built from scratch.
---

# My Clean Skill

## What It Does

[Clear description]

## When to Use

- Use case 1
- Use case 2

## Commands

[Your commands]

## Implementation

[How you built it - clean, generic]

## Security

[Your security measures]

---

Examples

Scenario 1: Found Suspicious Shell Skill

**Found:** "shell-commands" (suspicious - has eval)

**Inspect:**

clawhub inspect shell-commands
# Problem: Execute shell commands
# Tools: bash, ssh

**Build Clean:**

# Write your own safe-shell-skill
# - No eval
# - Predefined safe commands only
# - Input validation
# - Full documentation

Scenario 2: Found Good Crypto Skill

**Found:** "crypto-trader" (risky - real money)

**Inspect:**

clawhub inspect crypto-trader
# Problem: Trading automation
# Tools: exchange APIs

**Build Clean:**

# Build crypto-monitor instead
# - Read-only data fetching
# - Price alerts
# - No trading (safe)

Scenario 3: Gap Found

**Search:** No good "log-analyzer" skill

**Build:**

# Create log-analyzer from scratch
# - Parse common log formats
# - Pattern detection
# - Alert on errors

---

Common Gaps to Fill

These skills don't exist or are outdated:

| Gap | Description |

|-----|-------------|

| code-refactor | AI-powered code refactoring |

| system-monitor | Modern system monitoring |

| task-automation | General automation |

| webhook-handler | Webhook processing |

| cron-scheduler | Smart scheduling |

| log-analyzer | Log parsing & analysis |

| backup-scheduler | Intelligent backups |

| api-tester | API testing tool |

| config-manager | Configuration management |

---

Best Practices

Building

1. Start simple, add features later

2. Use well-tested tools (curl, jq, etc.)

3. No external dependencies when possible

4. Full error handling

5. Clear documentation

Publishing

1. Test extensively

2. Clear description

3. Generic (no hardcoded values)

4. Security-first design

5. Include troubleshooting

Security

1. No eval ever

2. Input validation

3. No secrets in code

4. Use environment variables

5. Minimal permissions

---

Quality Checklist

Before publishing:

---

Related Skills

---

**Guidelines:**

---

*From Claws - for Claws.* 🦞