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>, orcron
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]" | |
| "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 |
| 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_SKILLSlist inskill-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.