@krodak/clickup-cli 1.17.0 → 1.18.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup-cli",
   "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cup command",
-  "version": "1.17.0",
+  "version": "1.18.1",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -73,9 +73,18 @@ cup init
 
 ## Set up your agent
 
-The package includes a [skill file](https://agentskills.io) that teaches agents all available commands and when to use them. All three major coding agents support skills natively:
+The package includes a [skill file](https://agentskills.io) that teaches agents all available commands. Install it with:
 
-<details open>
+```bash
+cup skill
+```
+
+This detects which agents you have (Claude Code, Codex, OpenCode) and installs the skill to the right locations. Run it again after updating `cup` to refresh the skill.
+
+<details>
+<summary>Manual install options</summary>
+
+<details>
 <summary>&nbsp;<img src="https://img.shields.io/badge/Claude_Code-D97757?logo=anthropic&logoColor=white" height="18" align="center">&nbsp;<strong>Claude Code</strong></summary>
 
 **Install as a [plugin](https://docs.anthropic.com/en/docs/claude-code/plugins)** (recommended):
@@ -84,14 +93,10 @@ The package includes a [skill file](https://agentskills.io) that teaches agents
 claude plugin add $(npm root -g)/@krodak/clickup-cli
 ```
 
-This registers the skill under the `clickup-cli:` namespace. Claude loads it automatically when you work with ClickUp tasks.
-
-**Or install as a personal skill** (no namespace prefix):
+**Or as a personal skill:**
 
 ```bash
-SKILL=$(npm root -g)/@krodak/clickup-cli/skills/clickup-cli
-mkdir -p ~/.claude/skills/clickup
-cp "$SKILL/SKILL.md" ~/.claude/skills/clickup/SKILL.md
+cup skill --path ~/.claude/skills/clickup/SKILL.md
 ```
 
 </details>
@@ -99,35 +104,23 @@ cp "$SKILL/SKILL.md" ~/.claude/skills/clickup/SKILL.md
 <details>
 <summary>&nbsp;<img src="https://img.shields.io/badge/Codex-412991?logo=openai&logoColor=white" height="18" align="center">&nbsp;<strong>Codex</strong></summary>
 
-Codex supports [agent skills](https://developers.openai.com/codex/skills) across CLI, IDE extension, and web. Skills use the same `SKILL.md` format with YAML frontmatter.
-
-**Install as a user skill** (available across all your projects):
-
 ```bash
-SKILL=$(npm root -g)/@krodak/clickup-cli/skills/clickup-cli
-mkdir -p ~/.agents/skills/clickup
-cp "$SKILL/SKILL.md" ~/.agents/skills/clickup/SKILL.md
+cup skill --path ~/.agents/skills/clickup/SKILL.md
 ```
 
-**Or install as a project skill** (checked into your repo):
+Or for a project-level skill:
 
 ```bash
-SKILL=$(npm root -g)/@krodak/clickup-cli/skills/clickup-cli
-mkdir -p .agents/skills/clickup
-cp "$SKILL/SKILL.md" .agents/skills/clickup/SKILL.md
+cup skill --path .agents/skills/clickup/SKILL.md
 ```
 
-You can also use the built-in installer: `$skill-installer clickup`
-
 </details>
 
 <details>
 <summary>&nbsp;<img src="https://img.shields.io/badge/OpenCode-24292e?logoColor=white" height="18" align="center">&nbsp;<strong>OpenCode</strong></summary>
 
 ```bash
-SKILL=$(npm root -g)/@krodak/clickup-cli/skills/clickup-cli
-mkdir -p ~/.config/opencode/skills/clickup
-cp "$SKILL/SKILL.md" ~/.config/opencode/skills/clickup/SKILL.md
+cup skill --path ~/.config/opencode/skills/clickup/SKILL.md
 ```
 
 </details>
@@ -135,7 +128,13 @@ cp "$SKILL/SKILL.md" ~/.config/opencode/skills/clickup/SKILL.md
 <details>
 <summary>&nbsp;<strong>Other agents</strong></summary>
 
-The skill file follows the [Agent Skills](https://agentskills.io) open standard. Copy `skills/clickup-cli/SKILL.md` into your agent's skill directory, system prompt, or `AGENTS.md`.
+```bash
+cup skill --print > SKILL.md   # output skill content to a file
+```
+
+Or copy `skills/clickup-cli/SKILL.md` into your agent's skill directory or `AGENTS.md`.
+
+</details>
 
 </details>
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { realpathSync } from "fs";
+import { realpathSync as realpathSync2 } from "fs";
 import { basename, resolve } from "path";
 import { Command } from "commander";
 import { createRequire } from "module";
@@ -3363,6 +3363,18 @@ var commandMetadata = [
       { section: "read", usage: "folders <spaceId>", description: "List folders in a space" }
     ]
   },
+  {
+    name: "skill",
+    description: "Install the agent skill file for your coding agents",
+    flags: ["--print", "--path"],
+    quickReference: [
+      {
+        section: "setup",
+        usage: "skill",
+        description: "Install skill for your agents"
+      }
+    ]
+  },
   {
     name: "space-create",
     description: "Create a new space in your workspace",
@@ -4654,6 +4666,85 @@ function generateCompletion(shell, name = "cup") {
   }
 }
 
+// src/commands/skill.ts
+import { readFileSync, realpathSync, mkdirSync, copyFileSync, existsSync } from "fs";
+import { join as join2, dirname } from "path";
+import { homedir as homedir2 } from "os";
+import chalk7 from "chalk";
+function skillPath() {
+  const entryPoint = realpathSync(process.argv[1] ?? "");
+  const packageRoot = dirname(dirname(entryPoint));
+  const candidate = join2(packageRoot, "skills", "clickup-cli", "SKILL.md");
+  if (existsSync(candidate)) return candidate;
+  const altCandidate = join2(dirname(entryPoint), "..", "skills", "clickup-cli", "SKILL.md");
+  if (existsSync(altCandidate)) return altCandidate;
+  throw new Error("SKILL.md not found. Reinstall with: npm install -g @krodak/clickup-cli");
+}
+function printSkill() {
+  return readFileSync(skillPath(), "utf-8");
+}
+function getAgentTargets() {
+  const home = homedir2();
+  const targets = [
+    { name: "Claude Code", dir: join2(home, ".claude", "skills", "clickup") },
+    { name: "Codex", dir: join2(home, ".agents", "skills", "clickup") },
+    { name: "OpenCode", dir: join2(home, ".config", "opencode", "skills", "clickup") }
+  ];
+  return targets.map((t) => ({
+    ...t,
+    detected: existsSync(dirname(t.dir))
+  }));
+}
+async function installSkillInteractive() {
+  const targets = getAgentTargets();
+  const source = skillPath();
+  const installed = [];
+  if (isTTY()) {
+    const { checkbox: checkbox2 } = await import("@inquirer/prompts");
+    const preselected = targets.filter((t) => t.detected).map((t) => t.name);
+    const selected = await checkbox2({
+      message: "Install skill for which agents?",
+      choices: targets.map((t) => ({
+        name: `${t.name}${t.detected ? chalk7.dim(" (detected)") : ""}`,
+        value: t.name,
+        checked: t.detected
+      }))
+    });
+    if (selected.length === 0) {
+      throw new Error("No agents selected");
+    }
+    for (const name of selected) {
+      const target = targets.find((t) => t.name === name);
+      if (!existsSync(target.dir)) mkdirSync(target.dir, { recursive: true });
+      const dest = join2(target.dir, "SKILL.md");
+      copyFileSync(source, dest);
+      installed.push(`${target.name}: ${dest}`);
+    }
+  } else {
+    for (const target of targets.filter((t) => t.detected)) {
+      if (!existsSync(target.dir)) mkdirSync(target.dir, { recursive: true });
+      const dest = join2(target.dir, "SKILL.md");
+      copyFileSync(source, dest);
+      installed.push(`${target.name}: ${dest}`);
+    }
+    if (installed.length === 0) {
+      const fallback = targets[0];
+      mkdirSync(fallback.dir, { recursive: true });
+      const dest = join2(fallback.dir, "SKILL.md");
+      copyFileSync(source, dest);
+      installed.push(`${fallback.name}: ${dest}`);
+    }
+  }
+  return installed;
+}
+function installSkillTo(path) {
+  const source = skillPath();
+  const dir = dirname(path);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  copyFileSync(source, path);
+  return path;
+}
+
 // src/commands/auth.ts
 async function checkAuth(config) {
   const client = new ClickUpClient(config);
@@ -4932,7 +5023,7 @@ async function manageTags(config, taskId, opts) {
 }
 
 // src/commands/checklist.ts
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 async function viewChecklists(config, taskId) {
   const client = new ClickUpClient(config);
   const task = await client.getTask(taskId);
@@ -4965,14 +5056,14 @@ function formatChecklists(checklists) {
   const lines = [];
   for (const cl of checklists) {
     const resolved = cl.items.filter((i) => i.resolved).length;
-    lines.push(chalk7.bold(`${cl.name} (${resolved}/${cl.items.length})`));
-    lines.push(chalk7.dim(`  ID: ${cl.id}`));
+    lines.push(chalk8.bold(`${cl.name} (${resolved}/${cl.items.length})`));
+    lines.push(chalk8.dim(`  ID: ${cl.id}`));
     for (const item of cl.items) {
-      const check = item.resolved ? chalk7.green("[x]") : chalk7.dim("[ ]");
-      const name = item.resolved ? chalk7.dim(item.name) : item.name;
-      const assignee = item.assignee ? chalk7.dim(` @${item.assignee.username}`) : "";
+      const check = item.resolved ? chalk8.green("[x]") : chalk8.dim("[ ]");
+      const name = item.resolved ? chalk8.dim(item.name) : item.name;
+      const assignee = item.assignee ? chalk8.dim(` @${item.assignee.username}`) : "";
       lines.push(`  ${check} ${name}${assignee}`);
-      lines.push(chalk7.dim(`      item-id: ${item.id}`));
+      lines.push(chalk8.dim(`      item-id: ${item.id}`));
     }
   }
   return lines.join("\n");
@@ -5006,7 +5097,7 @@ async function deleteComment(config, commentId) {
 }
 
 // src/commands/replies.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 async function getReplies(config, commentId) {
   const client = new ClickUpClient(config);
   return client.getThreadedComments(commentId);
@@ -5021,7 +5112,7 @@ function formatReplies(replies) {
   return replies.map((r) => {
     const user = r.user?.username ?? "Unknown";
     const date = formatTimestamp(Number(r.date));
-    return `${chalk8.bold(user)} ${chalk8.dim(date)}
+    return `${chalk9.bold(user)} ${chalk9.dim(date)}
   ${r.comment_text}`;
   }).join("\n\n");
 }
@@ -5084,7 +5175,7 @@ function formatDocsMarkdown(docs) {
 }
 
 // src/commands/doc.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 async function getDocInfo(config, docId) {
   const client = new ClickUpClient(config);
   const [doc, pages] = await Promise.all([
@@ -5096,14 +5187,14 @@ async function getDocInfo(config, docId) {
 function formatDocInfo(doc, pages, indent = 0) {
   const lines = [];
   if (indent === 0) {
-    lines.push(`${chalk9.bold(doc.name)} ${chalk9.dim(doc.id)}`);
+    lines.push(`${chalk10.bold(doc.name)} ${chalk10.dim(doc.id)}`);
     if (pages.length === 0) {
       lines.push("  (no pages)");
     }
   }
   for (const page of pages) {
     const prefix = "  ".repeat(indent + 1);
-    lines.push(`${prefix}${page.name} ${chalk9.dim(page.id)}`);
+    lines.push(`${prefix}${page.name} ${chalk10.dim(page.id)}`);
     if (page.pages && page.pages.length > 0) {
       lines.push(formatDocInfo(doc, page.pages, indent + 1));
     }
@@ -5182,7 +5273,7 @@ async function deleteDocPage(config, docId, pageId) {
 }
 
 // src/commands/folders.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 async function listFolders(config, spaceId, nameFilter) {
   const client = new ClickUpClient(config);
   const folders = await client.getFolders(spaceId);
@@ -5201,9 +5292,9 @@ async function listFolders(config, spaceId, nameFilter) {
 function formatFolders(folders) {
   if (folders.length === 0) return "No folders found";
   return folders.map((f) => {
-    const header = `${chalk10.bold(f.name)} ${chalk10.dim(f.id)}`;
+    const header = `${chalk11.bold(f.name)} ${chalk11.dim(f.id)}`;
     if (f.lists.length === 0) return header;
-    const listLines = f.lists.map((l) => `  ${chalk10.dim(">")} ${l.name} ${chalk10.dim(l.id)}`);
+    const listLines = f.lists.map((l) => `  ${chalk11.dim(">")} ${l.name} ${chalk11.dim(l.id)}`);
     return [header, ...listLines].join("\n");
   }).join("\n\n");
 }
@@ -5218,13 +5309,13 @@ function formatFoldersMarkdown(folders) {
 }
 
 // src/commands/time.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 var TIME_COLUMNS = [
   { key: "task", label: "Task", maxWidth: 35 },
   { key: "duration", label: "Duration", maxWidth: 10 },
   { key: "date", label: "Date", maxWidth: 20 },
   { key: "description", label: "Description", maxWidth: 30 },
-  { key: "status", label: "", maxWidth: 10, format: (v) => v === "RUNNING" ? chalk11.green(v) : "" }
+  { key: "status", label: "", maxWidth: 10, format: (v) => v === "RUNNING" ? chalk12.green(v) : "" }
 ];
 async function startTimer(config, taskId, description) {
   const client = new ClickUpClient(config);
@@ -5320,7 +5411,7 @@ function formatTimeEntriesMarkdown(entries) {
 }
 
 // src/commands/tags.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var TAG_COLUMNS = [
   { key: "name", label: "Name", maxWidth: 40 },
   { key: "fg", label: "FG", maxWidth: 10 },
@@ -5353,13 +5444,13 @@ function formatTags(tags) {
   if (tags.length === 0) return "No tags found";
   if (isTTY()) {
     const rows = tags.map((t) => ({
-      name: t.tag_bg ? chalk12.bgHex(t.tag_bg).hex(t.tag_fg || "#ffffff")(` ${t.name} `) : chalk12.bold(t.name),
+      name: t.tag_bg ? chalk13.bgHex(t.tag_bg).hex(t.tag_fg || "#ffffff")(` ${t.name} `) : chalk13.bold(t.name),
       fg: t.tag_fg || "",
       bg: t.tag_bg || ""
     }));
     return formatTable(rows, TAG_COLUMNS);
   }
-  return tags.map((t) => chalk12.bold(t.name)).join(", ");
+  return tags.map((t) => chalk13.bold(t.name)).join(", ");
 }
 function formatTagsMarkdown(tags) {
   if (tags.length === 0) return "No tags found";
@@ -5394,7 +5485,7 @@ function formatMembersMarkdown(members) {
 }
 
 // src/commands/fields.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 var FIELD_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 20 },
   { key: "name", label: "Name", maxWidth: 30 },
@@ -5403,7 +5494,7 @@ var FIELD_COLUMNS = [
     key: "required",
     label: "Required",
     maxWidth: 10,
-    format: (v) => v === "yes" ? chalk13.yellow(v) : chalk13.dim(v)
+    format: (v) => v === "yes" ? chalk14.yellow(v) : chalk14.dim(v)
   },
   { key: "options", label: "Options", maxWidth: 40 }
 ];
@@ -5510,13 +5601,13 @@ async function bulkTag(config, tagName, taskIds, action) {
 }
 
 // src/commands/goals.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 function colorProgress(value) {
   const num = parseInt(value, 10);
   if (isNaN(num)) return value;
-  if (num >= 75) return chalk14.green(value);
-  if (num >= 25) return chalk14.yellow(value);
-  return chalk14.red(value);
+  if (num >= 75) return chalk15.green(value);
+  if (num >= 25) return chalk15.yellow(value);
+  return chalk15.red(value);
 }
 var GOAL_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 15 },
@@ -5610,14 +5701,14 @@ function formatKeyResultsMarkdown(keyResults) {
 }
 
 // src/commands/task-types.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 async function listTaskTypes(config) {
   const client = new ClickUpClient(config);
   return client.getCustomTaskTypes(config.teamId);
 }
 function formatTaskTypes(types) {
   if (types.length === 0) return "No custom task types";
-  return types.map((t) => `${chalk15.bold(t.name)} ${chalk15.dim(`(${t.id})`)}`).join("\n");
+  return types.map((t) => `${chalk16.bold(t.name)} ${chalk16.dim(`(${t.id})`)}`).join("\n");
 }
 function formatTaskTypesMarkdown(types) {
   if (types.length === 0) return "No custom task types";
@@ -5625,14 +5716,14 @@ function formatTaskTypesMarkdown(types) {
 }
 
 // src/commands/templates.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 async function listTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getTaskTemplates(config.teamId);
 }
 function formatTemplates(templates) {
   if (templates.length === 0) return "No task templates";
-  return templates.map((t) => `${chalk16.bold(t.name)} ${chalk16.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk17.bold(t.name)} ${chalk17.dim(`(${t.id})`)}`).join("\n");
 }
 function formatTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No task templates";
@@ -5640,14 +5731,14 @@ function formatTemplatesMarkdown(templates) {
 }
 
 // src/commands/list-templates.ts
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 async function listListTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getListTemplates(config.teamId);
 }
 function formatListTemplates(templates) {
   if (templates.length === 0) return "No list templates";
-  return templates.map((t) => `${chalk17.bold(t.name)} ${chalk17.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk18.bold(t.name)} ${chalk18.dim(`(${t.id})`)}`).join("\n");
 }
 function formatListTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No list templates";
@@ -5655,14 +5746,14 @@ function formatListTemplatesMarkdown(templates) {
 }
 
 // src/commands/folder-templates.ts
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 async function listFolderTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getFolderTemplates(config.teamId);
 }
 function formatFolderTemplates(templates) {
   if (templates.length === 0) return "No folder templates";
-  return templates.map((t) => `${chalk18.bold(t.name)} ${chalk18.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk19.bold(t.name)} ${chalk19.dim(`(${t.id})`)}`).join("\n");
 }
 function formatFolderTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No folder templates";
@@ -5685,7 +5776,7 @@ async function createListFromTemplate(config, name, opts) {
 }
 
 // src/commands/views.ts
-import chalk19 from "chalk";
+import chalk20 from "chalk";
 async function listViews(config, id, container = "list") {
   const client = new ClickUpClient(config);
   if (container === "space") return client.getSpaceViews(id);
@@ -5696,7 +5787,7 @@ async function listViews(config, id, container = "list") {
 }
 function formatViews(views) {
   if (views.length === 0) return "No views";
-  return views.map((v) => `${chalk19.bold(v.name)} ${chalk19.dim(`(${v.id})`)} ${chalk19.dim(v.type)}`).join("\n");
+  return views.map((v) => `${chalk20.bold(v.name)} ${chalk20.dim(`(${v.id})`)} ${chalk20.dim(v.type)}`).join("\n");
 }
 function formatViewsMarkdown(views) {
   if (views.length === 0) return "No views";
@@ -5704,20 +5795,20 @@ function formatViewsMarkdown(views) {
 }
 
 // src/commands/view.ts
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 async function getView(config, viewId) {
   const client = new ClickUpClient(config);
   return client.getView(viewId);
 }
 function formatView(view) {
   const lines = [];
-  lines.push(chalk20.bold.underline(view.name));
+  lines.push(chalk21.bold.underline(view.name));
   lines.push("");
-  lines.push(`  ${chalk20.bold("ID")}     ${view.id}`);
-  lines.push(`  ${chalk20.bold("Type")}   ${view.type}`);
-  if (view.visibility) lines.push(`  ${chalk20.bold("Visibility")} ${view.visibility}`);
-  if (view.date_created) lines.push(`  ${chalk20.bold("Created")} ${formatDate(view.date_created)}`);
-  if (view.protected !== void 0) lines.push(`  ${chalk20.bold("Protected")} ${view.protected}`);
+  lines.push(`  ${chalk21.bold("ID")}     ${view.id}`);
+  lines.push(`  ${chalk21.bold("Type")}   ${view.type}`);
+  if (view.visibility) lines.push(`  ${chalk21.bold("Visibility")} ${view.visibility}`);
+  if (view.date_created) lines.push(`  ${chalk21.bold("Created")} ${formatDate(view.date_created)}`);
+  if (view.protected !== void 0) lines.push(`  ${chalk21.bold("Protected")} ${view.protected}`);
   return lines.join("\n");
 }
 function formatViewMarkdown(view) {
@@ -7471,6 +7562,24 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       process.stdout.write(script);
     })
   );
+  program.command("skill").description("Install the agent skill file for your coding agents").option("--print", "Print the skill file content instead of installing").option("--path <path>", "Install to a specific path").action(
+    wrapAction(async (opts) => {
+      if (opts.print) {
+        process.stdout.write(printSkill());
+        return;
+      }
+      if (opts.path) {
+        const dest = installSkillTo(opts.path);
+        console.log(`Installed to ${dest}`);
+        return;
+      }
+      const installed = await installSkillInteractive();
+      console.log("");
+      for (const entry of installed) {
+        console.log(`  Installed: ${entry}`);
+      }
+    })
+  );
   return program;
 }
 async function run(argv = process.argv) {
@@ -7484,7 +7593,7 @@ process.on("SIGINT", () => {
 });
 function checkDirectExecution() {
   try {
-    return process.argv[1] !== void 0 && fileURLToPath(import.meta.url) === realpathSync(resolve(process.argv[1]));
+    return process.argv[1] !== void 0 && fileURLToPath(import.meta.url) === realpathSync2(resolve(process.argv[1]));
   } catch {
     return false;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.17.0",
+  "version": "1.18.1",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",

package/skills/clickup-cli/SKILL.md

@@ -3,10 +3,12 @@ name: clickup
 description: 'Use when managing ClickUp tasks, sprints, or comments via the `cup` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, threaded replies, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags, managing checklists, editing comments, task links, time tracking, attachments, file uploads, listing members, listing fields, duplicating tasks, bulk operations, goals, key results, saved filters.'
 ---
 
-# ClickUp CLI (`cup`)
+# ClickUp CLI (`cup`) - skill version 1.17.0
 
 Reference for AI agents using the `cup` CLI tool. Covers task management, sprint tracking, comments, and project workflows.
 
+> **Version check:** Run `cup --version`. If your installed version is older than 1.18.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
+
 ## Setup
 
 Config at `~/.config/cup/config.json` with named profiles. Each profile has `apiToken` and `teamId`. Optional: `sprintFolderId` to pin sprint detection to a specific folder. Run `cup init` to set up interactively.