@its-thepoe/skills 1.0.8 → 1.0.10

package/README.md

@@ -1,6 +1,21 @@
 # @its-thepoe/skills
 
-CLI to **install**, **sync**, **check**, and **remove** [@its-thepoe](https://www.npmjs.com/search?q=scope%3Aits-thepoe) Agent Skills into local directories used by **Cursor**, **Claude Code**, **OpenCode**, and **Windsurf**.
+**Orchestrator CLI** — installs, updates, checks, and removes [@its-thepoe](https://www.npmjs.com/search?q=scope%3Aits-thepoe) **Agent Skills** (`SKILL.md` trees) into the folders that **Codex**, **Cursor**, **Claude Code**, **OpenCode**, and **Windsurf** read from.
+
+## What it does
+
+One command line wraps symlink-or-copy installs, manifest-driven skill names, dry runs, and per-agent targeting. Skills stay versioned npm packages; the CLI is the **supported** way to put them on disk next to your agents without hand-maintaining paths.
+
+## Why it’s useful
+
+- **Repeatable** installs across machines and teammates (`npx … install --all`).
+- **Safe previews** with `--dry-run` and explicit `remove` / `remove --all`.
+- Works around **Windows symlink** limits via `--strategy copy`.
+
+## Use when
+
+- You want the **full @its-thepoe skill set** or a **subset** in your local agent directories.
+- You’re onboarding a new machine or verifying installs (`check`, `sync --all`).
 
 ## Install & use
 
@@ -16,11 +31,11 @@ One skill:
 npx @its-thepoe/skills@latest install alt-text
 ```
 
-Options: `--dry-run`, `--only=cursor,claude`, `--strategy copy` (if symlinks fail), `remove <name>` / `remove --all`.
+Options: `--dry-run`, `--only=codex,cursor,claude`, `--strategy copy` (if symlinks fail), `remove <name>` / `remove --all`.
 
 ## Docs
 
-- [Full documentation on GitHub](https://github.com/its-thepoe/skills)
+- [Full documentation on GitHub](https://github.com/its-thepoe/skills) — root README, publish steps, troubleshooting.
 
 ## License
 

package/lib/cli-main.mjs

@@ -78,7 +78,7 @@ Commands:
 
 Options:
   --dry-run                     Print actions without writing
-  --only=<a>[,<b>...]          Limit targets: cursor, claude, opencode, windsurf, all
+  --only=<a>[,<b>...]          Limit targets: codex, cursor, claude, opencode, windsurf, all
   --strategy symlink|copy       Default symlink; use copy if symlinks fail (e.g. Windows)
   --online                      With check: compare to npm registry (requires network)
 
@@ -110,11 +110,12 @@ function npmViewVersion(pkg) {
 }
 
 /**
- * @param {{ online: boolean }} opts
+ * @param {{ online: boolean, only: string[] }} opts
  */
 function runCheck(opts) {
   const manifest = loadManifest();
-  const { online } = opts;
+  const { online, only } = opts;
+  const agents = only.includes("all") ? Object.keys(AGENT_TARGETS) : only;
   let exit = 0;
   for (const row of manifest.skills) {
     let root = null;
@@ -132,7 +133,7 @@ function runCheck(opts) {
     }
     logLine(`\n${row.name} (${row.package}) bundled@${bundledVer}${latest ? ` registry_latest@${latest}` : ""}`);
 
-    for (const agent of Object.keys(AGENT_TARGETS)) {
+    for (const agent of agents) {
       const dest = path.join(agentBaseDir(agent), row.name);
       if (!fs.existsSync(dest)) {
         logLine(`  [${agent}] MISSING ${dest}`);
@@ -183,7 +184,7 @@ export function run(argv) {
 
   try {
     if (cmd === "check") {
-      return runCheck({ online: flags.online });
+      return runCheck({ online: flags.online, only });
     }
 
     if (cmd === "install" || cmd === "sync") {
@@ -215,7 +216,7 @@ export function run(argv) {
           log,
         });
       }
-      logLine(`\nDone. Reload your agents (Cursor, Claude Code, OpenCode, Windsurf).`);
+      logLine(`\nDone. Reload your agents (Codex, Cursor, Claude Code, OpenCode, Windsurf).`);
       return 0;
     }
 

package/lib/link-engine.mjs

@@ -7,6 +7,7 @@ const INSTALL_MARKER = ".its-thepoe-skills-install.json";
 
 /** @type {Record<string, { env?: string, segments: string[] }>} */
 export const AGENT_TARGETS = {
+  codex: { segments: [".agents", "skills"] },
   cursor: { segments: [".cursor", "skills"] },
   claude: { segments: [".claude", "skills"] },
   opencode: { segments: [".config", "opencode", "skills"] },
@@ -28,7 +29,7 @@ export function agentBaseDir(key) {
  * @param {string[]} onlyKeys
  */
 export function normalizeOnly(onlyKeys) {
-  const allowed = new Set(["cursor", "claude", "opencode", "windsurf"]);
+  const allowed = new Set(Object.keys(AGENT_TARGETS));
   if (onlyKeys.length === 0 || onlyKeys.includes("all")) {
     return [...allowed];
   }
@@ -96,6 +97,9 @@ function linkOneDest(opts) {
         if (exists(marker)) {
           log(`${dryRun ? "DRY-RUN " : ""}REPLACE ${dest} (prior copy install)`);
           if (!dryRun) fs.rmSync(dest, { recursive: true, force: true });
+        } else if (exists(path.join(dest, "SKILL.md"))) {
+          log(`SKIP   ${dest} (existing unmanaged skill directory)`);
+          return;
         } else {
           throw new Error(
             `Refusing to replace ${dest}: exists and is not a symlink managed by this tool`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@its-thepoe/skills",
-  "version": "1.0.8",
-  "description": "Orchestrator CLI to install, check, sync, and remove @its-thepoe Agent Skills (Cursor, Claude Code, OpenCode, Windsurf).",
+  "version": "1.0.10",
+  "description": "Orchestrator CLI to install, check, sync, and remove @its-thepoe Agent Skills (Codex, Cursor, Claude Code, OpenCode, Windsurf).",
   "license": "MIT",
   "type": "module",
   "keywords": [
@@ -29,7 +29,8 @@
     "@its-thepoe/family-taste": "1.0.1",
     "@its-thepoe/canva-app-builder": "1.0.0",
     "@its-thepoe/codebase-content-ideas": "1.0.3",
+    "@its-thepoe/market-command-matrix": "1.0.0",
     "@its-thepoe/root-cause-analysis": "1.0.1",
-    "@its-thepoe/write-a-skill": "1.0.2"
+    "@its-thepoe/write-a-skill": "1.0.3"
   }
 }

package/skills.manifest.json

@@ -7,6 +7,7 @@
     { "name": "family-taste", "package": "@its-thepoe/family-taste" },
     { "name": "canva-app-builder", "package": "@its-thepoe/canva-app-builder" },
     { "name": "codebase-content-ideas", "package": "@its-thepoe/codebase-content-ideas" },
+    { "name": "market-command-matrix", "package": "@its-thepoe/market-command-matrix" },
     { "name": "root-cause-analysis", "package": "@its-thepoe/root-cause-analysis" },
     { "name": "write-a-skill", "package": "@its-thepoe/write-a-skill" }
   ]