dispatcher

$npx mdskill add aAAaqwq/AGI-Super-Team/dispatcher

Dispatches complex tasks by routing to the correct skill.

  • Prevents skill selection errors when multiple actions are needed.
  • Accesses the complete routing table beyond system prompt limits.
  • Analyzes domain, action, and object to determine the right skill.
  • Outputs a clear execution plan for multi-step workflows.

SKILL.md

.github/skills/dispatcherView on GitHub ↗
---
name: dispatcher
description: Route complex multi-step tasks, multi-skill orchestration, post-execution checklist
user-invocable: false
---
# 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)

More from aAAaqwq/AGI-Super-Team

SkillDescription
a-fund-monitor监控 A 股基金实时估值与盘后净值,自动判断交易日并生成提醒或分析。
add-leadAdd company/person/relationship to CRM
ads-agentAI-агент для управления Facebook рекламой. Вызывай для анализа, оптимизации, создания кампаний и отчётов.
afrexai-compliance-auditRun internal compliance audits against major governance and security
afrexai-personal-financeComplete personal finance system — budgeting, debt payoff, investing, tax optimization, net worth tracking, and financial independence planning. Use when managing money, building wealth, paying off debt, planning retirement, or optimizing taxes. Zero dependencies.
after-salesUse when managing post-purchase experience, building customer loyalty, or increasing repeat purchases
agent-contactsAI agent contacts — add, list, remove MCP contacts. Use when someone gives an agent URL, or when you need to view/remove contacts.
agent-model-switcher批量查看和切换子 agent 的模型配置,用于统一调整多 agent 的 provider/model 设置。
agent-patternsFormat SPAWN REQUEST messages to launch parallel agents, generate structured agent status reports, and define communication protocols within the sprint system. Use when the user needs to coordinate multiple agents, format spawn requests, produce agent reports, or establish inter-agent communication patterns.
agent-task-confirmUse when confirming whether a dispatched agent task was actually received, activated, and progressing after sessions_send or other task handoff actions.