CheddahBot/docs/clickup-task-creation.md

62 lines
1.8 KiB
Markdown

# ClickUp Task Creation
## CLI Script
```bash
uv run python scripts/create_clickup_task.py --name "LINKS - keyword" --client "Client Name" \
--category "Link Building" --due-date 2026-03-18 --tag mar26 --time-estimate 2h \
--field "Keyword=keyword" --field "IMSURL=https://example.com" --field "LB Method=Cora Backlinks"
```
## Defaults
- Priority: High (2)
- Assignee: Bryan (10765627)
- Status: "to do"
- Due date format: YYYY-MM-DD
- Tag format: mmmYY (e.g. feb26, mar26)
## Custom Fields
Any field can be set via `--field "Name=Value"`. Dropdowns are auto-resolved by name (case-insensitive).
## Task Types
### Link Building
- **Prefix**: `LINKS - {keyword}`
- **Work Category**: "Link Building"
- **Required fields**: Keyword, IMSURL
- **LB Method**: default "Cora Backlinks"
- **CLIFlags**: only add `--tier1-count N` when count is specified
- **BrandedPlusRatio**: default to 0.7
- **CustomAnchors**: only if given a list of custom anchors
- **time estimate**: 2.5h
### On Page Optimization
- **Prefix**: `OPT - {keyword}`
- **Work Category**: "On Page Optimization"
- **Required fields**: Keyword, IMSURL
- **time estimate**: 3h
-
### Content Creation
- **Prefix**: `CREATE - {keyword}`
- **Work Category**: "Content Creation"
- **Required fields**: Keyword
- **time estimate**: 4h
### Press Release
- **Prefix**: `PR - {keyword}`
- **Required fields**: Keyword, IMSURL
- **Work Category**: "Press Release"
- **PR Topic**: if not provided, ask if there is a topic. it can be blank if they respond with none.
- **time estimate**: 1.5h
## Chat Tool
The `clickup_create_task` tool provides the same capabilities via CheddahBot UI. Arbitrary custom fields are passed as JSON via `custom_fields_json`.
## Client Folder Lookup
Tasks are created in the "Overall" list inside the client's folder. Folder name is matched case-insensitively.