skill-analyzer

name	skill-analyzer
description	Quality scanner for OpenClaw skills. Evaluates functionality, security, usability, documentation, and best practices with weighted scoring. Use when: (1) Analyzing skill quality before publishing, (2) Finding improvement opportunities, (3) Security review of third-party skills. Pure Python - no dependencies.

Skill Analyzer - Comprehensive Skill Analysis Tool

Overview

Skill Analyzer evaluates OpenClaw skills across 5 dimensions to provide a comprehensive quality assessment. It helps identify strengths, weaknesses, and improvement opportunities. Built with pure Python - no external dependencies required.

Analysis Dimensions (5 total)

1. Functionality Analysis (25%)

• Core features implementation completeness
• Edge cases handling
• Error handling and robustness
• Command-line interface quality

2. Security Analysis (25%)

• Input validation
• Credential handling
• No hardcoded secrets
• Safe execution patterns

3. Usability Analysis (20%)

• User experience quality
• Documentation clarity
• Installation complexity
• Example availability

4. Documentation Quality (15%)

• SKILL.md completeness
• Frontmatter (name, description)
• Usage examples
• Tag coverage

5. Best Practices (15%)

• Code structure and organization
• Error handling patterns
• Configuration management

Usage

Requirements

• Python 3.7+ (no external dependencies - uses only stdlib)

Analyze a Skill

# Analyze a local skill
python3 scripts/analyzer.py --path /path/to/skill

# Analyze with detailed output
python3 analyzer.py --path /path/to/skill --verbose

# Output to JSON
python3 analyzer.py --path /path/to/skill --output report.json

# Compare two skills
python3 analyzer.py --compare skill1 skill2

Dimensions Scoring

Each dimension is scored 0-10:

• 8-10: Excellent
• 6-7: Good
• 4-5: Average
• 2-3: Below Average
• 0-1: Poor/Needs Improvement

Example Output

==========================================
Skill Analysis Report: example-skill
==========================================

Overall Score: 7.5/10

Dimension Scores:
  Functionality:    8/10 ████████░░
  Security:         9/10 █████████░
  Usability:        7/10 ███████░░░
  Documentation:    6/10 ██████░░░░
  Best Practices:   7/10 ███████░░░

Strengths:
  ✓ Good security practices
  ✓ Clean code structure
  ✓ Proper error handling

Risk Level: LOW

Notes

• Run from any directory containing skills
• Pure Python - no pip install needed
• Safe to run on any skill
• Does not modify analyzed skills