Agent Skills › civitai/civitai › clickup

clickup

GitHub

通过 API 与 ClickUp 交互，支持获取任务详情、查看评论、创建和管理任务、更新状态及分配等。

apps/event-engine/.claude/skills/clickup/SKILL.md civitai/civitai

Trigger Scenarios

用户需要查询或操作 ClickUp 任务用户提及 ClickUp 任务 URL 或 ID

Install

npx skills add civitai/civitai --skill clickup -g -y

More Options

Non-standard path

npx skills add https://github.com/civitai/civitai/tree/main/apps/event-engine/.claude/skills/clickup -g -y

Use without installing

npx skills use civitai/civitai@clickup

指定 Agent (Claude Code)

npx skills add civitai/civitai --skill clickup -a claude-code -g -y

安装 repo 全部 skill

npx skills add civitai/civitai --all -g -y

预览 repo 内 skill

npx skills add civitai/civitai --list

SKILL.md

Frontmatter

{
    "name": "clickup",
    "description": "Interact with ClickUp tasks - get task details, view comments, create and manage tasks. Use when working with ClickUp task URLs or IDs."
}

ClickUp

Interact with ClickUp tasks via the API. Get task information, view comments, create tasks, manage assignments, and post updates.

Setup

Copy .env-example to .env in this skill directory
Add your ClickUp Personal API Token (starts with pk_)
Generate token at: ClickUp Settings > Apps > API Token

cp .claude/skills/clickup/.env-example .claude/skills/clickup/.env
# Edit .env and add your token

Team ID and User ID are auto-detected and cached on first use.

Default List (Optional)

Set CLICKUP_DEFAULT_LIST_ID in .env to enable creating tasks without specifying a list:

# In .claude/skills/clickup/.env
CLICKUP_DEFAULT_LIST_ID=901111220963

Running Commands

node .claude/skills/clickup/query.mjs <command> [options]

Commands

Command	Description
`get <url\|id>`	Get task details (name, description, status, assignees, etc.)
`comments <url\|id>`	List comments on a task
`comment <url\|id> "message"`	Post a comment to a task (supports markdown)
`status <url\|id> [status]`	Update task status (or list available statuses)
`tasks <list_id>`	List tasks in a list
`me`	Show current user info
`create [list_id] "title"`	Create a new task (list_id optional if default set)
`my-tasks`	List all tasks assigned to you across workspace
`search "query"`	Search tasks by name or description
`assign <task> <user>`	Assign task to a user (by name, email, or ID)
`due <task> "date"`	Set due date (e.g., "tomorrow", "friday", "+3d")
`priority <task> <level>`	Set priority (urgent, high, normal, low, none)
`subtask <task> "title"`	Create a subtask
`move <task> <list_id>`	Move task to a different list
`link <task> <url> ["desc"]`	Add external link reference (as comment)
`checklist <task> "item"`	Add checklist item to task
`delete-comment <comment_id>`	Delete a comment
`watch <task> <user>`	Notify user via @mention comment (watchers not supported in API)
`tag <task> "tag_name"`	Add a tag to task
`description <task> "text"`	Update task description (markdown supported)

Options

Flag	Description
`--json`	Output raw JSON response
`--subtasks`	Include subtasks when getting task details
`--me`	Filter to tasks assigned to me (for tasks command)

Examples

Get Task Details

# Using full URL
node .claude/skills/clickup/query.mjs get "https://app.clickup.com/t/86a1b2c3d"

# Using task ID directly
node .claude/skills/clickup/query.mjs get 86a1b2c3d

# Include subtasks
node .claude/skills/clickup/query.mjs get 86a1b2c3d --subtasks

Create a Task

# With explicit list ID
node .claude/skills/clickup/query.mjs create 901111220963 "New feature: dark mode"

# Using default list (if CLICKUP_DEFAULT_LIST_ID is set)
node .claude/skills/clickup/query.mjs create "Quick task"

List My Tasks

# All tasks assigned to you across the workspace
node .claude/skills/clickup/query.mjs my-tasks

Search Tasks

node .claude/skills/clickup/query.mjs search "authentication"

Update Task Status

# List available statuses for a task
node .claude/skills/clickup/query.mjs status 86a1b2c3d

# Update status (case-insensitive, partial match)
node .claude/skills/clickup/query.mjs status 86a1b2c3d "in progress"
node .claude/skills/clickup/query.mjs status 86a1b2c3d "complete"

Assign Tasks

# Assign by username
node .claude/skills/clickup/query.mjs assign 86a1b2c3d justin

# Assign by email
node .claude/skills/clickup/query.mjs assign 86a1b2c3d jane@example.com

Set Due Dates

node .claude/skills/clickup/query.mjs due 86a1b2c3d "tomorrow"
node .claude/skills/clickup/query.mjs due 86a1b2c3d "next friday"
node .claude/skills/clickup/query.mjs due 86a1b2c3d "+3d"
node .claude/skills/clickup/query.mjs due 86a1b2c3d "2024-01-15"

Set Priority

node .claude/skills/clickup/query.mjs priority 86a1b2c3d urgent
node .claude/skills/clickup/query.mjs priority 86a1b2c3d high
node .claude/skills/clickup/query.mjs priority 86a1b2c3d none  # Clear priority

Create Subtasks

node .claude/skills/clickup/query.mjs subtask 86a1b2c3d "Write unit tests"
node .claude/skills/clickup/query.mjs subtask 86a1b2c3d "Update documentation"

Move Tasks

node .claude/skills/clickup/query.mjs move 86a1b2c3d 901111220964

Add Links

# Add link with description
node .claude/skills/clickup/query.mjs link 86a1b2c3d "https://github.com/..." "PR #123"

# Add link without description
node .claude/skills/clickup/query.mjs link 86a1b2c3d "https://docs.example.com/guide"

Add Checklist Items

node .claude/skills/clickup/query.mjs checklist 86a1b2c3d "Review code"
node .claude/skills/clickup/query.mjs checklist 86a1b2c3d "Run tests"
node .claude/skills/clickup/query.mjs checklist 86a1b2c3d "Deploy to staging"

List Tasks in a List

# All tasks in a list
node .claude/skills/clickup/query.mjs tasks 901111220963

# Only tasks assigned to me
node .claude/skills/clickup/query.mjs tasks 901111220963 --me

View Comments

node .claude/skills/clickup/query.mjs comments "https://app.clickup.com/t/86a1b2c3d"

Show Current User

node .claude/skills/clickup/query.mjs me

Delete a Comment

# Get comment IDs from the comments command (shown in --json output)
node .claude/skills/clickup/query.mjs delete-comment 90110200841741

Notify Users (Watch)

# Notify user via @mention comment (ClickUp API doesn't support adding watchers directly)
node .claude/skills/clickup/query.mjs watch 86a1b2c3d koen

# Notify by email
node .claude/skills/clickup/query.mjs watch 86a1b2c3d jane@example.com

Add Tags

# Add a tag to a task
node .claude/skills/clickup/query.mjs tag 86a1b2c3d "DevOps"
node .claude/skills/clickup/query.mjs tag 86a1b2c3d "bug"

Update Description

# Update task description with markdown
node .claude/skills/clickup/query.mjs description 86a1b2c3d "## Summary
This is a **bold** statement.

- Item 1
- Item 2

See [documentation](https://example.com) for more info."

Task/List URL Formats

The skill recognizes these ClickUp URL formats:

https://app.clickup.com/t/{task_id}
https://app.clickup.com/{team_id}/v/li/{list_id}?p={task_id}
Direct task ID: 86a1b2c3d
Direct list ID: 901111220963

Output Format

Task Details

Task: Implement user authentication
Status: In Progress
Priority: High
Assignees: John Doe, Jane Smith
Due: 2024-01-15
Created: 2024-01-10
URL: https://app.clickup.com/t/86a1b2c3d

Description:
Add OAuth2 authentication with Google and GitHub providers...

Task List

[to do] Fix login bug
  ID: 868h2cxat | Priority: high | Assignees: John Doe
  https://app.clickup.com/t/868h2cxat

[in progress] Update API docs
  ID: 868g7c75u | Priority: None | Assignees: Jane Smith
  https://app.clickup.com/t/868g7c75u

Total: 2 task(s)

Comments

[2024-01-12 14:30] John Doe:
  Started working on this. Will push initial commit today.

[2024-01-12 16:45] Jane Smith:
  @John looks good! Let me know when ready for review.