# Add

> Add a new task to ClickUp directly (no AI processing) Use when this capability is needed.

- Skill: `tomevault-io/add-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/add-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/add-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/add-3

---


# /clickup:add - Add New Task

## Purpose
Create a new task in ClickUp directly. No AI processing - just sends the data straight to ClickUp.

## Usage
```
/clickup:add <title> <tag> [description]
```

## Parameters
- `title` (required): Task title
- `tag` (required): Tag name (bug, story, task, etc.)
- `description` (optional): Task description

## Examples
```
/clickup:add "Fix login button" bug
/clickup:add "User profile page" story "Add ability to edit profile picture and bio"
/clickup:add "Update README" task
/clickup:add "Payment integration" feature "Integrate Stripe for subscription payments"
```

## Behavioral Flow

1. **Parse Arguments**:
   - Extract title (required)
   - Extract tag (required)
   - Extract description (optional)

2. **Create Task** (direct API call, no AI):
   ```bash
   curl -X POST "https://api.clickup.com/api/v2/list/${CLICKUP_LIST_ID}/task" \
     -H "Authorization: ${CLICKUP_TOKEN}" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "{title}",
       "tags": ["{tag}"],
       "description": "{description}"  // only if provided
     }'
   ```

3. **Output Result**:
   ```
   ✅ Task created!

   📋 Title: Fix login button
   🏷️ Tag: bug
   🆔 ID: 86ew3xxxx

   🔗 View: https://app.clickup.com/t/86ew3xxxx
   ```

## API Endpoint

**Create Task**:
```
POST https://api.clickup.com/api/v2/list/{list_id}/task
```

**Request Body (with description)**:
```json
{
  "name": "Task title",
  "tags": ["bug"],
  "description": "Optional description",
  "status": "to do"
}
```

**Request Body (without description)**:
```json
{
  "name": "Task title",
  "tags": ["story"],
  "status": "to do"
}
```

## Error Handling

- Missing title: "Error: Title is required. Usage: /clickup:add <title> <tag> [description]"
- Missing tag: "Error: Tag is required. Usage: /clickup:add <title> <tag> [description]"
- API error: Show ClickUp error message
- Invalid tag: Task created, tag may not appear if it doesn't exist in space

## Notes

- Task is created with status "to do" by default
- No AI processing - data goes directly to ClickUp as provided
- Tags are case-insensitive in ClickUp

ARGUMENTS: $ARGUMENTS

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/methuz) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->