Skill Master

Minimum Model

Any model. This is a lookup table — any model can use it.

⚠️ Skill Count Rule

Current: 19 active skills. Sweet spot: 15–25. Above 30 = routing breaks down. Start lean. Add a new skill only when there's a clear, recurring trigger that no existing skill covers.

How to Use This Skill

Read the owner's request.
Find a match in the Quick Lookup table below.
If not found, use the Decision Tree.
⚠️ Log the selection FIRST — before doing any work (see Analytics below).
Load that skill's SKILL.md and follow it.

Do not improvise. If no skill matches, say so and ask the owner.

❌ Skipping the log is not allowed. Every skill invocation must be recorded, even for simple tasks. This is how the agent and the owner track what's working.

📊 Analytics — MANDATORY: Log Every Skill Use

This step is NOT optional. Before starting any skill, append one line:

mkdir -p /opt/ocana/openclaw/workspace/data
echo "{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"skill\":\"SKILL_NAME\",\"trigger\":\"TRIGGER\",\"context\":\"CONTEXT\"}" \
  >> /opt/ocana/openclaw/workspace/data/skill-analytics.jsonl

Replace:

SKILL_NAME → the skill selected (e.g. meetings)
TRIGGER → the phrase that matched (e.g. schedule meeting with Daniel)
CONTEXT → dm, group:<name>, or cron

This is ~50 bytes/entry. Non-negotiable.

Why This Matters

The owner can ask "skill stats" at any time to see what's being used
Unused skills get pruned, improving routing quality
Shared across the PA network so every agent learns from usage patterns
Enables weekly reports on which skills are carrying the most weight

To View Analytics

Ask: "skill stats" / "skill usage" / "which skills am I using?" → triggers skill-analytics skill

Quick Lookup — By Trigger Phrase

| If the owner says... | Use skill | |---|---| | "schedule a meeting with X" | meetings | | "summarize meeting notes" / "action items from meeting" | meetings | | "what's on my calendar today" | owner-briefing | | "send me a morning briefing" | owner-briefing | | "billing error" / "API out of credits" | billing-monitor | | "connect my calendar" / "can't write to calendar" | calendar-setup | | "connect Gmail" / "set up email" | calendar-setup | | "set up a new PA" / "onboard a new agent" | pa-onboarding | | "contact [person]'s PA" / "find PA phone number" | ai-pa | | "set up monday.com" / "create a board item" / "monday question" | monday-for-agents | | "I made a mistake" / "owner corrected me" | self-learning | | "backup workspace" / "push to git" | maintenance | | "update openclaw" / "update skills" / "run maintenance" | maintenance | | "what was discussed in [group]" | whatsapp | | "find new skill ideas" / "what skills are trending" | skill-scout | | "skill usage" / "skill stats" / "skill report" | skill-analytics | | "which skills am I using" / "unused skills" | skill-analytics | | "security check" / "check for vulnerabilities" | self-monitor | | "health check" / "check infrastructure" | self-monitor | | "how are all the PAs doing" / "PA network status" | supervisor | | "מה הסטטוס" / "what's the status" | supervisor | | "how am I doing" / "review my performance" | eval | | "run eval" / "מה עובד ומה לא" | eval | | "summarize this YouTube video" | youtube-watcher | | "add nikud to this" / "Hebrew vowel points" | hebrew-nikud | | "compact memory" / "organize memory" | memory-tiering |

Decision Tree

What kind of task is this?
│
├─ COMMUNICATION / COORDINATION
│   ├─ Find a PA's contact → ai-pa
│   ├─ Schedule a meeting → meetings
│   ├─ Summarize meeting notes → meetings
│   └─ Broadcast to all PAs → ai-pa
│
├─ SETUP / ONBOARDING
│   ├─ New PA from scratch → pa-onboarding
│   ├─ Connect Google Calendar or Gmail → calendar-setup
│   └─ Connect monday.com → monday-for-agents
│
├─ MONITORING / HEALTH
│   ├─ Billing error detected → billing-monitor
│   ├─ Infrastructure / security check → self-monitor
│   └─ Check all PAs at once → supervisor
│
├─ DAILY OPERATIONS
│   ├─ Morning/evening briefing → owner-briefing
│   ├─ monday.com board task → monday-for-agents
│   ├─ Backup workspace or update OpenClaw → maintenance
│   └─ WhatsApp conversation context → whatsapp
│
└─ SELF-IMPROVEMENT
    ├─ Owner corrected me → self-learning
    ├─ Performance review / audit → eval
    ├─ Find new skill ideas → skill-scout
    └─ Memory compaction → memory-tiering

Full Skill Library

| Skill | Category | When to Use | |---|---|---| | ai-pa | Coordination | Find PA contacts, group JIDs, coordination protocols | | billing-monitor | Health | Detect and respond to API billing failures | | calendar-setup | Setup | Calendar connection with write access + Gmail/email setup | | eval | Self-improvement | Full performance audit — scores tasks, checks PA health, reviews memory | | hebrew-nikud | Utility | Add nikud (vowel points) to Hebrew text, especially for TTS | | maintenance | Infrastructure | Workspace git backup (every 6h) + OpenClaw updates (weekly) | | meetings | Operations | Schedule meetings AND summarize meeting notes/transcripts | | memory-tiering | Memory | HOT/WARM/COLD memory compaction and archiving | | monday-for-agents | Operations | All monday.com operations: API, MCP, boards, items | | owner-briefing | Operations | Daily morning/evening summaries | | pa-onboarding | Setup | Full new agent setup from zero | | self-learning | Self-improvement | Log corrections and apply lessons; maintain HOT.md | | self-monitor | Health | Infrastructure + security checks, disk/memory/service health | | skill-master | Routing | Pick the right skill (this file) | | skill-scout | Discovery | Weekly search for new skill ideas | | supervisor | Operations | Network-wide status dashboard — all PAs, tasks, system health | | whatsapp | Memory | Per-conversation context, unanswered tracking, loop prevention | | youtube-watcher | Utility | Fetch and summarize YouTube video transcripts | | skill-analytics | Analytics | Track skill usage, generate daily reports, find unused skills |

Multi-Skill Workflows

Some tasks need multiple skills in sequence:

New PA Setup

pa-onboarding → calendar-setup → monday-for-agents → ai-pa (add to directory)

PA Network Health Check

supervisor → billing-monitor (flagged PAs) → self-monitor (infrastructure issues)

After a Mistake

self-learning (log it) → eval (update score) → SOUL.md (add rule if pattern)

Schedule a Meeting

ai-pa (find the other PA's contact) → meetings (coordinate + book)

Weekly Maintenance

whatsapp (weekly digest) → owner-briefing (include highlights) → maintenance (push to git)

After Important Group Chat

whatsapp (log decisions) → maintenance (push to GitHub)

Where to Run (Complexity Guide)

Run inline (main session)

ai-pa, billing-monitor, owner-briefing, supervisor, self-learning, maintenance

Consider subagent for heavy operations

calendar-setup, meetings (scheduling flow), monday-for-agents (bulk ops)

Spawn subagent (recommended)

pa-onboarding (20+ steps), eval (full monthly analysis), batch operations, skill-scout

Model Guidance

| Skill | Minimum Model | |---|---| | ai-pa, billing-monitor, supervisor, maintenance, owner-briefing | Any | | calendar-setup, pa-onboarding, whatsapp, memory-tiering | Small–Medium | | meetings, monday-for-agents, skill-scout | Medium | | eval (trend analysis), self-learning (writing rules) | Medium–Large |

Adding New Skills

When a new skill is added:

Add a row to the Full Skill Library table.
Add trigger phrases to Quick Lookup.
Update the Decision Tree if it fits a new category.
Add to any relevant Multi-Skill Workflows.
Check skill count — stay under 32 active skills.
Add the skill name to the KNOWN_SKILLS list in skill-analytics/SKILL.md.

Supervisor (Status Dashboard)

| Trigger | Action | |---|---| | "מה הסטטוס" / "what's the status" | supervisor | | "supervisor" | supervisor | | "מה קורה" / "give me a summary" | supervisor |

The supervisor skill aggregates: active tasks, billing issues, group activity, pending follow-ups, and system health into one structured report.

Eval

| Trigger | Action | |---|---| | "תעשי eval" / "run eval" | eval | | "מה עובד ומה לא" | eval | | "בדקי הכל" | eval |

The eval skill scores performance, audits tasks, checks PA network health, verifies integrations, and reviews memory quality — all in one report.

Cost Tips

This skill itself: Very cheap — it's a lookup table, any model works.
Routing decision: If unsure, lean toward a smaller, cheaper skill first.
Don't over-spawn: Use subagents only when the task would actually block the main session.