---
name: aiskillstore-clickup-integration-expert
description: "When the user asks about ClickUp synchronization or syncing roadmaps with ClickUp"
metadata:
  decimalai-skill-id: "c5229c4b-232e-40ac-a06d-cf7a2e7f3c5c"
  decimalai-version-id: "9035cc09-97ba-47bb-b621-821182f0035a"
  decimalai-version: "1"
  decimalai-body-sha256: "a67a66f8b3ddd03535423cc8ac3e5b53d3309f5c29426c7a2b4ba632b16fdbbd"
  decimalai-name: "aiskillstore/clickup-integration-expert"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "productivity"
  decimalai-source: "https://app.decimal.ai/s/aiskillstore-clickup-integration-expert@1/SKILL.md"
---
# 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`:

```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:
```bash
claude mcp add --transport http clickup https://mcp.clickup.com/mcp
```

Then run `/mcp` to authenticate via OAuth.

## Best Practices

1. **Pull before push**: Get remote changes first
2. **Use dry-run**: Preview with `--dry-run`
3. **Check status**: Spot issues early

## Conflict Resolution

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