- 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 skill2Dimensions 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: LOWNotes
- Run from any directory containing skills
- Pure Python - no pip install needed
- Safe to run on any skill
- Does not modify analyzed skills