3.2 KiB

Raw Blame History

ClickUp Task Creation

CLI Script

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.

3.2 KiB Raw Blame History