89 lines
3.2 KiB
Markdown
89 lines
3.2 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" \
|
|
--dependency TASK_ID
|
|
```
|
|
|
|
## 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).
|
|
|
|
## Stage Field (Required for ClickUp Runner)
|
|
|
|
Every task must have a **Stage** set or the runner will skip it. Set Stage to the first stage for the task type:
|
|
|
|
| Task Type | Initial Stage |
|
|
|-----------|---------------|
|
|
| Content Creation | `run_cora` |
|
|
| On Page Optimization | `run_cora` |
|
|
| Press Release | `draft` |
|
|
| Link Building | `run_cora` |
|
|
|
|
## Task Types
|
|
|
|
### Link Building
|
|
- **Prefix**: `LINKS - {keyword}`
|
|
- **Work Category**: "Link Building"
|
|
- **Stage**: `run_cora`
|
|
- **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"
|
|
- **Stage**: `run_cora`
|
|
- **Required fields**: Keyword, IMSURL
|
|
- **time estimate**: 3h
|
|
-
|
|
|
|
### Content Creation
|
|
- **Prefix**: `CREATE - {keyword}`
|
|
- **Work Category**: "Content Creation"
|
|
- **Stage**: `run_cora`
|
|
- **Required fields**: Keyword
|
|
- **time estimate**: 4h
|
|
|
|
### Press Release
|
|
- **Prefix**: `PR - {keyword}`
|
|
- **Work Category**: "Press Release"
|
|
- **Stage**: `draft`
|
|
- **Required fields**: Keyword, IMSURL
|
|
- **PR Topic**: if not provided, ask if there is a topic. it can be blank if they respond with none.
|
|
- **time estimate**: 1.5h
|
|
- **Headline tone trigger words**: By default, the PR writer assumes the company already offers the capability (awareness tone). To get announcement-style headlines (Announces, Launches, Introduces), include one of these words in the task name or PR Topic:
|
|
- **Introduces** -- company is introducing something new
|
|
- **New Product** -- new product or service launch
|
|
- **Launch** -- launching something new
|
|
- **Actual News** -- explicit override for announcement tone
|
|
|
|
## 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`.
|
|
|
|
## Dependencies and Due Dates
|
|
|
|
When a CREATE (NEW) task exists, LINKS and PR tasks that need the new page URL should be **blocked by** the CREATE task using `--dependency`. Their due date should be **one week after** the CREATE task's due date. For example, if CREATE is due 4/9, the LINKS and PR tasks should be due 4/16.
|
|
|
|
OPT tasks already have a URL, so LINKS paired with an OPT does **not** need a dependency -- just the +1 week due date offset.
|
|
|
|
## Client Folder Lookup
|
|
|
|
Tasks are created in the "Overall" list inside the client's folder. Folder name is matched case-insensitively.
|