Clickup Operational

# ClickUp Operational Master Skill - Design Spec

## Core Philosophy

**Deterministic Operations Only** — Every command either succeeds with clear confirmation or fails with explicit error. No ambiguous states. No silent failures. Full validation at every step.

## Embedded Knowledge Base

This skill contains the **complete ClickUp API documentation** internally:
- All 50+ API endpoints
- Request/response schemas
- Rate limits (100 req/min)
- Error codes and handling
- Webhook patterns
- Best practices from official docs

**MCP Context** — Included as documented fallback for edge cases only (complex workspace templates, bulk operations exceeding rate limits, cross-workspace moves).

## Operational Capabilities

### 1. Natural Language Parsing → Structured Commands
```
Input: "Create a project for Acme Corp with onboarding, web design, and monthly retainer phases"
Parse: 
  - workspace: Delivery
  - client: Acme Corp
  - structure: folder → 3 lists (onboarding, web-design, retainer)
  - assignees: find by email/name
  - due dates: infer from phases
  - custom fields: budget, priority, status
  
Execute: deterministic sequence with rollback on failure
Verify: each list created, each task present, assignments correct
Confirm: "Project Acme Corp created with 3 phases, 12 tasks, assigned to George & Matthew, due 2026-03-15"
```

### 2. Progress Diagnosis & Timeline Estimation
```
Input: "What's blocking the Scent of a Milien project?"
Flow: 
  - Scan all tasks in folder
  - Identify status: blocked, overdue, no-assignee
  - Check dependencies: waiting on other tasks
  - Estimate completion: based on task complexity, assignee velocity
  - Report: "3 tasks blocked (waiting on George's video edits). ETA: +5 days. Suggest: reassign or parallelize"
```

### 3. Assignment Orchestration
```
Input: "Get Sharyar and Matthew on the Kortex onboarding task"
Flow:
  - Find Sharyar (check existing members or invite)
  - Find Matthew (check existing or invite)
  - Locate Kortex onboard...