discountry/ritmex-skills/clickup

ClickUp

Use the global clickup CLI. See README.md for installation, configuration, and command reference.

Rules

• Do not read .env or secrets.
• Read shell environment variables.
• Use --json for structured output.
• Read current state before writes unless the requested change is already exact.

Checks

1. Run clickup --help.
2. On missing CLI, auth, or workspace errors, point to README.md.

Commands

Execution

1. Normalize the target.
2. Read with the narrowest command.
3. Apply the smallest write.
4. Re-read only when the user needs confirmation.

Notes

• clickup status <task> lists valid statuses.
• Status updates allow partial matching.
• assign and watch resolve username, email, or user ID.
• clickup due <task> clear and clickup due <task> none clear due dates.
• clickup docs ["query"] also supports --id, --creator, --deleted, --archived, --parent-id, --parent-type, --limit.
• clickup doc <doc_id> supports --max-page-depth.
• clickup create-page <doc_id> "title" supports --parent-page-id, --sub-title, --content-format.
• clickup edit-page <doc_id> <page_id> requires --name, --sub-title, or --content. It also supports --content-edit-mode and --content-format.
• watch posts an @mention comment.

URL Structure

Use correct ClickUp URL formats:

• Task: https://app.clickup.com/t/{task_id}
• Doc: https://app.clickup.com/{workspace_id}/v/dc/{doc_id}/{page_id}

Document Creation Best Practices

When creating ClickUp docs:

1. Set both doc title (via create-doc "title") and page name (via edit-page --name "page title"), never leave page name null.
2. Always use --content-format text/md for markdown content; otherwise markdown syntax may be escaped.
3. Do not repeat the document title inside page content—the title is separate metadata.
4. Verify Doc URLs contain all three IDs: workspace, doc, and page.