clickup-debug-bundle
Collect a minimal redacted ClickUp connectivity and contract bundle without task bodies, tokens, or webhook secrets. Use when escalating a ClickUp API incident. Trigger with "ClickUp debug bundle", "ClickUp diagnostics", or "collect ClickUp evidence".
Allowed Tools
Provided by Plugin
clickup-pack
Production-grade Claude Code operator workflows for governed ClickUp integrations (24 skills)
Installation
This skill is included in the clickup-pack plugin:
/plugin install clickup-pack@claude-code-plugins-plus
Click to copy
Instructions
ClickUp Redacted Diagnostic Bundle
Overview
Create supportable evidence while preventing a troubleshooting artifact from becoming a second sensitive-data store. Make every included field explainable to the named reviewer.
Prerequisites
- An incident identifier, approved output directory, retention deadline, and named reviewer
- A scoped credential stored outside command history and artifact content
- An allow-list of read-only probes and fields
Tool Discipline
Use Read, Glob, and Grep to inspect the repository, adapters, configuration names, tests, and evidence. Use WebFetch only for current official ClickUp documentation. Use Write or Edit after confirming the target file, Workspace boundary, and requested mode.
Current Contract
- Useful evidence includes status, endpoint version, latency, response type, sanitized error code, and rate headers.
GET /api/v2/userandGET /api/v2/teamcan prove identity and authorized Workspaces without reading task content.- Provider status is separate from tenant authorization and application behavior.
- Authorization headers, response bodies, user emails, task names, comments, attachments, and webhook secrets are excluded.
Authentication
Use a personal token only for accountable individual/testing work or OAuth Authorization Code for a user-facing integration. Inject the token server-side through a governed secret reference, send it in Authorization, verify authorized Workspace IDs, and never print the token, OAuth client secret, or webhook secret.
Instructions
- Confirm incident scope, collection owner, field allow-list, output path, and deletion deadline.
- Inspect local configuration names and versions without printing values.
- Run bounded read-only identity/workspace and status probes; capture only approved metadata.
- Record sanitized rate headers, status codes, timings, schema digests, and local adapter versions.
- Scan the bundle for credential and content patterns; require human review before sharing.
- Hash, transfer through the approved channel, and delete or retain on schedule.
Approval Boundaries
Do not add raw headers, full environment dumps, task payloads, member records, or attachments to make the bundle more convenient.
Output
Return bundle path, SHA-256, included field classes, excluded classes, scan result, reviewer, sharing decision, and deletion deadline.
Error Handling
| Condition | Response |
|---|---|
| Redaction scan finds a secret | Do not share; quarantine, rotate, and regenerate. |
| Probe would read work content | Skip it and record the evidence gap. |
| Output directory is uncontrolled | Refuse collection until a governed location exists. |
| Incident scope expands | Obtain a new collection approval. |
Examples
The example below is a redacted operator receipt; it contains no task text, member data, credential, or webhook secret.
incident=CU-142; probes=3; task-bodies=0; secrets=0; sha256=recorded; review=approved; delete-by=2026-09-17