Skill Priority Setup

Automated skill tiering and injection policy configuration for OpenClaw.

What This Skill Does

1. Discovery Phase: Scans all installed skills across standard directories
2. Analysis Phase: Suggests L0-L3 tier assignments based on skill characteristics
3. Configuration Phase: Applies the tiered architecture to your setup
4. Validation Phase: Verifies configuration and estimates token savings

Quick Start

# Run the interactive setup wizard
python3 ~/.openclaw/workspace/skills/skill-priority-setup/scripts/setup.py

# Or non-interactive mode with defaults
python3 ~/.openclaw/workspace/skills/skill-priority-setup/scripts/setup.py --auto

When to Use

• New Setup: Just installed multiple skills and want optimal configuration
• Performance Issues: High token usage or slow responses
• Migration: Upgrading from flat skill structure to tiered architecture
• Audit: Reviewing and optimizing existing skill priorities

Architecture Overview

This skill implements a 4-tier priority system:

L0 - ROM Core (Always Active)

• semantic-system: Semantic routing (message injector)
• agent-evolution: Self-improvement behaviors (SOUL.md)
• config-modification: Config safety (on-demand)
• skill-safe-install: Installation safety (on-demand)

L1 - Routing Layer (Task-Triggered)

• browser-automation: Web automation
• find-skills: Skill discovery
• teamtask: Multi-agent coordination

L2 - Domain Skills (Keyword-Triggered)

• Document: word-docx, tesseract-ocr
• Media: youtube-transcript
• Platform: discord, wechat-suite, evomap
• Automation: automation-workflows

L3 - Extensions (Manual/On-Demand)

• Third-party integrations: notion, slack, github, etc.

Workflow

┌─────────────────┐
│ 1. Scan Skills  │ → Find all SKILL.md files
└────────┬────────┘
         ▼
┌─────────────────┐
│ 2. Analyze      │ → Detect skill types & dependencies
└────────┬────────┘
         ▼
┌─────────────────┐
│ 3. Suggest Tiers│ → Propose L0-L3 assignments
└────────┬────────┘
         ▼
┌─────────────────┐
│ 4. User Review  │ → Confirm or modify suggestions
└────────┬────────┘
         ▼
┌─────────────────┐
│ 5. Apply Config │ → Update AGENTS.md, SOUL.md, etc.
└────────┬────────┘
         ▼
┌─────────────────┐
│ 6. Validate     │ → Check JSON, test injection
└─────────────────┘

Token Budget

• L0 Core: ≤300 tokens/round (minimal rules)
• L1 Triggered: ≤400 tokens per injection
• Total Budget: ≤900 tokens/round
• Overflow Strategy: Inject summary + file path only

Safety Features

• Backup before any configuration changes
• JSON validation before applying
• Dry-run mode (--dry-run)
• Rollback capability

Files Created

• SKILL_PRIORITY_POLICY.md: Your custom policy document
• AGENTS.md updates: Core constraints added
• SOUL.md updates: Agent evolution behaviors
• Backup files: .backup/*.timestamp

Configuration

Edit ~/.openclaw/workspace/skills/skill-priority-setup/config.yaml to customize:

# Default tier assignments (override per skill)
default_tiers:
  semantic-router: L0
  browser: L1
  word-docx: L2
  
# Token budgets
token_budget:
  l0_max: 300
  l1_max: 400
  total_max: 900
  
# Safety settings
backup_before_change: true
validate_json: true
auto_rollback: true

Troubleshooting

Gateway Won't Start

• Check if message injector content exceeds limit
• Run with --diagnose flag

Skills Not Loading

• Verify allowBundled list in openclaw.json
• Check file permissions

High Token Usage

• Review L0 assignments (should be minimal)
• Consider moving skills to lower tiers

References

• Original Implementation: SKILL_PRIORITY_POLICY.md
• OpenClaw Docs: https://docs.openclaw.ai/skills