| name | skill-store |
| description | Smart skill installation advisor for ClawHub. Searches for skills matching your needs, evaluates candidates on security (via skill-shield), code quality, and documentation, then produces a comparison report with a recommendation. Use when: looking for a skill to do something specific, comparing similar skills, or wanting a safety-checked recommendation before installing. Zero external dependencies. |
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
python3 scripts/evaluate.py "weather forecast"
python3 scripts/evaluate.py "image generation" --top 3 --output-dir ./reports
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 comparisonreport.json — structured evaluation data
How It Works
- Searches ClawHub for skills matching your query
- Installs top N candidates into a temporary directory
- Runs skill-shield security scan on each candidate
- Evaluates code quality (lines of code, documentation, tests, structure)
- Scores and ranks candidates (security 40%, quality 30%, relevance 30%)
- Generates comparison report with recommendation
- 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 authenticatedskill-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 |
