Skill Reviewer

Comprehensive skill review and validation for OpenClaw skills.

Overview

This skill provides a systematic three-level review process to ensure skills are: - Valid - Proper structure and format - Complete - All required components present - Correct - Generated outputs match OpenClaw specifications - High-quality - Follows best practices

Review Workflow

Level 1: Format Validation

Run automatic validation using package_skill.py:

python3 /home/yupeng/.npm-global/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py <skill-path>

Checks: - YAML frontmatter format and required fields - Skill naming conventions and directory structure - Description completeness and quality - File organization and resource references

Outcome: ✅ Valid or ❌ Validation errors

Level 2: Content Quality Assessment

Manually review SKILL.md for:

Frontmatter: - name is concise and follows naming conventions - description is comprehensive and includes "when to use" information - No extraneous fields in YAML

Body Structure: - Clear organization (workflow-based, task-based, or reference-based) - Progressive disclosure pattern (metadata → SKILL.md → references) - Concise and focused content - Imperative/infinitive form for instructions

Writing Quality: - No filler or redundant explanations - Concrete examples and realistic scenarios - Clear guidance on when to read reference files - Avoids duplication between SKILL.md and references

Level 3: Functional Verification

Critical Step - Verify that generated outputs match actual OpenClaw specifications.

For skills that generate templates: - Compare generated templates with actual OpenClaw specification files - Example: If skill generates AGENTS.md templates, compare with /home/yupeng/.openclaw/workspace/AGENTS.md - Check for missing required sections (session startup, memory workflow, safety rules, group chat etiquette, heartbeat mechanism) - Verify all critical requirements are present

For skills with scripts: - Test scripts to ensure they work correctly - Verify output matches expected format - Check error handling

For skills with references: - Verify reference files are accurate and up-to-date - Check that references are properly linked from SKILL.md

Level 4: Best Practices Check

Verify the skill follows OpenClaw skill best practices:

Progressive Disclosure: - SKILL.md body is concise (<500 lines preferred) - Detailed information moved to references/ - References are properly linked and described

Resource Organization: - Only necessary resource directories created - No extraneous files (README.md, INSTALLATION_GUIDE.md, etc.) - Scripts/ references/ assets/ used appropriately

Context Efficiency: - Information lives in either SKILL.md OR references, not both - Essential procedural instructions in SKILL.md - Detailed reference material in references/

Triggering Accuracy: - description clearly states when the skill should be used - All "when to use" information is in description, not body

Common Issues Found

Missing Functional Verification: - Skill generates templates but they don't match actual specifications - Example: AGENTS.md template missing session startup requirements

Incomplete Descriptions: - Description doesn't include "when to use" information - Body contains "When to Use This Skill" sections (should be in description)

Duplication: - Same information in both SKILL.md and references - Wastes context window tokens

Extraneous Files: - README.md, CHANGELOG.md, etc. in skill directory - Should only contain SKILL.md and necessary resources

Poor Progressive Disclosure: - SKILL.md too verbose - References not properly linked or described

Review Checklist

For each skill, verify:

• [ ] Level 1: Format validation passes
• [ ] Level 2: SKILL.md structure and quality are good
• [ ] Level 3: Generated templates match OpenClaw specifications
• [ ] Level 4: Best practices are followed
• [ ] No extraneous files
• [ ] Description includes "when to use" information
• [ ] References are properly linked from SKILL.md
• [ ] Scripts work correctly (if present)

Resources

scripts/

• review_skill.py - Automated review script (optional enhancement)

references/

• openclaw-specs.md - OpenClaw specifications for comparison
• best-practices.md - Skill design best practices