aaaaqwq/dispatcher

Dispatcher

MANDATORY first step before selecting any skill. Contains the complete routing table for all 61+ skills. The system prompt only shows ~50 skills — this file is the single source of truth.

IMPORTANT: Always Load First

Claude Code has a ~50 skill limit in the system prompt. Skills beyond this limit are silently dropped. The dispatcher contains the COMPLETE routing table. Always consult this file before choosing a skill, especially for:

• Sending emails → email-send-direct (NOT email-send-bulk)
• Call preparation → call-prep
• Document/rekvizity requests → documents

When to use

• ALWAYS — before selecting a skill for any task
• Task requires 2+ skills (e.g.: query CRM -> send telegram)
• It's unclear which skill is needed
• An execution plan is needed for a complex task

Step 1: Analyze the task

Determine:

• Domain: CRM, PM, Sales, Channels, Finance, Dev, Infra, Legal, Agents?
• Action: read, create, update, send, review, deploy, monitor?
• Object: company, person, task, message, invoice, document, agent?

Step 2: Skill Routing Table

CRM — Contacts & Relationships

| Trigger | Skill | |---------|-------| | Add new company/person/lead | add-lead | | Update lead status, notes, contacts | update-lead | | Search, filter, reports on CRM data | query-leads | | Import data from staging to CRM | crm-import | | Log email/call/meeting activity | log-activity | | Validate CRM/PM changes before PR | change-review |

PM — Tasks & Projects

| Trigger | Skill | |---------|-------| | "What should I do today?" / priority tasks | show-today | | Morning briefing (tasks + email + follow-ups) | daily-briefing | | Weekly project review report | weekly-review | | Create new project with task breakdown | create-project | | Mark task done + schedule follow-up | pm-done | | Task prioritization and scoring | task-prioritization |

Sales — Consulting & Client Work

| Trigger | Skill | |---------|-------| | Prepare for a call with client/lead | call-prep | | Analyze client requests → scoping + pricing | client-discovery | | Create client folder, share docs, pre-call check | client-workspace | | Multi-channel outreach (TG + email + WhatsApp) | mass-outreach |

Channels — Communication

| Trigger | Skill | |---------|-------| | Send single email (with dry-run, reply, attachments) | email-send-direct | | Bulk email sending | email-send-bulk | | Read inbox / sent emails via Gmail API | email-read | | AI inbox classification + TG notification | email-monitor | | Send Telegram DM (CSV, rate-limited) | telegram-send | | Check inbound Telegram messages | telegram-check | | Export/import/lookup Telegram contacts | telegram-contacts | | Telegram group management (post, members) | telegram-groups | | Search Telegram channels, read posts | telegram-scrape | | Send WhatsApp message (Baileys) | whatsapp-send | | LinkedIn automation (mouse/keyboard, CDP) | linkedin-cdp | | Connect to AI agent via MCP | mcp-agent-connect |

Finance — Invoices & Payments

| Trigger | Skill | |---------|-------| | Generate invoice (manual, no CRM) | invoice | | Auto-generate invoice with CRM integration | invoice-generator-agent | | Track expenses, export data | expense-tracker | | Stripe webhook management (AI Kitchen Pro) | stripe-webhook |

Dev — Code & Deployment

| Trigger | Skill | |---------|-------| | AI code review for PR or local changes | code-review | | Git: branch, PR, merge, cleanup | git-workflow | | Deploy website via GitHub PR + Cloud Build | deploy-website |

Infra — Tools & Auth

| Trigger | Skill | |---------|-------| | Google OAuth setup / refresh tokens | google-auth | | Google Drive: upload, folders, share, create doc | google-drive | | Facebook CDP automation (comments, data) | infra-facebook-cdp | | Create/update Telethon session | telegram-session | | ttyd + Tailscale for mobile terminal access | remote-access |

Legal

| Trigger | Skill | |---------|-------| | Review NDA, contracts, agreements | legal-review |

Agents — Autonomous Runners

| Trigger | Skill | |---------|-------| | Build agent from spec | agent-builder | | Test agent (dry-run, unit, integration) | agent-tester | | Process analysis, gap finding, spec generation | process-analyst | | Auto: daily briefing | daily-briefing-run | | Auto: weekly review | weekly-review-run | | Auto: email outreach | email-outreach-run | | Auto: Telegram inbound processing | telegram-inbound-run | | Auto: Telegram scraping | telegram-scraper-run | | Auto: LinkedIn inbound processing | linkedin-inbound-run | | Auto: WhatsApp outreach | whatsapp-outreach-run | | Auto: channel/contact sync | channel-truth-run | | Auto: lead trigger monitoring | watchers-run | | Auto: payment tracking | payment-tracker-run | | Auto: experiment runner | experiment-runner-run |

Documents & Data

| Trigger | Skill | |---------|-------| | Send rekvizity, passport data, INN | documents | | Upload document scans to Drive | documents | | "де мої документи?" / company data | documents |

Core — Always Available

| Trigger | Skill | |---------|-------| | Persistent memory (observations, summaries) | memory | | Timezone conversion, local time | timezone | | Company knowledge base (domains, infra, accounts) | company-wiki | | AI agent contacts (add, list, remove MCP) | agent-contacts |

Step 3: Multi-Skill Orchestration

Examples of combinations:

"Send all clients a message about new prices"

1. query-leads → get clients (relationships/clients.csv)
2. For each → find contact (contacts/people.csv)
3. telegram-send / email-send-bulk → send
4. log-activity → record in activities.csv

"Good morning, what's new?"

1. daily-briefing → tasks + email + follow-ups

"Prepare for a call with X and send the agenda"

1. call-prep → research + plan (includes workspace check)
2. email-send-direct → send agenda
3. log-activity → record activity

"Client sent a list of automation requests"

1. query-leads → get CRM context
2. client-discovery → analyze requests, estimate hours, prioritize
3. client-workspace → create shared questionnaire doc
4. log-activity → record activity

"Set up folder for new client"

1. query-leads → get company + contact email
2. client-workspace → create folder structure + share
3. log-activity → record activity

"Generate and send invoice to client"

1. query-leads → get client + billing info
2. invoice-generator-agent → generate invoice
3. google-drive → upload to client folder
4. email-send-direct → send to client
5. log-activity → record

"Deploy website changes"

1. code-review → check changes
2. git-workflow → branch + PR
3. deploy-website → deploy via Cloud Build

"Review this NDA and send feedback"

1. legal-review → analyze document
2. email-send-direct → send feedback
3. log-activity → record

"Send rekvizity / passport data to partner"

1. documents → read structured data blocks
2. email-send-direct → send (reply to thread)
3. log-activity → record

"User provides document scans"

1. documents → extract data, upload scans to Drive
2. Update passport_data.md with structured data

Step 4: Execute

• Simple task → execute immediately
• Complex task → load skill via Read tool
• Multi-step → create a plan, execute sequentially

Post-Execution Checklist

After executing a task that modifies data:

What changed?
      │
      ├── DATA (CSV in CRM/PM)?
      │         ↓
      │    change-review → git-workflow
      │
      └── CODE (*.py, *.js, *.md)?
                ↓
           code-review → git-workflow

If there was outreach (email/telegram/call):

1. Add a record in activities.csv (log-activity)
2. Update task in pm_tasks_master.csv
3. change-review → PR → merge

If CRM/PM data was modified:

1. Validation against schema.yaml
2. change-review → PR → merge

If code or skills were modified:

1. code-review → PR → merge

Data Paths

| Domain | Path | |--------|------| | CRM | $CRM_PATH/ | | PM | $PM_PATH/ | | CRM Schema | sales/crm/schema.yaml (always read first for CRM tasks) |

New Skill Registration Checklist

When creating a new skill, ALWAYS complete ALL steps:

1. Create SKILL.md in ~/claude-skills/skills/{category}/{skill-name}/SKILL.md

   • Use template: ~/claude-skills/skills/TEMPLATE.md
   • Must have frontmatter with name and description

2. Create symlink: ln -s ~/claude-skills/skills/{category}/{skill-name} ~/.claude/skills/{skill-name}

3. Update THIS dispatcher:

   • Add to the correct section in Step 2 Routing Table
   • Add orchestration example in Step 3 if relevant

4. Verify discovery:

   • Check if skill appears in system prompt (it won't if >50 skills)
   • If NOT visible — that's OK, dispatcher covers it

5. Commit via git-workflow: branch → PR → merge

CRITICAL: Steps 3-4 are what gets forgotten. If you skip updating the dispatcher, the skill becomes invisible when the system prompt drops it.

When dispatcher is NOT needed

• User explicitly says which skill ("load telegram-send")
• Simple answer to a question (no actions required)
• Continuation of a previous task (context already exists)