From clickup-ticket
Fetch, filter, and create ClickUp tickets directly from Claude Code or Codex. Read tickets by ID, filter by status/assignee/tags/dates, view your assigned tickets, create tickets interactively, and manage multi-org workspaces with intelligent caching.
npx claudepluginhub diversioteam/agent-skills-marketplace --plugin clickup-ticketThis skill is limited to using the following tools:
Use this skill when you want to:
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Migrates code, prompts, and API calls from Claude Sonnet 4.0/4.5 or Opus 4.1 to Opus 4.5, updating model strings on Anthropic, AWS, GCP, Azure platforms.
Automates semantic versioning and release workflow for Claude Code plugins: bumps versions in package.json, marketplace.json, plugin.json; verifies builds; creates git tags, GitHub releases, changelogs.
Use this skill when you want to:
This skill is designed to feel personalized: it learns your workspace structure, remembers your defaults, and asks simple questions when it needs information.
Generate a personal API token:
pk_)Add to your shell profile (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish):
export CLICKUP_TICKET_SKILL_TOKEN="pk_12345_XXXXXXXXXX"
Then reload your shell:
source ~/.bashrc # or restart your terminal
Note: If you have multiple ClickUp accounts, you can set up additional tokens. See Usage workflows for the multi-org flow.
# First time? Configure the skill
/clickup-ticket:configure
# Create a ticket interactively
/clickup-ticket:create-ticket
# Quick ticket with defaults
/clickup-ticket:quick-ticket "Fix login timeout bug"
# Add to backlog instantly
/clickup-ticket:add-to-backlog "Refactor auth module"
| Command | Purpose |
|---|---|
/clickup-ticket:get-ticket | Fetch full details of a single ticket |
/clickup-ticket:list-tickets | List/filter tickets with powerful filtering |
/clickup-ticket:my-tickets | Quick view of tickets assigned to you |
/clickup-ticket:configure | First-time setup, set defaults, refresh cache |
/clickup-ticket:create-ticket | Full interactive ticket creation |
/clickup-ticket:quick-ticket | Fast ticket creation with defaults |
/clickup-ticket:create-subtask | Add subtask to an existing ticket |
/clickup-ticket:add-to-backlog | Ultra-fast addition to backlog list |
/clickup-ticket:list-spaces | Discover spaces, lists, folders, tags |
/clickup-ticket:switch-org | Switch between organizations |
/clickup-ticket:add-org | Add a new organization |
/clickup-ticket:refresh-cache | Force refresh cached workspace data |
Workspace (Organization)
└── Space (e.g., "Engineering", "Product")
├── Folder (optional grouping)
│ └── List (e.g., "Auth Refactor")
│ └── Task
│ └── Subtask
└── List (standalone, e.g., "Backlog")
└── Task
└── Subtask
Key points:
list_id to create a taskThis skill supports multiple ClickUp organizations:
Each organization has its own:
Switch between orgs with /clickup-ticket:switch-org.
The skill caches your workspace data locally for fast access:
Cache location: ~/.config/clickup-ticket/ (shared by Claude Code and Codex)
Cache refresh:
/clickup-ticket:refresh-cache/clickup-ticket:get-ticket <id|url>
Fetch complete details for any ticket you have access to.
Accepted inputs:
abc123 or #abc123https://app.clickup.com/t/abc123DEV-123 (requires --org when workspace context is needed)Flags:
--subtasks - Include full subtask details--comments - Include recent comments (last 10)--markdown - Return description with markdown formatting--org=<slug> - Specify organization for custom IDs/clickup-ticket:list-tickets [filters]
Powerful workspace-wide filtering using the Get Filtered Team Tasks API.
| Filter | Description | Example |
|---|---|---|
--list=<name|id> | Filter by list | --list=Backlog |
--space=<name|id> | Filter by space | --space=Engineering |
--project=<name|id> | Filter by project/folder | --project=Projects |
--status=<status> | Filter by status | --status="in progress" |
--assignee=<email|me> | Filter by assignee | --assignee=me |
--tag=<tags> | Filter by tags | --tag=bug,urgent |
--priority=<1-4> | Filter by priority | --priority=1 |
--due-before=<date> | Due before date | --due-before=2024-02-01 |
--due-after=<date> | Due after date | --due-after=tomorrow |
--created-after=<date> | Created after | --created-after="last week" |
--include-closed | Include closed tasks | (flag) |
--subtasks | Include subtasks | (flag) |
--limit=<n> | Limit results | --limit=50 |
--page=<n> | Pagination | --page=2 |
--sort=<field> | Sort by field | --sort=due_date |
--reverse | Reverse sort | (flag) |
Supported date formats:
2024-01-31today, tomorrow, yesterdaynext week, last monday, in 3 days/clickup-ticket:my-tickets
Quick view of tickets assigned to you, grouped by urgency.
Default behavior:
Flags:
--overdue - Show only overdue tickets--due-today - Show tickets due today--due-this-week - Show tickets due this week--space=<name> - Filter by space--include-closed - Include completed ticketsThe ClickUp API does not support text search by task name or description.
Workarounds:
--tag, --list, --status, --assignee) to narrow results.get-ticket directly.list-spaces to find the right list, then filter by list.Response limits:
--page for pagination/clickup-ticket:configure should:
To add additional organizations:
/clickup-ticket:add-org
If a client workspace uses a separate token, point the command at a dedicated
environment variable. See references/usage-workflows.md for the full example.
/clickup-ticket:create-ticket
Walks you through:
/clickup-ticket:quick-ticket "Title here"
Creates a ticket instantly with defaults.
Flags:
--priority=high or -p high - Override priority--list=bugs - Override list--org=personal - Create in different org--tag=backend,urgent - Add tags/clickup-ticket:add-to-backlog "Title"
Ultra-fast backlog addition. Always uses your configured backlog list.
/clickup-ticket:create-subtask <parent_id> "Title"
The parent can be:
abc123https://app.clickup.com/t/abc123DEV-123/clickup-ticket:list-spaces
Shows your workspace structure, cached members, and available tags.
Flags:
--org=personal - Show different org--members - Also list team members--tags - Also list all tags/clickup-ticket:switch-org
Or switch directly: /clickup-ticket:switch-org personal
/clickup-ticket:add-org
Interactive wizard to add a new org from your accessible workspaces.
For detailed technical documentation, see the references/ directory:
Cache location: ~/.config/clickup-ticket/ (shared by Claude Code and Codex)
Rate limits: The skill handles 429 responses with automatic retry and backoff.
Cache TTL: 24 hours (configurable). Use /clickup-ticket:refresh-cache to force refresh.
Use usage-workflows.md for: