@cocoar/vue-ui 3.2.0-beta.6 → 3.2.0-beta.7

package/bin/cli.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// `npx @cocoar/vue-ui skill` — install the Agent Skill that ships in this package.
+//
+// The skill sits in skills/cocoar-vue-ui/ at the package root. The skills CLI (npx skills,
+// https://github.com/vercel-labs/skills) installs skills from git repos and local folders but
+// has no npm source, so the plain command would be `npx skills add ./node_modules/@cocoar/vue-ui`.
+// This bin resolves that path for the caller and hands everything else — agent detection,
+// install directories, lockfile, `npx skills update` — to the skills CLI. Extra arguments pass
+// through (`-g`, `-a claude-code`, `--copy`, `-y`, …).
+
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const skillDir = path.join(packageDir, 'skills', 'cocoar-vue-ui');
+const [command, ...rest] = process.argv.slice(2);
+
+if (command !== 'skill' || rest.includes('--help') || rest.includes('-h')) {
+  console.log(`Usage: npx @cocoar/vue-ui skill [skills-cli options]
+
+Installs the Cocoar UI Vue Agent Skill for Claude Code, Cursor, Codex, Copilot and other
+agents via the skills CLI (npx skills add). Options are passed through, for example:
+
+  npx @cocoar/vue-ui skill                 interactive: pick agents
+  npx @cocoar/vue-ui skill -y              accept defaults
+  npx @cocoar/vue-ui skill -g              install user-wide instead of into the project
+  npx @cocoar/vue-ui skill -a claude-code  target one agent
+
+Skill source: ${skillDir}`);
+  process.exit(command === 'skill' ? 0 : 1);
+}
+
+if (!existsSync(path.join(skillDir, 'SKILL.md'))) {
+  console.error(`No skill found at ${skillDir} — this build of @cocoar/vue-ui does not ship one.`);
+  process.exit(1);
+}
+
+// npx is a .cmd shim on Windows, which Node only runs through a shell; quote the path for it.
+const windows = process.platform === 'win32';
+const quote = (arg) => (windows && /[\s"]/.test(arg) ? `"${arg.replace(/"/g, '\\"')}"` : arg);
+const result = spawnSync('npx', ['--yes', 'skills', 'add', packageDir, ...rest].map(quote), {
+  stdio: 'inherit',
+  shell: windows,
+});
+
+if (result.error) {
+  console.error(`Could not run the skills CLI (${result.error.message}).`);
+  console.error(`Install it by hand instead: npx skills add ${packageDir}`);
+  process.exit(1);
+}
+process.exit(result.status ?? 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocoar/vue-ui",
-  "version": "3.2.0-beta.6",
+  "version": "3.2.0-beta.7",
   "description": "Cocoar Design System — a touch-first Vue 3 component library with 30+ accessible, themeable components",
   "license": "Apache-2.0",
   "repository": {
@@ -38,7 +38,11 @@
       "types": "./dist/fonts.d.ts"
     }
   },
+  "bin": {
+    "cocoar-vue-ui": "./bin/cli.mjs"
+  },
   "files": [
+    "bin",
     "dist",
     "styles",
     "skills"
@@ -51,7 +55,7 @@
     "typecheck": "vue-tsc --noEmit"
   },
   "dependencies": {
-    "@cocoar/vue-localization": "3.2.0-beta.6",
+    "@cocoar/vue-localization": "3.2.0-beta.7",
     "@fontsource/cascadia-code": "^5.2.3",
     "@fontsource/inter": "^5.2.8",
     "@fontsource/poppins": "^5.2.7",

package/skills/cocoar-vue-ui/references/guide/getting-started.md

@@ -91,26 +91,23 @@ in your project knows the library's API and the mistakes it would otherwise make
 `skills/` folder at the package root and takes no part in your build: nothing is loaded unless you
 install it.
 
-With the [skills CLI](https://github.com/vercel-labs/skills) (no extra tooling; Claude Code,
-Cursor, Codex, Copilot and others):
+Once `@cocoar/vue-ui` is installed, one command installs the skill of exactly that version:
 
 ```bash
-# From the installed package — matches the version you use
-npx skills add ./node_modules/@cocoar/vue-ui
-
-# Or straight from GitHub — the latest docs
-npx skills add cocoar-dev/cocoar-ui-vue
+npx @cocoar/vue-ui skill
 ```
 
-With [agentskills-cli](https://mysticmind.github.io/agentskills-cli/) (a .NET tool that also
-reads npm packages):
+It hands the package's skill folder to the [skills CLI](https://github.com/vercel-labs/skills),
+which detects the agents in your project (Claude Code, Cursor, Codex, Copilot and others) and
+asks where to install. Its options pass through: `-y` accepts the defaults, `-g` installs
+user-wide instead of into the project, `-a claude-code` targets one agent.
 
-```bash
-agentskills-cli add @cocoar/vue-ui
-```
+Two alternatives: `npx skills add cocoar-dev/cocoar-ui-vue` takes the latest docs straight from
+GitHub, and [agentskills-cli](https://mysticmind.github.io/agentskills-cli/) (a .NET tool that
+also reads npm packages) installs it with `agentskills-cli add @cocoar/vue-ui`.
 
 Either places the skill in `.claude/skills/` for Claude Code and `.agents/skills/` for the
-agents that read the standard; `-g` installs it globally instead. Without a tool, copy
+agents that read the standard. Without a tool, copy
 `node_modules/@cocoar/vue-ui/skills/cocoar-vue-ui/` into the same folder by hand.
 
 The skill is generated from these docs, so it says what the docs say for the version you