shortcuts-playground 1.2.3 → 1.2.4

package/README.md

@@ -14,24 +14,37 @@ OpenCode now supports plugin-bundled hooks via `tool.execute.after`. This packag
 
 ## Installation
 
-For published npm distribution (native for generic `tool` plugins — `opencode plugin` is `tui`/`server` only):
+For published npm distribution:
 
 ```json
-// opencode.json (project or ~/.config/opencode/opencode.jsonc)
+// opencode.json (project or ~/.config/opencode/opencode.jsonc) — validator
 {
   "$schema": "https://opencode.ai/config.json",
   "plugin": ["shortcuts-playground"]
 }
 ```
+Bun installs the validator on next startup. Pin with `shortcuts-playground@1.2.4`.
 
-Bun installs the validator on next startup to `~/.cache/opencode`. Skills/commands/agents are installed automatically on `npm i` via `postinstall`, or manually:
+Skills use the standard open-skills CLI (no `postinstall` — like `claude`/`codex` via marketplace, OpenCode skills are file-discovered at `.opencode/skills` / `~/.config/opencode/skills` / `.agents/skills` per `https://opencode.ai/docs/skills#place-files`):
 
 ```bash
-npx shortcuts-playground        # project .opencode/
-npx shortcuts-playground --global  # ~/.config/opencode/
+# from GitHub (recommended)
+npx skills add viticci/shortcuts-playground-plugin -a opencode --skill shortcuts-playground
+# or local checkout
+npx skills add ./opencode -a opencode --skill shortcuts-playground
+# global
+npx skills add viticci/shortcuts-playground-plugin -a opencode -g --skill shortcuts-playground
 ```
 
-Pin with `shortcuts-playground@1.2.3`.
+This symlinks to `.agents/skills/shortcuts-playground/` (discovered by OpenCode) — verified `npx skills add -a opencode --list` finds 1 skill.
+
+Commands (`/build-shortcut` + `/remix-shortcut`) and subagents have no `npx skills` installer — copy if you want slash commands (otherwise natural language triggers the skill):
+
+```bash
+mkdir -p .opencode/commands .opencode/agents
+cp opencode/commands/*.md .opencode/commands/
+cp opencode/agents/*.md .opencode/agents/
+```
 
 For local development from a checkout:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shortcuts-playground",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Build, validate, sign, and archive macOS/iOS Shortcuts from OpenCode — thin skill wrapper over ToolKit v78 catalog, /build-shortcut and /remix-shortcut commands, and tool.execute.after validator",
   "type": "module",
   "license": "MIT",
@@ -24,11 +24,7 @@
     "plugin"
   ],
   "main": "plugin/validator.ts",
-  "bin": {
-    "shortcuts-playground": "./bin/install.js"
-  },
   "files": [
-    "bin/",
     "plugin/",
     "skills/",
     "commands/",
@@ -44,9 +40,6 @@
   "peerDependencies": {
     "@opencode-ai/plugin": "^1.17.0"
   },
-  "scripts": {
-    "postinstall": "node ./bin/install.js || true"
-  },
   "engines": {
     "node": ">=18"
   },

package/bin/install.js

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-// shortcuts-playground installer for OpenCode
-// Copies skills/commands/agents from the npm package into .opencode/
-// Usage: npx shortcuts-playground  or  npx shortcuts-playground --global
-
-import { cpSync, existsSync, mkdirSync, readdirSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
-const isGlobal = process.argv.includes("--global") || process.argv.includes("-g");
-
-function findProjectRoot(start) {
-  let dir = start;
-  for (let i = 0; i < 10; i++) {
-    if (existsSync(join(dir, ".git"))) return dir;
-    if (existsSync(join(dir, "opencode.json")) || existsSync(join(dir, ".opencode"))) return dir;
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return start;
-}
-
-const destRoot = isGlobal
-  ? join(process.env.HOME || "~", ".config", "opencode")
-  : findProjectRoot(process.cwd());
-
-const destBase = join(destRoot, ".opencode");
-if (isGlobal) {
-  // global directly uses ~/.config/opencode
-  // destRoot already is that
-}
-
-function copyDir(src, dest) {
-  if (!existsSync(src)) return 0;
-  mkdirSync(dest, { recursive: true });
-  let count = 0;
-  for (const entry of readdirSync(src, { withFileTypes: true })) {
-    const s = join(src, entry.name);
-    const d = join(dest, entry.name);
-    if (entry.isDirectory()) {
-      cpSync(s, d, { recursive: true, force: true });
-      count++;
-    } else {
-      cpSync(s, d, { force: true });
-      count++;
-    }
-  }
-  return count;
-}
-
-const skillsSrc = join(pkgRoot, "skills", "shortcuts-playground");
-const skillsDest = isGlobal
-  ? join(destRoot, "skills", "shortcuts-playground")
-  : join(destBase, "skills", "shortcuts-playground");
-
-const commandsSrc = join(pkgRoot, "commands");
-const commandsDest = isGlobal
-  ? join(destRoot, "commands")
-  : join(destBase, "commands");
-
-const agentsSrc = join(pkgRoot, "agents");
-const agentsDest = isGlobal
-  ? join(destRoot, "agents")
-  : join(destBase, "agents");
-
-mkdirSync(skillsDest, { recursive: true });
-mkdirSync(commandsDest, { recursive: true });
-mkdirSync(agentsDest, { recursive: true });
-
-cpSync(skillsSrc, skillsDest, { recursive: true, force: true });
-for (const f of readdirSync(commandsSrc)) {
-  if (f.endsWith(".md")) cpSync(join(commandsSrc, f), join(commandsDest, f), { force: true });
-}
-for (const f of readdirSync(agentsSrc)) {
-  if (f.endsWith(".md")) cpSync(join(agentsSrc, f), join(agentsDest, f), { force: true });
-}
-
-console.log(`✓ Installed skills → ${skillsDest}`);
-console.log(`✓ Installed commands → ${commandsDest} (/build-shortcut, /remix-shortcut)`);
-console.log(`✓ Installed agents → ${agentsDest} (shortcut-builder, shortcut-remixer)`);
-console.log(`\nPlugin already registered via opencode.json "plugin": ["shortcuts-playground"] — restart OpenCode TUI and run /build-shortcut`);
-if (!isGlobal) console.log(`(global: npx shortcuts-playground --global)`);