project-clickup

Query and manage ClickUp tasks for incident tracking and investigation documentation.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill project-clickup-erwinv2k-tkg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-clickup
Source: https://github.com/erwinv2k-TKG/AgentesVSC/tree/main/packs/incidentfox/sre-agent/.claude/skills/project-clickup
Command: npx skills add https://github.com/erwinv2k-TKG/AgentesVSC --skill project-clickup-erwinv2k-tkg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? During incident response, SRE teams need to find existing incident tickets, review prior investigation notes, and document findings without leaving their investigation workflow. This Skill connects directly to the ClickUp API so tasks, comments, and workspace structure can be searched and updated from the command line. ## Core Features & Use Cases - Workspace Discovery: List teams, spaces, folders, and lists to locate where incidents are tracked. - Task Search & Retrieval: Search tasks by query, status, assignee, or time range, and fetch full task details including comments and subtasks. - Investigation Documentation: Add markdown-formatted comments to tasks to record root cause findings and remediation steps. - Use Case: While investigating a payment service outage, search ClickUp for related open incidents, review prior comments for clues, then post your root cause analysis as a comment on the incident task. ## Quick Start Ask the agent to search ClickUp for open incidents related to the payment service and add a comment summarizing the root cause to the matching task.

Frequently Asked Questions about project-clickup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search ClickUp tasks from the command line?

Run search_tasks.py with a --query flag to match task names and descriptions, and combine it with --status, --assignee, or --updated-since filters. Add --json for machine-readable output suitable for scripting.

How do I add a comment to a ClickUp task with Python?

Use add_comment.py with the task ID and a --message argument, which supports markdown formatting. The script calls the ClickUp API task comment endpoint and returns the created comment ID.

What authentication does the ClickUp API integration require?

In production, credentials are injected through a credential-proxy service using JWT authentication. For local development, set the CLICKUP_API_TOKEN environment variable, and optionally CLICKUP_TEAM_ID to avoid auto-detection.

Can I filter ClickUp tasks by status or update time?

Yes, search_tasks.py supports --status filters that can be repeated for multiple statuses, plus --updated-since and --created-since arguments accepting relative ranges like 1h, 24h, or 7d.

Why does the ClickUp script fail with an authentication error?

The error occurs when CLICKUP_API_TOKEN is not set in direct mode or the credential-proxy URL is unreachable. Verify the environment variables and confirm the token has access to the target workspace.