skill CX Codex
Open on GitHub
clickup — Claude Code skill: manage ClickUp tasks from the CLI
This skill hands your agent the ClickUp API: read a task, list comments, create and assign work. Handy when a task link lands in the chat.
Install into Claude Code · Skills CLI (Vercel)
All methods and platforms ↓
npx skills add civitai/civitai --skill clickup -a claude-codeWhat clickup does
Everything goes through one script, query.mjs, called as node .claude/skills/clickup/query.mjs <command> [options]. There are over twenty commands — get, comments, comment, status, tasks, create, my-tasks, search, assign, due, priority, subtask, move, link, checklist, delete-comment, watch, tag, description. Both a full URL like https://app.clickup.com/t/{task_id} and a bare ID such as 86a1b2c3d are accepted.
Setup takes one file. Copy .env-example to .env inside the skill folder and paste your ClickUp Personal API Token, the one starting with pk_, which you generate under Settings > Apps > API Token. Team ID and User ID are detected and cached on the first call. Skip the token and nothing runs.
Set CLICKUP_DEFAULT_LIST_ID in the same .env if you want to create tasks without naming a list each time. --json returns the raw API response, --subtasks pulls subtasks into get, and --me narrows a task list to your own assignments. ClickUp's API has no way to add watchers, so the watch command posts a comment with an @mention instead.
What it helps with
- check a task's status and assignees straight from a link
- create a task in a given list without opening the browser
- assign an owner and set a due date in one call
- find tasks by a word in the title or description
- post a progress comment on a task
Example prompts for the agent
- Pull up task
https://app.clickup.com/t/86a1b2c3dand tell me who's on it - Create a task called “Fix login” in list
901111220963and set it due tomorrow - List every task assigned to me
How to install clickup
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill clickup -a claude-code2Manually: put the files in place
~/.claude/skills/clickup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/clickup/
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill clickup -a codex2Manually: put the files in place
.agents/skills/clickup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add civitai/civitai --skill clickup -a cursor2Manually: put the files in place
.cursor/skills/clickup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install civitai/civitai clickup2Manually: put the files in place
.github/skills/clickup/SKILL.md1Skills CLI (Vercel)
npx skills add civitai/civitai --skill clickup -a gemini-cli2Platform CLI
gemini skills install https://github.com/civitai/civitai --path apps/event-engine/.claude/skills/clickupManually: put the files in place
.devin/skills/clickup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add civitai/civitai --skill clickup -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about clickup
How do I install the clickup skill in Claude Code?
Run npx skills add civitai/civitai --skill clickup -a claude-code. The skill file lands at ~/.claude/skills/clickup/SKILL.md.
What does the clickup skill do?
It talks to the ClickUp API to read task details and comments, create tasks and subtasks, change status, priority and due date, and add tags or checklist items.
What do I need before using it?
A ClickUp Personal API Token starting with pk_, placed in .env inside the skill directory. Team ID and User ID are resolved automatically the first time you run a command.
Source text
SKILL.md · Apache-2.0
--- 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 1. Copy `.env-example` to `.env` in this skill directory 2. Add your ClickUp Personal API Token (starts with `pk_`) 3. Generate token at: ClickUp Settings > Apps > API Token ```bash 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: ```bash # In .claude/skills/clickup/.env CLICKUP_DEFAULT_LIST_ID=901111220963 ``` ## Running Commands ```bash 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 ```bash # 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 ```bash # 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 ```bash # All tasks assigned to you across the workspace node .claude/skills/clickup/query.mjs my-tasks ``` ### Search Tasks ```bash node .claude/skills/clickup/query.mjs search "authentication" ``` ### Update Task Status ```bash # 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 ```bash # Assign by username node .claude/skills/clickup/query.mjs assign 86a1b2c3d jane # Assign by email node .claude/skills/clickup/query.mjs assign 86a1b2c3d [email protected] ``` ### Set Due Dates ```bash 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 ```bash 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 ```bash node .claude/skills/clickup/query.mjs subtask 86a1b2c3d "Write unit tests" node .claude/skills/clickup/query.mjs subtask 86a1b2c3d "Update documentation" ``` ### Move Tasks ```bash node .claude/skills/clickup/query.mjs move 86a1b2c3d 901111220964 ``` ### Add Links ```bash # 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 ```bash 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 ```bash # 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 ```bash node .claude/skills/clickup/query.mjs comments "https://app.clickup.com/t/86a1b2c3d" ``` ### Post a Comment ```bash node .claude/skills/clickup/query.mjs comment 86a1b2c3d "Starting work on this task" # Multi-line comment node .claude/skills/clickup/query.mjs comment 86a1b2c3d "Status update: - Completed initial review - Found 3 issues to address - Will submit PR by EOD" ``` ### Show Current User ```bash node .claude/skills/clickup/query.mjs me ``` ### Delete a Comment ```bash # Get comment IDs from the comments command (shown in --json output) node .claude/skills/clickup/query.mjs delete-comment 90110200841741 ``` ### Notify Users (Watch) ```bash # Notify user via @mention comment (ClickUp API doesn't support adding watchers directly) node .claude/skills/clickup/query.mjs watch 86a1b2c3d john # Notify by email node .claude/skills/clickup/query.mjs watch 86a1b2c3d [email protected] ``` ### Add Tags ```bash # 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 ```bash # 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. ``` ## When to Use - **Understanding context**: Get task details before starting work - **Quick task creation**: Create tasks without leaving your terminal - **Daily standups**: Use `my-tasks` to see your assignments - **Status updates**: Post progress comments as you work - **Task management**: Assign, prioritize, and set due dates - **Collaboration**: View recent comments for context, add watchers - **Task organization**: Add tags to categorize tasks - **Task linking**: Reference task IDs in commit messages ## Tips - Team ID, User ID, and default list ID are auto-cached in `.env` - Set `CLICKUP_DEFAULT_LIST_ID` to skip list_id when creating team tasks - Use `my-tasks` for a quick overview of your assignments - Use natural language dates: "tomorrow", "next friday", "+3d" - Post comments to keep stakeholders updated on progress - Include task IDs in commit messages for traceability - Use `--json` for scripting or piping to other tools
© civitai · Apache-2.0 · civitai/civitai
Similar skills
Everything for Notes, tasks and projects →
find-skills Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project.
CX Codex +1
4,000,000installs
grill-me grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts.
1,424,476installs
grill-with-docs This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition.
1,219,756installs
handoff Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent.
1,038,491installs
grilling Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting.
979,543installs
teach Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project.
862,247installs
