Agent Skill
2/7/2026

clickup-task-workflow

This skill should be used when the user mentions "ClickUp task", "CU-xxx", "task workflow", "clickup integration", or when working with task plugin commands (/task:start, /task:done, /task:merge, /task:status, /task:new). Provides workflow patterns for ClickUp task management integrated with kas.

B
brkastner
2GitHub Stars
1Views
npx skills add brkastner/kas-claude-plugins

SKILL.md

Nameclickup-task-workflow
DescriptionThis skill should be used when the user mentions "ClickUp task", "CU-xxx", "task workflow", "clickup integration", or when working with task plugin commands (/task:start, /task:done, /task:merge, /task:status, /task:new). Provides workflow patterns for ClickUp task management integrated with kas.

name: ClickUp Task Workflow description: This skill should be used when the user mentions "ClickUp task", "CU-xxx", "task workflow", "clickup integration", or when working with task plugin commands (/task:start, /task:done, /task:merge, /task:status, /task:new). Provides workflow patterns for ClickUp task management integrated with kas. version: 0.1.0

ClickUp Task Workflow

Overview

This skill provides workflow patterns for managing ClickUp tasks integrated with kas workflow commands. The core principle: delegate all ClickUp API calls to the clickup-task-agent to keep the main conversation context clean.

Core Principle

NEVER call ClickUp MCP tools directly in main context.

All ClickUp operations delegate to the clickup-task-agent subagent which returns concise summaries. This prevents verbose API responses from polluting the conversation.

Command Mapping

/task CommandSkills/Commands UsedClickUp Actions
/task:start CU-xxxsuperpowers:brainstormingkas:review-plan (loop) → superpowers:subagent-driven-development OR superpowers:executing-plansFetch task, set "in progress", assign
/task:done/kas:verify/kas:done → PRSet "ready for review", comment PR
/task:merge/kas:mergeSet "complete"
/task:status [id]NoneFetch and display status
/task:newNoneCreate task via interview

Planning Workflow

/task:start uses superpowers-driven planning:

  1. Fetch task via clickup-task-agent (capture original status for rollback)
  2. Enter plan mode using EnterPlanMode tool
  3. Brainstorming via superpowers:brainstorming - explores, asks questions, outputs design
  4. Review loop via kas:review-plan - max 5 iterations until APPROVED or user overrides/aborts
  5. Implementation via user choice:
    • Option 1: superpowers:subagent-driven-development (same session)
    • Option 2: superpowers:executing-plans (separate session with worktree)

Detection Triggers

Activate this skill when detecting:

Task References

  • URLs: https://app.clickup.com/t/...
  • Task IDs: CU-xxx, #xxx, task xxx
  • Work phrases: "work on", "implement", "fix task", "start on"

Task Creation

  • Creation phrases: "create task", "new feature", "log bug", "file issue"

Subagent Delegation Pattern

When needing ClickUp data, spawn the clickup-task-agent:

Task tool with subagent_type="task:clickup-task-agent":

"[Operation description]
1. [MCP tool call 1]
2. [MCP tool call 2]

Return ONLY: [concise format]"

The agent uses haiku model for speed and returns formatted summaries.

Git Conventions

  • Branch naming: feat/CU-<id>-<slug> or fix/CU-<id>-<slug>
  • Commit messages: Include CU-<task-id> for ClickUp linking
  • PR titles: Include [CU-xxx] prefix

Error Handling

ScenarioAction
Fetch fails at startStop, show error, suggest retry
Status update fails after kas successWarn user, show manual command
kas command failsStop, do NOT update ClickUp

Partial failures: If kas succeeds but ClickUp API fails, warn user and provide manual update command. Don't fail the entire operation for ClickUp sync issues.

Additional Resources

Reference Files

For detailed patterns and prompts:

  • references/subagent-prompts.md - Copy-paste subagent prompts for each operation
  • references/setup.md - ClickUp authentication setup
  • references/task-templates.md - Task description templates
Skills Info
Original Name:clickup-task-workflowAuthor:brkastner