ClickUp CLI Testing

What it does

When your agent uses it

• Running the clickup-cli unit or e2e test suite
• Adding test coverage for a new clickup-cli command
• Debugging a failing test against the E2E ClickUp workspace
• Finding out what fixture data the e2e tests expect

Example prompts

• “Run the clickup-cli unit tests for the sprint commands only.”
• “Add an e2e test that creates and deletes a task in the backlog list.”
• “The lifecycle e2e test is failing. Check whether the fixtures changed.”

Requirements

• Node and npm
• A CLICKUP_API_TOKEN in .env.test for e2e tests
• Access to the E2E test ClickUp workspace

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

1. 1Every command registered in Commander is listed in src/commands/metadata.ts
2. 2The docs/commands.md quick reference section matches what metadata generates

What it can do on your machine

Read from SKILL.md and the folder at commit a775de5. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm
  • node

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • CLICKUP_API_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

ClickUp CLI Testing loads about 1.4k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 463 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~61

When it runs · the whole SKILL.md, loaded when a task matches

~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:15

  2E tests require `CLICKUP_API_TOKEN` in `.env.test` and are not part of CI.

• NoteMentions a .env fileSKILL.md:23

  :e2e                  # e2e tests (needs .env.test)

• NoteMentions a .env fileSKILL.md:127

  # .env.test (gitignored)

• NoteMentions a .env fileSKILL.md:131

  Copy from `.env.test.example` and fill in your token.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from krodak/clickup-cli at commit a775de5, republished under its MIT licence (© krodak). 463 words, ~1,365 tokens.

name

testing-clickup-cli

description

Run and manage tests for clickup-cli. Covers unit tests, e2e tests against a real ClickUp workspace, and the test data setup. Use when running tests, adding test coverage, debugging test failures, or setting up test fixtures.

metadata.internal

true

npm test                          # all unit tests
npm test -- tests/unit/commands/  # just command tests
npm test -- -t "sprint"           # filter by test name
npm run test:e2e                  # e2e tests (needs .env.test)

const mockGetTask = vi.fn().mockResolvedValue({ id: 't1', name: 'Task' })

vi.mock('../../../src/api.js', () => ({
  ClickUpClient: vi.fn().mockImplementation(function () {
    return { getTask: mockGetTask }
  }),
}))

const { updateTask } = await import('../../../src/commands/update.js')
await updateTask({ apiToken: 'pk_t', teamId: 'team1' }, 't1', { status: 'done' })
expect(mockUpdateTask).toHaveBeenCalledWith('t1', { status: 'done' })

# .env.test (gitignored)
CLICKUP_API_TOKEN=pk_...   # personal workspace token

© krodak, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/testing-clickup-cli of krodak/clickup-cli.

Open the folder on GitHubat commit a775de5