tessl-labs/skill-optimizer

Improves your SKILL.md using tessl skill review plus validation and context. Reads skill bundle (SKILL.md + related files), validates syntax, explains WHY changes help, catches mistakes. Use when improving your own skill, skill file, skill description, reviewing skill quality, skill scoring, making your skill better, or learning the skill rubric.

1.25x

Quality

100%

Does it follow best practices?

Impact

88%

1.25x

Average score across 12 eval scenarios

Skill Optimizer Reference

Name: tessl-labs/skill-optimizer
Rating: 0.892 (1 reviews)
Author: tessl-labs

Validation Examples

Python Syntax Validation

import ast

def validate_python(code: str) -> bool:
    """Validate Python code syntax"""
    try:
        ast.parse(code)
        return True
    except SyntaxError as e:
        print(f"✗ Syntax error: {e}")
        return False

# Example
code = '''
import requests
response = requests.get("https://api.example.com/users")
response.raise_for_status()
data = response.json()
'''
validate_python(code)  # Returns True

Command Flag Validation

# Validate gh command flags
validate_gh_flag() {
    local flag="$1"
    gh pr create --help | grep -q "$flag" && echo "✓ Valid" || echo "✗ Invalid"
}

validate_gh_flag "--title"      # ✓ Valid
validate_gh_flag "--params"     # ✗ Invalid (should be --parameter)

File Reference Validation

# Check if referenced files exist
SKILL_DIR="$(dirname path/to/SKILL.md)"

for link in $(grep -oE '\[.*\]\(([^)]+)\)' SKILL.md | cut -d'(' -f2 | cut -d')' -f1); do
    if [[ ! -f "$SKILL_DIR/$link" ]]; then
        echo "✗ Broken reference: $link"
    fi
done

JavaScript Validation

# Validate JavaScript syntax (requires Node.js)
validate_js() {
    local file="$1"
    node --check "$file" 2>&1 && echo "✓ Valid" || echo "✗ Syntax error"
}

Common Validation Mistakes

Issue	Example	Fix
Invalid flag	`gh pr create --params`	Use `--parameter`
Missing file	`[See GUIDE.md](GUIDE.md)`	Create file or remove link
Python syntax	`response = requests.get(url`	Add closing `)`
Broken command	`npm install --save-dev`	Use `npm install -D` (modern)

Recommendation Template

## [Action]

Current: [Dimension] X/3 ([Category]: Y%)
Impact: +Z% overall ([Dimension] X→Y)

Before: [current text]
After: [improved text]

Why: [Explain dimension weight and why this helps routing/clarity/etc]

Install with Tessl CLI

npx tessl i tessl-labs/skill-optimizer