[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6Q2BNSCNJ7P3TM2T1PBRV4K":3,"skill-same:01M6Q2BNSCNJ7P3TM2T1PBRV4K":97},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":30,"publishedAt":50,"linkOnly":51,"markdownContent":52,"markdownBody":53,"frontMatter":54,"refName":55,"commitSha":56,"skillDirectory":57,"forksCount":58,"repositoryHtmlUrl":59,"repositoryHomepageUrl":6,"ownerHtmlUrl":60,"ownerBlogUrl":6,"ownerDescription":61,"updatedAt":62,"install":63,"resources":76},"01M6Q2BNSCNJ7P3TM2T1PBRV4K","clickup",null,"Enterprise-grade ClickUp project management integration with advanced reporting, multi-workspace support, and client\u002Fproject tracking. Core capabilities: (1) Multi-workspace task management with automatic workspace switching, (2) Advanced analytics & reporting (task counts, assignee breakdowns, status\u002Fpriority analysis, daily standup reports) with automatic subtask inclusion and pagination, (3) Client folder organization with project tracking (? Client Overview, ? Completed Work, active project lists), (4) Full CRUD operations for spaces, folders, lists, tasks, and custom fields, (5) Time tracking & timer management with billing support, (6) Document creation and page management (API v3), (7) Task dependencies, linking, and relationship mapping, (8) Sales pipeline tracking with prospect\u002Fproject status, (9) Retainer & recurring billing management. Built for agencies managing multiple clients across complex workspace hierarchies.","Kernel8901\u002Fai-agent-skills-classification","Kernel8901","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F72647553?v=4","01M6KV388J2H5PNC8D8P940BJD","01M6KV38CS5B3AY63RKZB410YM",7,"MIT","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F生产力与任务\u002Fclickup-skill\u002FSKILL.md",[17,22,25],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000013","分析与可视化",{"categoryNo":26,"categoryName":27,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",[5,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49],"reports","advanced","billing","prospect","creation","switching","project","across","time","relationship","tasks","project status","daily standup","crud","task management","api","analysis","pipeline","capabilities","2026-11-10 10:12:30",false,"---\nname: clickup\ndescription: \"Enterprise-grade ClickUp project management integration with advanced reporting, multi-workspace support, and client\u002Fproject tracking. Core capabilities: (1) Multi-workspace task management with automatic workspace switching, (2) Advanced analytics & reporting (task counts, assignee breakdowns, status\u002Fpriority analysis, daily standup reports) with automatic subtask inclusion and pagination, (3) Client folder organization with project tracking (? Client Overview, ? Completed Work, active project lists), (4) Full CRUD operations for spaces, folders, lists, tasks, and custom fields, (5) Time tracking & timer management with billing support, (6) Document creation and page management (API v3), (7) Task dependencies, linking, and relationship mapping, (8) Sales pipeline tracking with prospect\u002Fproject status, (9) Retainer & recurring billing management. Built for agencies managing multiple clients across complex workspace hierarchies.\"\n---\n\n# ClickUp Skill\n\n**Enterprise-grade ClickUp integration for agency workflows.** Manage multiple clients, projects, and workspaces with advanced reporting, automatic subtask handling, and sophisticated folder organization.\n\n## Key Benefits\n\n| Feature | Why It Matters |\n|---------|----------------|\n| **? Always includes subtasks** | Never miss 70%+ of actual work — subtasks included automatically |\n| **? Advanced reporting** | Task counts, workload distribution, status breakdowns, standup reports |\n| **? Multi-workspace** | Seamlessly switch between Client Work, Product Development, Personal Projects, and more |\n| **? Client organization** | Structured folders: ? Client Overview, ? Completed Work, active projects |\n| **? Sales pipeline** | Track proposals, negotiations, and project lifecycles |\n| **⏱️ Time tracking** | Built-in timers and manual entries with billing support |\n| **? Document management** | Create docs and pages via API v3 |\n| **? Task relationships** | Dependencies, blocking\u002Fwaiting, and arbitrary task linking |\n\n## Quick Start\n\n### Setup\nSet your ClickUp API token:\n```bash\nexport CLICKUP_API_TOKEN=\"pk_your_token_here\"\n```\n\nGet your token from: ClickUp Settings → Apps → Generate API Token\n\n### Basic Operations\n\n**List all workspaces:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_teams\n```\n\n**Create a task:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py create_task list_id=\"123\" name=\"New Task\" status=\"to do\"\n```\n\n**Update a task:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py update_task task_id=\"abc\" status=\"in progress\"\n```\n\n## Workspace Hierarchy\n\n```\nTeam (Workspace)\n├── Spaces\n│   ├── Folders\n│   │   └── Lists → Tasks\n│   └── Lists (Folderless) → Tasks\n└── Documents\n```\n\nAll operations require explicit workspace identification via IDs.\n\n## Multi-Workspace Support\n\nThis skill supports operations across multiple ClickUp workspaces:\n\n1. Use `get_teams` to list available workspaces\n2. Reference workspace by `team_id` in operations\n3. Each workspace maintains independent spaces, folders, lists\n4. Custom task IDs require both `custom_task_ids=true` and `team_id`\n\n## Common Workflows\n\n### Workflow: Create Task in Specific Workspace\n\n1. Get workspace ID: `get_teams`\n2. Get target space: `get_spaces team_id=\"xxx\"`\n3. Get or create list: `get_folders space_id=\"yyy\"` → `get_lists folder_id=\"zzz\"`\n4. Create task: `create_task list_id=\"aaa\" name=\"Task\" ...`\n\n### Workflow: Configure Space Statuses\n\n1. Get space: `get_space space_id=\"xxx\"`\n2. Update space with statuses: `update_space space_id=\"xxx\" statuses=[...]`\n\nSee [API Reference](references\u002Fapi_reference.md) for status configuration format.\n\n### Workflow: Track Time on Task\n\n**Option A - Manual Entry:**\n```bash\npython skills\u002Fclickup_client.py create_time_entry \\\n  team_id=\"xxx\" \\\n  task_id=\"yyy\" \\\n  duration=3600000 \\\n  description=\"Worked on feature\"\n```\n\n**Option B - Timer:**\n```bash\n# Start timer\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py start_timer team_id=\"xxx\" task_id=\"yyy\"\n\n# Stop timer (stops current running timer for user)\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py stop_timer team_id=\"xxx\"\n```\n\n### Workflow: Create Document Structure\n\n1. Create doc: `create_doc workspace_id=\"xxx\" name=\"Project Docs\"`\n2. Add pages: Use ClickUp UI (pages API is in beta)\n\nNote: Documents use ClickUp API v3 (workspace_id instead of team_id).\n\n### Workflow: Reporting & Analytics\n\n**Get task counts (with parent\u002Fsubtask breakdown):**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py task_counts team_id=\"xxx\"\n# Returns: {\"total\": 50, \"parents\": 20, \"subtasks\": 30, \"unassigned\": 5}\n```\n\n**Get workload by assignee:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py assignee_breakdown team_id=\"xxx\"\n# Returns: {\"John Doe\": 15, \"Jane Smith\": 12, \"Unassigned\": 8}\n```\n\n**Get tasks by status:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py status_breakdown team_id=\"xxx\"\n# Returns: {\"to do\": 20, \"in progress\": 10, \"complete\": 15}\n```\n\n**Get tasks by priority:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py priority_breakdown team_id=\"xxx\"\n# Returns: {\"urgent\": 2, \"high\": 5, \"normal\": 15, \"low\": 8, \"none\": 20}\n```\n\n**Daily standup report (grouped by status):**\n```bash\n# All team members\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py standup_report team_id=\"xxx\"\n\n# Specific person (use user ID)\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py standup_report team_id=\"xxx\" assignee_id=\"12345\"\n```\n\n**Get all tasks with pagination (auto-handled):**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_all_tasks team_id=\"xxx\"\n# Always includes subtasks automatically (critical!)\n```\n\n**Filter reports by space or assignee:**\n```bash\n# Specific space\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py task_counts team_id=\"xxx\" space_ids='[\"SPACE_ID_HERE\"]'\n\n# Specific assignee\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_all_tasks team_id=\"xxx\" assignees='[\"12345\"]'\n\n# Include closed tasks\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py task_counts team_id=\"xxx\" include_closed=\"true\"\n```\n\n**Critical Rules for Reporting:**\n1. **Always include subtasks** — Our methods do this automatically via `subtasks=true`\n2. **Pagination handled** — `get_all_tasks` loops until all pages retrieved\n3. **Parent vs Subtask** — Parents have `parent: null`, subtasks have `parent: \"task_id\"`\n4. **Rate limit** — 100 requests\u002Fmin; our pagination respects this\n\n### Workflow: Link Doc to Task\n\n**Option A - Add as attachment:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py link_doc_to_task \\\n  task_id=\"xxx\" \\\n  doc_id=\"yyy\"\n```\n\n**Option B - Mention in description:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py mention_doc_in_task \\\n  task_id=\"xxx\" \\\n  doc_id=\"yyy\"\n```\n\nBoth create clickable links to the document from the task.\n\n### Workflow: Task Dependencies\n\n**Set up blocking relationship:**\n```bash\n# Task B is blocked by\u002Fwaiting on Task A\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py add_dependency \\\n  task_id=\"TASK_B_ID\" \\\n  depends_on=\"TASK_A_ID\"\n\n# Check dependencies\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_dependencies \\\n  task_id=\"TASK_B_ID\"\n\n# Remove dependency\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py remove_dependency \\\n  task_id=\"TASK_B_ID\" \\\n  depends_on=\"TASK_A_ID\"\n```\n\n**Set up reverse dependency (task is blocking another):**\n```bash\n# Task A is blocking Task B\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py add_dependency \\\n  task_id=\"TASK_A_ID\" \\\n  waiting_on=\"TASK_B_ID\"\n```\n\n### Workflow: Link Related Tasks (Non-Dependency)\n\nFor related tasks that aren't blocking each other:\n\n```bash\n# Link Task A to Task B (arbitrary relationship)\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py link_tasks \\\n  task_id=\"TASK_A_ID\" \\\n  links_to=\"TASK_B_ID\"\n\n# Remove link\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py unlink_tasks \\\n  task_id=\"TASK_A_ID\" \\\n  links_to=\"TASK_B_ID\"\n```\n\nNote: `link_tasks` creates a \"linked task\" relationship (appears in task's \"Linked Tasks\" section), while `add_dependency` creates blocking\u002Fwaiting relationships.\n\n### Workflow: Bulk Task Operations\n\nFor bulk operations, loop through tasks:\n```bash\n# Get tasks\nTASKS=$(python skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_tasks list_id=\"xxx\")\n\n# Process each (parse JSON and loop)\n```\n\n## Script Reference\n\n### scripts\u002Fclickup_client.py\n\nMain CLI interface for ClickUp operations.\n\n**Usage:**\n```bash\npython scripts\u002Fclickup_client.py \u003Ccommand> [key=value ...]\n```\n\n**Commands:**\n\n#### Workspace Operations\n- `get_teams` - List all accessible workspaces\n\n#### Space Operations\n- `get_spaces team_id=\"xxx\"` - List spaces\n- `create_space team_id=\"xxx\" name=\"Name\" [options...]` - Create space\n- `update_space space_id=\"xxx\" [options...]` - Update space\n\n#### Folder Operations\n- `get_folders space_id=\"xxx\"` - List folders\n- `create_folder space_id=\"xxx\" name=\"Name\"` - Create folder\n\n#### List Operations\n- `get_lists folder_id=\"xxx\"` - Lists in folder\n- `get_space_lists space_id=\"xxx\"` - Folderless lists\n- `create_list folder_id=\"xxx\" name=\"Name\" [options...]` - Create in folder\n- `create_space_list space_id=\"xxx\" name=\"Name\" [options...]` - Create folderless\n\n#### Task Operations\n- `get_task task_id=\"xxx\"` - Get task details (includes dependencies, linked tasks)\n- `get_tasks list_id=\"xxx\" [filters...]` - List tasks\n- `create_task list_id=\"xxx\" name=\"Name\" [options...]` - Create task\n- `update_task task_id=\"xxx\" [options...]` - Update task\n\n#### Time Tracking\n- `get_time_entries team_id=\"xxx\" [filters...]` - List entries\n- `create_time_entry team_id=\"xxx\" task_id=\"yyy\" duration=3600000 [...]` - Create entry\n- `start_timer team_id=\"xxx\" task_id=\"yyy\"` - Start timer\n- `stop_timer team_id=\"xxx\"` - Stop timer\n\n#### Documents (API v3)\n- `get_docs workspace_id=\"xxx\"` - List documents\n- `create_doc workspace_id=\"xxx\" name=\"Name\" [options...]` - Create document\n- `get_doc doc_id=\"xxx\"` - Get document details\n\n**Note on Pages:** Doc pages API is in beta. Pages may need to be created via ClickUp UI.\n\n#### Doc-Task Linking\n- `link_doc_to_task task_id=\"xxx\" doc_id=\"yyy\"` - Attach doc URL to task\n- `mention_doc_in_task task_id=\"xxx\" doc_id=\"yyy\"` - Add doc link to task description\n\n#### Task Dependencies (Blocking\u002FWaiting On)\n- `add_dependency task_id=\"xxx\" depends_on=\"yyy\"` - Task is blocked by\u002Fwaiting on another task\n- `add_dependency task_id=\"xxx\" waiting_on=\"yyy\"` - Another task is blocked by\u002Fwaiting on this task\n- `remove_dependency task_id=\"xxx\" depends_on=\"yyy\"` - Remove dependency\n- `get_dependencies task_id=\"xxx\"` - List all dependencies for a task\n\n#### Task Linking (Arbitrary Relationships)\n- `link_tasks task_id=\"xxx\" links_to=\"yyy\"` - Create arbitrary link between tasks\n- `unlink_tasks task_id=\"xxx\" links_to=\"yyy\"` - Remove task link\n\n#### Reporting & Analytics\n- `get_all_tasks team_id=\"xxx\" [include_closed=\"true\"] [space_ids='[\"id1\"]'] [assignees='[\"uid1\"]']` - All tasks with auto-pagination (always includes subtasks)\n- `task_counts team_id=\"xxx\" [filters...]` - Count breakdown: total, parents, subtasks, unassigned\n- `assignee_breakdown team_id=\"xxx\" [filters...]` - Workload distribution by assignee\n- `status_breakdown team_id=\"xxx\" [filters...]` - Tasks grouped by status\n- `priority_breakdown team_id=\"xxx\" [filters...]` - Tasks grouped by priority\n- `standup_report team_id=\"xxx\" [assignee_id=\"yyy\"]` - Daily standup report grouped by status\n\n#### Documents\n- `get_docs team_id=\"xxx\"` - List documents\n- `create_doc team_id=\"xxx\" name=\"Name\" [options...]` - Create document\n\n## Advanced Configuration\n\n### Custom Fields\n\nTo work with custom fields:\n\n1. Get field definitions: `GET \u002Flist\u002F{list_id}\u002Ffield` (see API Reference)\n2. Set values when creating\u002Fupdating tasks:\n   ```bash\n   python skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py update_task \\\n     task_id=\"xxx\" \\\n     'custom_fields=[{\"id\":\"field_id\",\"value\":\"value\"}]'\n   ```\n\n### Status Configuration\n\nWhen creating\u002Fupdating spaces or lists:\n\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py update_space \\\n  space_id=\"xxx\" \\\n  'statuses=[{\"status\":\"To Do\",\"type\":\"open\"},{\"status\":\"Done\",\"type\":\"closed\"}]'\n```\n\n### Priority Levels\n\n- `1` - Urgent\n- `2` - High\n- `3` - Normal\n- `4` - Low\n\n## Error Handling\n\nCommon errors and solutions:\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `401 Unauthorized` | Invalid API token | Check CLICKUP_API_TOKEN |\n| `404 Not Found` | Invalid ID | Verify workspace\u002Fspace\u002Ffolder\u002Flist\u002Ftask IDs |\n| `429 Too Many Requests` | Rate limit | Wait and retry (100 req\u002Fmin limit) |\n| `400 Bad Request` | Invalid parameters | Check JSON format in arguments |\n\n## Python Client Usage\n\nFor complex operations, import the client directly:\n\n```python\nfrom skills.clickup.scripts.clickup_client import ClickUpClient\n\nclient = ClickUpClient()\n\n# Get all workspaces\nteams = client.get_teams()\n\n# Create task with full control\ntask = client.create_task(\n    list_id=\"123\",\n    name=\"Complex Task\",\n    description=\"Detailed description\",\n    assignees=[123, 456],\n    tags=[\"urgent\", \"client\"],\n    priority=2,\n    due_date=1704067200000,\n    time_estimate=14400000\n)\n```\n\n## References\n\n- **API Details**: See [references\u002Fapi_reference.md](references\u002Fapi_reference.md) for complete endpoint documentation, request\u002Fresponse formats, and field types.\n- **ClickUp API Docs**: https:\u002F\u002Fclickup.com\u002Fapi\n\n## Best Practices\n\n1. **Store IDs**: Workspace\u002Fspace\u002Ffolder\u002Flist IDs rarely change. Store them in `TOOLS.md` for quick reference.\n2. **Custom Task IDs**: If using custom IDs, always include `custom_task_ids=true` and `team_id` in task operations.\n3. **Rate Limiting**: Space out bulk operations to avoid 429 errors.\n4. **Time Tracking**: Use milliseconds for all duration\u002Ftimestamp values.\n5. **Multi-Workspace**: Always double-check `team_id` when working across workspaces to avoid modifying wrong workspace.\n","# ClickUp Skill\n\n**Enterprise-grade ClickUp integration for agency workflows.** Manage multiple clients, projects, and workspaces with advanced reporting, automatic subtask handling, and sophisticated folder organization.\n\n## Key Benefits\n\n| Feature | Why It Matters |\n|---------|----------------|\n| **? Always includes subtasks** | Never miss 70%+ of actual work — subtasks included automatically |\n| **? Advanced reporting** | Task counts, workload distribution, status breakdowns, standup reports |\n| **? Multi-workspace** | Seamlessly switch between Client Work, Product Development, Personal Projects, and more |\n| **? Client organization** | Structured folders: ? Client Overview, ? Completed Work, active projects |\n| **? Sales pipeline** | Track proposals, negotiations, and project lifecycles |\n| **⏱️ Time tracking** | Built-in timers and manual entries with billing support |\n| **? Document management** | Create docs and pages via API v3 |\n| **? Task relationships** | Dependencies, blocking\u002Fwaiting, and arbitrary task linking |\n\n## Quick Start\n\n### Setup\nSet your ClickUp API token:\n```bash\nexport CLICKUP_API_TOKEN=\"pk_your_token_here\"\n```\n\nGet your token from: ClickUp Settings → Apps → Generate API Token\n\n### Basic Operations\n\n**List all workspaces:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_teams\n```\n\n**Create a task:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py create_task list_id=\"123\" name=\"New Task\" status=\"to do\"\n```\n\n**Update a task:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py update_task task_id=\"abc\" status=\"in progress\"\n```\n\n## Workspace Hierarchy\n\n```\nTeam (Workspace)\n├── Spaces\n│   ├── Folders\n│   │   └── Lists → Tasks\n│   └── Lists (Folderless) → Tasks\n└── Documents\n```\n\nAll operations require explicit workspace identification via IDs.\n\n## Multi-Workspace Support\n\nThis skill supports operations across multiple ClickUp workspaces:\n\n1. Use `get_teams` to list available workspaces\n2. Reference workspace by `team_id` in operations\n3. Each workspace maintains independent spaces, folders, lists\n4. Custom task IDs require both `custom_task_ids=true` and `team_id`\n\n## Common Workflows\n\n### Workflow: Create Task in Specific Workspace\n\n1. Get workspace ID: `get_teams`\n2. Get target space: `get_spaces team_id=\"xxx\"`\n3. Get or create list: `get_folders space_id=\"yyy\"` → `get_lists folder_id=\"zzz\"`\n4. Create task: `create_task list_id=\"aaa\" name=\"Task\" ...`\n\n### Workflow: Configure Space Statuses\n\n1. Get space: `get_space space_id=\"xxx\"`\n2. Update space with statuses: `update_space space_id=\"xxx\" statuses=[...]`\n\nSee [API Reference](references\u002Fapi_reference.md) for status configuration format.\n\n### Workflow: Track Time on Task\n\n**Option A - Manual Entry:**\n```bash\npython skills\u002Fclickup_client.py create_time_entry \\\n  team_id=\"xxx\" \\\n  task_id=\"yyy\" \\\n  duration=3600000 \\\n  description=\"Worked on feature\"\n```\n\n**Option B - Timer:**\n```bash\n# Start timer\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py start_timer team_id=\"xxx\" task_id=\"yyy\"\n\n# Stop timer (stops current running timer for user)\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py stop_timer team_id=\"xxx\"\n```\n\n### Workflow: Create Document Structure\n\n1. Create doc: `create_doc workspace_id=\"xxx\" name=\"Project Docs\"`\n2. Add pages: Use ClickUp UI (pages API is in beta)\n\nNote: Documents use ClickUp API v3 (workspace_id instead of team_id).\n\n### Workflow: Reporting & Analytics\n\n**Get task counts (with parent\u002Fsubtask breakdown):**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py task_counts team_id=\"xxx\"\n# Returns: {\"total\": 50, \"parents\": 20, \"subtasks\": 30, \"unassigned\": 5}\n```\n\n**Get workload by assignee:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py assignee_breakdown team_id=\"xxx\"\n# Returns: {\"John Doe\": 15, \"Jane Smith\": 12, \"Unassigned\": 8}\n```\n\n**Get tasks by status:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py status_breakdown team_id=\"xxx\"\n# Returns: {\"to do\": 20, \"in progress\": 10, \"complete\": 15}\n```\n\n**Get tasks by priority:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py priority_breakdown team_id=\"xxx\"\n# Returns: {\"urgent\": 2, \"high\": 5, \"normal\": 15, \"low\": 8, \"none\": 20}\n```\n\n**Daily standup report (grouped by status):**\n```bash\n# All team members\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py standup_report team_id=\"xxx\"\n\n# Specific person (use user ID)\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py standup_report team_id=\"xxx\" assignee_id=\"12345\"\n```\n\n**Get all tasks with pagination (auto-handled):**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_all_tasks team_id=\"xxx\"\n# Always includes subtasks automatically (critical!)\n```\n\n**Filter reports by space or assignee:**\n```bash\n# Specific space\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py task_counts team_id=\"xxx\" space_ids='[\"SPACE_ID_HERE\"]'\n\n# Specific assignee\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_all_tasks team_id=\"xxx\" assignees='[\"12345\"]'\n\n# Include closed tasks\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py task_counts team_id=\"xxx\" include_closed=\"true\"\n```\n\n**Critical Rules for Reporting:**\n1. **Always include subtasks** — Our methods do this automatically via `subtasks=true`\n2. **Pagination handled** — `get_all_tasks` loops until all pages retrieved\n3. **Parent vs Subtask** — Parents have `parent: null`, subtasks have `parent: \"task_id\"`\n4. **Rate limit** — 100 requests\u002Fmin; our pagination respects this\n\n### Workflow: Link Doc to Task\n\n**Option A - Add as attachment:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py link_doc_to_task \\\n  task_id=\"xxx\" \\\n  doc_id=\"yyy\"\n```\n\n**Option B - Mention in description:**\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py mention_doc_in_task \\\n  task_id=\"xxx\" \\\n  doc_id=\"yyy\"\n```\n\nBoth create clickable links to the document from the task.\n\n### Workflow: Task Dependencies\n\n**Set up blocking relationship:**\n```bash\n# Task B is blocked by\u002Fwaiting on Task A\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py add_dependency \\\n  task_id=\"TASK_B_ID\" \\\n  depends_on=\"TASK_A_ID\"\n\n# Check dependencies\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_dependencies \\\n  task_id=\"TASK_B_ID\"\n\n# Remove dependency\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py remove_dependency \\\n  task_id=\"TASK_B_ID\" \\\n  depends_on=\"TASK_A_ID\"\n```\n\n**Set up reverse dependency (task is blocking another):**\n```bash\n# Task A is blocking Task B\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py add_dependency \\\n  task_id=\"TASK_A_ID\" \\\n  waiting_on=\"TASK_B_ID\"\n```\n\n### Workflow: Link Related Tasks (Non-Dependency)\n\nFor related tasks that aren't blocking each other:\n\n```bash\n# Link Task A to Task B (arbitrary relationship)\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py link_tasks \\\n  task_id=\"TASK_A_ID\" \\\n  links_to=\"TASK_B_ID\"\n\n# Remove link\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py unlink_tasks \\\n  task_id=\"TASK_A_ID\" \\\n  links_to=\"TASK_B_ID\"\n```\n\nNote: `link_tasks` creates a \"linked task\" relationship (appears in task's \"Linked Tasks\" section), while `add_dependency` creates blocking\u002Fwaiting relationships.\n\n### Workflow: Bulk Task Operations\n\nFor bulk operations, loop through tasks:\n```bash\n# Get tasks\nTASKS=$(python skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py get_tasks list_id=\"xxx\")\n\n# Process each (parse JSON and loop)\n```\n\n## Script Reference\n\n### scripts\u002Fclickup_client.py\n\nMain CLI interface for ClickUp operations.\n\n**Usage:**\n```bash\npython scripts\u002Fclickup_client.py \u003Ccommand> [key=value ...]\n```\n\n**Commands:**\n\n#### Workspace Operations\n- `get_teams` - List all accessible workspaces\n\n#### Space Operations\n- `get_spaces team_id=\"xxx\"` - List spaces\n- `create_space team_id=\"xxx\" name=\"Name\" [options...]` - Create space\n- `update_space space_id=\"xxx\" [options...]` - Update space\n\n#### Folder Operations\n- `get_folders space_id=\"xxx\"` - List folders\n- `create_folder space_id=\"xxx\" name=\"Name\"` - Create folder\n\n#### List Operations\n- `get_lists folder_id=\"xxx\"` - Lists in folder\n- `get_space_lists space_id=\"xxx\"` - Folderless lists\n- `create_list folder_id=\"xxx\" name=\"Name\" [options...]` - Create in folder\n- `create_space_list space_id=\"xxx\" name=\"Name\" [options...]` - Create folderless\n\n#### Task Operations\n- `get_task task_id=\"xxx\"` - Get task details (includes dependencies, linked tasks)\n- `get_tasks list_id=\"xxx\" [filters...]` - List tasks\n- `create_task list_id=\"xxx\" name=\"Name\" [options...]` - Create task\n- `update_task task_id=\"xxx\" [options...]` - Update task\n\n#### Time Tracking\n- `get_time_entries team_id=\"xxx\" [filters...]` - List entries\n- `create_time_entry team_id=\"xxx\" task_id=\"yyy\" duration=3600000 [...]` - Create entry\n- `start_timer team_id=\"xxx\" task_id=\"yyy\"` - Start timer\n- `stop_timer team_id=\"xxx\"` - Stop timer\n\n#### Documents (API v3)\n- `get_docs workspace_id=\"xxx\"` - List documents\n- `create_doc workspace_id=\"xxx\" name=\"Name\" [options...]` - Create document\n- `get_doc doc_id=\"xxx\"` - Get document details\n\n**Note on Pages:** Doc pages API is in beta. Pages may need to be created via ClickUp UI.\n\n#### Doc-Task Linking\n- `link_doc_to_task task_id=\"xxx\" doc_id=\"yyy\"` - Attach doc URL to task\n- `mention_doc_in_task task_id=\"xxx\" doc_id=\"yyy\"` - Add doc link to task description\n\n#### Task Dependencies (Blocking\u002FWaiting On)\n- `add_dependency task_id=\"xxx\" depends_on=\"yyy\"` - Task is blocked by\u002Fwaiting on another task\n- `add_dependency task_id=\"xxx\" waiting_on=\"yyy\"` - Another task is blocked by\u002Fwaiting on this task\n- `remove_dependency task_id=\"xxx\" depends_on=\"yyy\"` - Remove dependency\n- `get_dependencies task_id=\"xxx\"` - List all dependencies for a task\n\n#### Task Linking (Arbitrary Relationships)\n- `link_tasks task_id=\"xxx\" links_to=\"yyy\"` - Create arbitrary link between tasks\n- `unlink_tasks task_id=\"xxx\" links_to=\"yyy\"` - Remove task link\n\n#### Reporting & Analytics\n- `get_all_tasks team_id=\"xxx\" [include_closed=\"true\"] [space_ids='[\"id1\"]'] [assignees='[\"uid1\"]']` - All tasks with auto-pagination (always includes subtasks)\n- `task_counts team_id=\"xxx\" [filters...]` - Count breakdown: total, parents, subtasks, unassigned\n- `assignee_breakdown team_id=\"xxx\" [filters...]` - Workload distribution by assignee\n- `status_breakdown team_id=\"xxx\" [filters...]` - Tasks grouped by status\n- `priority_breakdown team_id=\"xxx\" [filters...]` - Tasks grouped by priority\n- `standup_report team_id=\"xxx\" [assignee_id=\"yyy\"]` - Daily standup report grouped by status\n\n#### Documents\n- `get_docs team_id=\"xxx\"` - List documents\n- `create_doc team_id=\"xxx\" name=\"Name\" [options...]` - Create document\n\n## Advanced Configuration\n\n### Custom Fields\n\nTo work with custom fields:\n\n1. Get field definitions: `GET \u002Flist\u002F{list_id}\u002Ffield` (see API Reference)\n2. Set values when creating\u002Fupdating tasks:\n   ```bash\n   python skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py update_task \\\n     task_id=\"xxx\" \\\n     'custom_fields=[{\"id\":\"field_id\",\"value\":\"value\"}]'\n   ```\n\n### Status Configuration\n\nWhen creating\u002Fupdating spaces or lists:\n\n```bash\npython skills\u002Fclickup\u002Fscripts\u002Fclickup_client.py update_space \\\n  space_id=\"xxx\" \\\n  'statuses=[{\"status\":\"To Do\",\"type\":\"open\"},{\"status\":\"Done\",\"type\":\"closed\"}]'\n```\n\n### Priority Levels\n\n- `1` - Urgent\n- `2` - High\n- `3` - Normal\n- `4` - Low\n\n## Error Handling\n\nCommon errors and solutions:\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| `401 Unauthorized` | Invalid API token | Check CLICKUP_API_TOKEN |\n| `404 Not Found` | Invalid ID | Verify workspace\u002Fspace\u002Ffolder\u002Flist\u002Ftask IDs |\n| `429 Too Many Requests` | Rate limit | Wait and retry (100 req\u002Fmin limit) |\n| `400 Bad Request` | Invalid parameters | Check JSON format in arguments |\n\n## Python Client Usage\n\nFor complex operations, import the client directly:\n\n```python\nfrom skills.clickup.scripts.clickup_client import ClickUpClient\n\nclient = ClickUpClient()\n\n# Get all workspaces\nteams = client.get_teams()\n\n# Create task with full control\ntask = client.create_task(\n    list_id=\"123\",\n    name=\"Complex Task\",\n    description=\"Detailed description\",\n    assignees=[123, 456],\n    tags=[\"urgent\", \"client\"],\n    priority=2,\n    due_date=1704067200000,\n    time_estimate=14400000\n)\n```\n\n## References\n\n- **API Details**: See [references\u002Fapi_reference.md](references\u002Fapi_reference.md) for complete endpoint documentation, request\u002Fresponse formats, and field types.\n- **ClickUp API Docs**: https:\u002F\u002Fclickup.com\u002Fapi\n\n## Best Practices\n\n1. **Store IDs**: Workspace\u002Fspace\u002Ffolder\u002Flist IDs rarely change. Store them in `TOOLS.md` for quick reference.\n2. **Custom Task IDs**: If using custom IDs, always include `custom_task_ids=true` and `team_id` in task operations.\n3. **Rate Limiting**: Space out bulk operations to avoid 429 errors.\n4. **Time Tracking**: Use milliseconds for all duration\u002Ftimestamp values.\n5. **Multi-Workspace**: Always double-check `team_id` when working across workspaces to avoid modifying wrong workspace.\n",{"name":5,"description":7},"main","f4cb2d49f7667e79ef7804f50396d5aaffdf1f56","生产力与任务\u002Fclickup-skill",1,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification","https:\u002F\u002Fgithub.com\u002FKernel8901","a little little little dobe in life but science geek","2026-04-05 16:43:56",{"source":8,"skillName":5,"commands":64,"prompt":74,"zipAvailable":75},[65,68,71],{"tool":66,"command":67},"npx","npx skills add Kernel8901\u002Fai-agent-skills-classification --skill clickup",{"tool":69,"command":70},"bunx","bunx skills add Kernel8901\u002Fai-agent-skills-classification --skill clickup",{"tool":72,"command":73},"pnpm","pnpm dlx skills add Kernel8901\u002Fai-agent-skills-classification --skill clickup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F生产力与任务\u002Fclickup-skill\u002FSKILL.md",true,[77,83,87,91],{"path":78,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":81,"sourceHtmlUrl":82},"_meta.json","REFERENCE","参考文档",456,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F生产力与任务\u002Fclickup-skill\u002F_meta.json",{"path":84,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":85,"sourceHtmlUrl":86},"CHANGELOG.md",5562,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F生产力与任务\u002Fclickup-skill\u002FCHANGELOG.md",{"path":88,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":89,"sourceHtmlUrl":90},"references\u002Fapi_reference.md",6063,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F生产力与任务\u002Fclickup-skill\u002Freferences\u002Fapi_reference.md",{"path":92,"resourceType":93,"resourceTypeDesc":94,"sizeBytes":95,"sourceHtmlUrl":96},"scripts\u002Fclickup_client.py","SCRIPT","脚本",29640,"https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F生产力与任务\u002Fclickup-skill\u002Fscripts\u002Fclickup_client.py",[98,122,150,161,171,200],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":50},"01M6Q5R6WZ06RRB9RQTW54B34B","zyfai","Earn yield on any Ethereum wallet on Base, Arbitrum, and Plasma. Use when a user wants passive DeFi yield on their funds. Deploys a non-custodial subaccount (Safe) linked to their EOA, enables automated yield optimization, and lets them deposit\u002Fwithdraw anytime.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzyfai-sdk\u002FSKILL.md",[],[100,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121],"safe","ethereum","defi","Optimization","user","use","Wallet","base","deposit","withdraw","yield","arbitrum","non-custodial","passive","defi yield","earn","yield optimization",{"skillNo":123,"name":124,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":134,"publishedAt":50},"01M6Q5R337B5JSNER4P4YS03TN","zerion-api","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api\u002FSKILL.md",[127,128,131],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":129,"categoryName":130,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":132,"categoryName":133,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000030","开发工程师",[46,135,136,137,138,139,140,107,141,111,142,143,144,145,146,38,147,148,149],"zerion api","zerion","MCP","mcp server","server","blockchain","transactions","crypto wallet","crypto","evm","solana","query","positions","token","prices",{"skillNo":151,"name":152,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":158,"publishedAt":50},"01M6Q5QZFYTDAZMZ27BN5VZXAR","zerion-api-skill","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api-skill\u002FSKILL.md",[155,156,157],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":129,"categoryName":130,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":132,"categoryName":133,"taxonomyType":28,"taxonomyTypeDesc":29},[46,159,160,135,136,137,138,139,140,107,141,111,143,144,145,146,38,147,148,149],"api skill","zerion api skill",{"skillNo":162,"name":163,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":164,"categories":165,"keywords":169,"publishedAt":50},"01M6Q5QW17QW98RA3FE45E4RD8","zerion-api-mcp","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fzerion-api-mcp\u002FSKILL.md",[166,167,168],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":129,"categoryName":130,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":132,"categoryName":133,"taxonomyType":28,"taxonomyTypeDesc":29},[137,46,170,135,136,138,139,107,141,111,142,143,144,145,146,38,147,148,149],"zerion api mcp",{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":180,"publishedAt":50},"01M6Q5QQYZB7A501BDEQWKGSJT","yahoo-finance-forex","Fetches real-time FOREX news and market data from Yahoo Finance for major currency pairs (EUR\u002FUSD, GBP\u002FUSD, USD\u002FJPY, etc.). Analyzes sentiment and provides trading context.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fyahoo-finance-forex\u002FSKILL.md",[177],{"categoryNo":178,"categoryName":179,"taxonomyType":28,"taxonomyTypeDesc":29},"01JBSEEDCAT000000000000040","财务",[181,182,183,184,185,186,187,188,189,190,191,192,193,194,39,195,196,197,198,199],"finance","yahoo finance","forex","yahoo","yahoo finance forex","github","https","sentiment","real-time","python3","install","Market","usd","news","currency","gbp","pip","market data","for",{"skillNo":201,"name":202,"nameZh":6,"description":203,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":204,"categories":205,"keywords":207,"publishedAt":50},"01M6Q5QM6VS84WZVM7BKXXPF32","yahoo-finance","This skill should be used when the user asks to \"get stock prices\", \"check stock quotes\", \"look up earnings\", \"get financial data\", \"find trending stocks\", or needs stock market data from Yahoo Finance.","https:\u002F\u002Fgithub.com\u002FKernel8901\u002Fai-agent-skills-classification\u002Fblob\u002Fmain\u002F金融\u002Fyahoo-finance-cli\u002FSKILL.md",[206],{"categoryNo":178,"categoryName":179,"taxonomyType":28,"taxonomyTypeDesc":29},[181,182,184,208,209,210,211,212,213,192,214,215,216,217,218,219,220,221,149,198],"cli","homebrew","find","check","brew","up","local","get","stock","link","trending","sf","quotes","ln"]