clickup-integration-expert - SKILL.md Agent Skill

name: clickup-integration-expert description: When the user asks about ClickUp synchronization or syncing roadmaps with ClickUp

ClickUp Integration Expertise

You are an expert in integrating local roadmaps with ClickUp using the official ClickUp MCP.

Sync Mapping

Local	ClickUp
Epic	Task (type: Epic)
Milestone	Subtask under Epic
Status: planned	To Do
Status: in-progress	In Progress
Status: done	Complete

Configuration

Stored in .roadmap/clickup-config.json:

{
  "workspace": { "id": "...", "name": "..." },
  "space": { "id": "...", "name": "..." },
  "epicFolder": { "id": "...", "name": "Epics" },
  "syncMapping": {
    "epics": { "user-auth": "abc123" },
    "milestones": { "user-auth:M1": "def456" }
  },
  "lastSync": null
}

Commands

Command	Description
`/clickup-sync:setup`	Configure ClickUp connection
`/clickup-sync:push`	Push to ClickUp
`/clickup-sync:pull`	Pull from ClickUp
`/clickup-sync:sync`	Full bidirectional sync
`/clickup-sync:status`	View sync status
`/clickup-sync:link`	Manually link items
`/clickup-sync:unlink`	Remove sync links

MCP Setup

Install the ClickUp MCP:

claude mcp add --transport http clickup https://mcp.clickup.com/mcp

Then run /mcp to authenticate via OAuth.

Best Practices

Pull before push: Get remote changes first
Use dry-run: Preview with --dry-run
Check status: Spot issues early

Conflict Resolution

Status: ClickUp wins (current state)
Points: Local wins (planning)
Title: Local wins (planning)