{
  "schemaVersion": "1.0",
  "item": {
    "slug": "clickup-operational",
    "name": "Clickup Operational",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/aiwithabidi/clickup-operational",
    "canonicalUrl": "https://clawhub.ai/aiwithabidi/clickup-operational",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/clickup-operational",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clickup-operational",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "spec.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/clickup-operational"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/clickup-operational",
    "agentPageUrl": "https://openagent3.xyz/skills/clickup-operational/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clickup-operational/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clickup-operational/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Core Philosophy",
        "body": "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."
      },
      {
        "title": "Embedded Knowledge Base",
        "body": "This skill contains the complete ClickUp API documentation internally:\n\nAll 50+ API endpoints\nRequest/response schemas\nRate limits (100 req/min)\nError codes and handling\nWebhook patterns\nBest practices from official docs\n\nMCP Context — Included as documented fallback for edge cases only (complex workspace templates, bulk operations exceeding rate limits, cross-workspace moves)."
      },
      {
        "title": "1. Natural Language Parsing → Structured Commands",
        "body": "Input: \"Create a project for Acme Corp with onboarding, web design, and monthly retainer phases\"\nParse: \n  - workspace: Delivery\n  - client: Acme Corp\n  - structure: folder → 3 lists (onboarding, web-design, retainer)\n  - assignees: find by email/name\n  - due dates: infer from phases\n  - custom fields: budget, priority, status\n  \nExecute: deterministic sequence with rollback on failure\nVerify: each list created, each task present, assignments correct\nConfirm: \"Project Acme Corp created with 3 phases, 12 tasks, assigned to George & Matthew, due 2026-03-15\""
      },
      {
        "title": "2. Progress Diagnosis & Timeline Estimation",
        "body": "Input: \"What's blocking the Scent of a Milien project?\"\nFlow: \n  - Scan all tasks in folder\n  - Identify status: blocked, overdue, no-assignee\n  - Check dependencies: waiting on other tasks\n  - Estimate completion: based on task complexity, assignee velocity\n  - Report: \"3 tasks blocked (waiting on George's video edits). ETA: +5 days. Suggest: reassign or parallelize\""
      },
      {
        "title": "3. Assignment Orchestration",
        "body": "Input: \"Get Sharyar and Matthew on the Kortex onboarding task\"\nFlow:\n  - Find Sharyar (check existing members or invite)\n  - Find Matthew (check existing or invite)\n  - Locate Kortex onboarding task\n  - Add both as assignees\n  - Comment: \"@Sharyar @Matthew — Kortex onboarding ready for your review. See attached Loom.\"\n  - Set due date: +3 days\n  - Set priority: high\n  - Set status: \"in progress\"\n  - Confirm: \"Sharyar and Matthew assigned to Kortex onboarding, due 2026-02-21\""
      },
      {
        "title": "4. Workspace Creation from Template",
        "body": "Input: \"Set up a new client workspace for Luxury Homes using our real estate template\"\nParse:\n  - Template: detect \"real estate\" → use predefined structure\n  - Spaces: Delivery + Operations\n  - Folders: Client Name → Market Research, Design, Build, Launch\n  - Lists: Per-phase task lists with default tasks\n  - Custom Fields: Budget, Timeline, Priority, Platform\n  - Assignees: Based on team roles from People graph\n  - Automations: Status change triggers, due date reminders\n  \nExecute: Create full hierarchy, validate each step\nConfirm: \"Luxury Homes workspace created: 2 spaces, 4 folders, 12 lists, 48 tasks, 5 team members assigned, automations active\""
      },
      {
        "title": "5. Intelligent Task Generation",
        "body": "Input: \"Break down the Clarify website project into technical tasks\"\nGenerate: \n- [ ] Setup Git repository and CI/CD pipeline\n- [ ] Install dependencies (npm, build tools)\n- [ ] Create page components: Home, About, Contact, Services\n- [ ] Implement contact form with validation\n- [ ] SEO setup: sitemap.xml, robots.txt, LLMs.txt\n- [ ] Lighthouse audit and performance optimization\n- [ ] Deploy to Vercel/production\n- [ ] Set up analytics tracking\n\nEach task gets: estimated hours, assignee (based on skills), dependencies (creates task links), custom fields (priority: high, tags: website, client: Clarify)"
      },
      {
        "title": "Every operation follows this pattern:",
        "body": "def create_task(params):\n    # 1. Validate inputs\n    assert params.name, \"Task name required\"\n    assert len(params.name) <= 200, \"Name too long\"\n    \n    # 2. Check preconditions\n    if params.list_id:\n        assert list_exists(params.list_id), f\"List {params.list_id} not found\"\n    \n    # 3. Execute API call\n    try:\n        result = api_post(\"/task\", params.dict())\n    except RateLimitError as e:\n        # Retry with exponential backoff\n        wait(e.retry_after + 1)\n        result = api_post(\"/task\", params.dict())\n    except ValidationError as e:\n        # Return explicit error\n        raise ClickUpError(f\"Invalid data: {e.details}\")\n    \n    # 4. Verify result\n    assert result.id, \"No task ID returned\"\n    assert result.name == params.name, \"Name mismatch\"\n    \n    # 5. Confirm success\n    return {\n        \"id\": result.id,\n        \"name\": result.name,\n        \"url\": result.url,\n        \"created\": True,\n        \"validated\": True\n    }"
      },
      {
        "title": "Common errors handled explicitly:",
        "body": "rate_limit → retry + backoff\nvalidation_failed → return field-level errors\nnot_found → suggest corrections\npermission_denied → suggest workspace access\nconflict → offer resolution (rename, merge)"
      },
      {
        "title": "Diagnostic Commands",
        "body": "# What's the status of project X?\nclickup-op diagnose --project \"Clarify\" --depth full\n\n# Who's blocking project Y?\nclickup-op blockers --project \"Scent Of A Milien\" --format report\n\n# Estimate completion date\nclickup-op estimate --project \"Mel website\" --include-dependencies\n\n# Suggest resource allocation\nclickup-op allocate --team \"George,Matthew,Sharyar\" --capacity 40h/week"
      },
      {
        "title": "Testing Strategy",
        "body": "Before declaring operational:\n\nCreate 10 test workspaces\nGenerate 100 tasks with all variations (assignees, due dates, priorities, tags, dependencies, comments, checklists, time entries)\nExecute 50 bulk operations (update 10 tasks, move 5, delete 3, restore 2)\nRun all diagnostic commands, verify output accuracy\nTrigger 20 error conditions, verify explicit error messages\nTest fallback to MCP on bulk operations that hit rate limits\n\nSuccess criteria:\n\n100% operation success rate OR explicit error with resolution\n0 ambiguous states (task exists but unconfirmed)\nAll diagnostics produce sensible estimates\nNatural language parsing handles 95% of user inputs"
      },
      {
        "title": "Integration with Brain System",
        "body": "Every successful operation stores:\n\nMem0: \"Created 12 tasks for Acme Corp project\"\nNeo4j: (Task) -[CREATED_IN]→ (Project \"Acme Corp\"), (George) -[ASSIGNED_TO]→ (Task)\nSQLite: decisions table: decision type, parameters, outcome, timestamp\n\nEnables queries like:\n\n\"What projects did I create last week?\" → Mem0 search\n\"Who's overloaded?\" → Neo4j query assignee task counts\n\"What's my completion rate?\" → SQLite aggregation"
      },
      {
        "title": "Files Structure",
        "body": "skills/clickup-operational/\n├── SKILL.md                      # This spec + user docs\n├── scripts/\n│   ├── clickup_op.py            # Main CLI (800+ lines)\n│   ├── diagnostic.py            # Progress/suggestion engine\n│   ├── natural_parser.py        # NL → structured commands\n│   └── brain_sync.py           # Auto-store to brain system\n└── tests/\n    ├── test_workspace_setup.py\n    ├── test_task_lifecycle.py\n    ├── test_diagnostics.py\n    └── test_natural_language.py"
      },
      {
        "title": "Building This Skill (Model Council Required)",
        "body": "Query to 4 models:\n\"Design the most robust ClickUp operational skill possible. It must handle workspace creation, folder/list structures, task CRUD, assignments, comments, time tracking, reporting, and diagnostics. Must be deterministic (no ambiguous states), validate every API response, handle all errors explicitly, and include comprehensive testing. Include full CLI command list, request/response schemas, and error handling patterns.\"\n\nSynthesize responses → extract best patterns from each model → build unified implementation.\n\nEstimated build time: 4-6 hours with Model Council\nLines of code: ~2,500 (comprehensive, not minimal)\nTest coverage: 95%+ of API endpoints and error paths"
      },
      {
        "title": "Execution Order",
        "body": "Model Council design session (when credits reset)\nBuild core CLI (workspace, folder, list, task operations)\nAdd diagnostic engine (progress, blockers, estimates)\nBuild natural language parser (intent → structured)\nIntegrate brain sync (auto-store operations)\nComprehensive testing (100 tasks, 50 bulk ops, all error paths)\nOperational verification (create real projects, diagnose real blockers)\n\nThis skill becomes your Operational Co-CEO for ClickUp."
      },
      {
        "title": "Status",
        "body": "Spec saved: /home/node/.openclaw/workspace/skills/clickup-operational/spec.md\nNot yet implemented - awaiting Claude credits reset for Model Council build\nPriority: Critical - This unlocks full business operational capability"
      },
      {
        "title": "Related Decisions",
        "body": "Brain ingestion must be implemented first (all ClickUp operations to flow through brain)\nClickUp MCP available as fallback but skill is primary path\nAll client projects go in Delivery space, agent operations in AgxntSix-openclaw space\nNatural language parsing must handle 95%+ of business owner requests without clarification"
      }
    ],
    "body": "ClickUp Operational Master Skill - Design Spec\nCore Philosophy\n\nDeterministic 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.\n\nEmbedded Knowledge Base\n\nThis skill contains the complete ClickUp API documentation internally:\n\nAll 50+ API endpoints\nRequest/response schemas\nRate limits (100 req/min)\nError codes and handling\nWebhook patterns\nBest practices from official docs\n\nMCP Context — Included as documented fallback for edge cases only (complex workspace templates, bulk operations exceeding rate limits, cross-workspace moves).\n\nOperational Capabilities\n1. Natural Language Parsing → Structured Commands\nInput: \"Create a project for Acme Corp with onboarding, web design, and monthly retainer phases\"\nParse: \n  - workspace: Delivery\n  - client: Acme Corp\n  - structure: folder → 3 lists (onboarding, web-design, retainer)\n  - assignees: find by email/name\n  - due dates: infer from phases\n  - custom fields: budget, priority, status\n  \nExecute: deterministic sequence with rollback on failure\nVerify: each list created, each task present, assignments correct\nConfirm: \"Project Acme Corp created with 3 phases, 12 tasks, assigned to George & Matthew, due 2026-03-15\"\n\n2. Progress Diagnosis & Timeline Estimation\nInput: \"What's blocking the Scent of a Milien project?\"\nFlow: \n  - Scan all tasks in folder\n  - Identify status: blocked, overdue, no-assignee\n  - Check dependencies: waiting on other tasks\n  - Estimate completion: based on task complexity, assignee velocity\n  - Report: \"3 tasks blocked (waiting on George's video edits). ETA: +5 days. Suggest: reassign or parallelize\"\n\n3. Assignment Orchestration\nInput: \"Get Sharyar and Matthew on the Kortex onboarding task\"\nFlow:\n  - Find Sharyar (check existing members or invite)\n  - Find Matthew (check existing or invite)\n  - Locate Kortex onboarding task\n  - Add both as assignees\n  - Comment: \"@Sharyar @Matthew — Kortex onboarding ready for your review. See attached Loom.\"\n  - Set due date: +3 days\n  - Set priority: high\n  - Set status: \"in progress\"\n  - Confirm: \"Sharyar and Matthew assigned to Kortex onboarding, due 2026-02-21\"\n\n4. Workspace Creation from Template\nInput: \"Set up a new client workspace for Luxury Homes using our real estate template\"\nParse:\n  - Template: detect \"real estate\" → use predefined structure\n  - Spaces: Delivery + Operations\n  - Folders: Client Name → Market Research, Design, Build, Launch\n  - Lists: Per-phase task lists with default tasks\n  - Custom Fields: Budget, Timeline, Priority, Platform\n  - Assignees: Based on team roles from People graph\n  - Automations: Status change triggers, due date reminders\n  \nExecute: Create full hierarchy, validate each step\nConfirm: \"Luxury Homes workspace created: 2 spaces, 4 folders, 12 lists, 48 tasks, 5 team members assigned, automations active\"\n\n5. Intelligent Task Generation\nInput: \"Break down the Clarify website project into technical tasks\"\nGenerate: \n- [ ] Setup Git repository and CI/CD pipeline\n- [ ] Install dependencies (npm, build tools)\n- [ ] Create page components: Home, About, Contact, Services\n- [ ] Implement contact form with validation\n- [ ] SEO setup: sitemap.xml, robots.txt, LLMs.txt\n- [ ] Lighthouse audit and performance optimization\n- [ ] Deploy to Vercel/production\n- [ ] Set up analytics tracking\n\nEach task gets: estimated hours, assignee (based on skills), dependencies (creates task links), custom fields (priority: high, tags: website, client: Clarify)\n\nError Handling & Determinism\nEvery operation follows this pattern:\ndef create_task(params):\n    # 1. Validate inputs\n    assert params.name, \"Task name required\"\n    assert len(params.name) <= 200, \"Name too long\"\n    \n    # 2. Check preconditions\n    if params.list_id:\n        assert list_exists(params.list_id), f\"List {params.list_id} not found\"\n    \n    # 3. Execute API call\n    try:\n        result = api_post(\"/task\", params.dict())\n    except RateLimitError as e:\n        # Retry with exponential backoff\n        wait(e.retry_after + 1)\n        result = api_post(\"/task\", params.dict())\n    except ValidationError as e:\n        # Return explicit error\n        raise ClickUpError(f\"Invalid data: {e.details}\")\n    \n    # 4. Verify result\n    assert result.id, \"No task ID returned\"\n    assert result.name == params.name, \"Name mismatch\"\n    \n    # 5. Confirm success\n    return {\n        \"id\": result.id,\n        \"name\": result.name,\n        \"url\": result.url,\n        \"created\": True,\n        \"validated\": True\n    }\n\nCommon errors handled explicitly:\nrate_limit → retry + backoff\nvalidation_failed → return field-level errors\nnot_found → suggest corrections\npermission_denied → suggest workspace access\nconflict → offer resolution (rename, merge)\nDiagnostic Commands\n# What's the status of project X?\nclickup-op diagnose --project \"Clarify\" --depth full\n\n# Who's blocking project Y?\nclickup-op blockers --project \"Scent Of A Milien\" --format report\n\n# Estimate completion date\nclickup-op estimate --project \"Mel website\" --include-dependencies\n\n# Suggest resource allocation\nclickup-op allocate --team \"George,Matthew,Sharyar\" --capacity 40h/week\n\nTesting Strategy\n\nBefore declaring operational:\n\nCreate 10 test workspaces\nGenerate 100 tasks with all variations (assignees, due dates, priorities, tags, dependencies, comments, checklists, time entries)\nExecute 50 bulk operations (update 10 tasks, move 5, delete 3, restore 2)\nRun all diagnostic commands, verify output accuracy\nTrigger 20 error conditions, verify explicit error messages\nTest fallback to MCP on bulk operations that hit rate limits\n\nSuccess criteria:\n\n100% operation success rate OR explicit error with resolution\n0 ambiguous states (task exists but unconfirmed)\nAll diagnostics produce sensible estimates\nNatural language parsing handles 95% of user inputs\nIntegration with Brain System\n\nEvery successful operation stores:\n\nMem0: \"Created 12 tasks for Acme Corp project\"\nNeo4j: (Task) -[CREATED_IN]→ (Project \"Acme Corp\"), (George) -[ASSIGNED_TO]→ (Task)\nSQLite: decisions table: decision type, parameters, outcome, timestamp\n\nEnables queries like:\n\n\"What projects did I create last week?\" → Mem0 search\n\"Who's overloaded?\" → Neo4j query assignee task counts\n\"What's my completion rate?\" → SQLite aggregation\nFiles Structure\nskills/clickup-operational/\n├── SKILL.md                      # This spec + user docs\n├── scripts/\n│   ├── clickup_op.py            # Main CLI (800+ lines)\n│   ├── diagnostic.py            # Progress/suggestion engine\n│   ├── natural_parser.py        # NL → structured commands\n│   └── brain_sync.py           # Auto-store to brain system\n└── tests/\n    ├── test_workspace_setup.py\n    ├── test_task_lifecycle.py\n    ├── test_diagnostics.py\n    └── test_natural_language.py\n\nBuilding This Skill (Model Council Required)\n\nQuery to 4 models: \"Design the most robust ClickUp operational skill possible. It must handle workspace creation, folder/list structures, task CRUD, assignments, comments, time tracking, reporting, and diagnostics. Must be deterministic (no ambiguous states), validate every API response, handle all errors explicitly, and include comprehensive testing. Include full CLI command list, request/response schemas, and error handling patterns.\"\n\nSynthesize responses → extract best patterns from each model → build unified implementation.\n\nEstimated build time: 4-6 hours with Model Council Lines of code: ~2,500 (comprehensive, not minimal) Test coverage: 95%+ of API endpoints and error paths\n\nExecution Order\nModel Council design session (when credits reset)\nBuild core CLI (workspace, folder, list, task operations)\nAdd diagnostic engine (progress, blockers, estimates)\nBuild natural language parser (intent → structured)\nIntegrate brain sync (auto-store operations)\nComprehensive testing (100 tasks, 50 bulk ops, all error paths)\nOperational verification (create real projects, diagnose real blockers)\n\nThis skill becomes your Operational Co-CEO for ClickUp.\n\nStatus\nSpec saved: /home/node/.openclaw/workspace/skills/clickup-operational/spec.md\nNot yet implemented - awaiting Claude credits reset for Model Council build\nPriority: Critical - This unlocks full business operational capability\nRelated Decisions\nBrain ingestion must be implemented first (all ClickUp operations to flow through brain)\nClickUp MCP available as fallback but skill is primary path\nAll client projects go in Delivery space, agent operations in AgxntSix-openclaw space\nNatural language parsing must handle 95%+ of business owner requests without clarification"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/aiwithabidi/clickup-operational",
    "publisherUrl": "https://clawhub.ai/aiwithabidi/clickup-operational",
    "owner": "aiwithabidi",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/clickup-operational",
    "downloadUrl": "https://openagent3.xyz/downloads/clickup-operational",
    "agentUrl": "https://openagent3.xyz/skills/clickup-operational/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clickup-operational/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clickup-operational/agent.md"
  }
}