Back to skills
extension
Category: Security & ComplianceNo API key required

Skill

Smart skill installation advisor for ClawHub. Searches for skills matching your needs, evaluates candidates on security (via skill-shield), code quality, and...

personAuthor: yx2601816404-syshubclawhub

Skill Store — Smart Installation Advisor

Find the right skill without the guesswork. Searches ClawHub, evaluates candidates on security + quality, and recommends the best one.

Usage

python3 scripts/evaluate.py "your search query" [options]

Examples

# Find a weather skill
python3 scripts/evaluate.py "weather forecast"

# Evaluate top 3 only, save reports
python3 scripts/evaluate.py "image generation" --top 3 --output-dir ./reports

# Use a specific skills workspace for clawhub
python3 scripts/evaluate.py "security audit" --workdir /path/to/workspace

Options

| Option | Default | Description | |--------|---------|-------------| | --top N | 5 | Number of candidates to evaluate | | --output-dir DIR | (stdout) | Save report.md and report.json to DIR | | --workdir DIR | /tmp/skill-store-eval-* | Working directory for clawhub install | | --scanner PATH | auto-detect | Path to skill-shield's scan.py | | --keep-all | false | Don't uninstall non-recommended candidates |

Output

Prints a Markdown comparison report to stdout. With --output-dir, also writes:

  • report.md — human-readable comparison
  • report.json — structured evaluation data

How It Works

  1. Searches ClawHub for skills matching your query
  2. Installs top N candidates into a temporary directory
  3. Runs skill-shield security scan on each candidate
  4. Evaluates code quality (lines of code, documentation, tests, structure)
  5. Scores and ranks candidates (security 40%, quality 30%, relevance 30%)
  6. Generates comparison report with recommendation
  7. Uninstalls non-recommended candidates (unless --keep-all)

Scoring

| Dimension | Weight | What's measured | |-----------|--------|-----------------| | Security | 40% | skill-shield rating, findings count, permission audit | | Quality | 30% | Code lines, SKILL.md completeness, README, tests | | Relevance | 30% | clawhub search score (normalized) |

Requirements

  • clawhub CLI installed and authenticated
  • skill-shield scan.py accessible (auto-detected from sibling directory or via --scanner)
  • Python 3.8+

Exit Codes

| Code | Meaning | |------|---------| | 0 | Recommendation made successfully | | 1 | No candidates found or all evaluations failed |