opencode-skills-collection 4.0.77 → 4.1.0

package/README.md

@@ -61,7 +61,7 @@ bundled-skills/ (npm package)
 
 **2. On-demand skill loading**
 
-Each pointer file tells the AI: *"there are N skills for this category in the vault — use `list_dir` / `view_file` to
+Each pointer file tells the AI: *"there are N skills for this category in the vault — use `read` to
 retrieve them when needed."*
 The full skill content is only injected into context when the AI actually needs it.
 
@@ -104,8 +104,20 @@ After the first startup, your `~/.config/opencode/` directory looks like this:
 
 Add the plugin to your global OpenCode configuration file at `~/.config/opencode/opencode.json`:
 
-```json
+```jsonc
+{
+  // OpenCode V2
+  "plugins": [
+    "opencode-skills-collection@latest"
+  ]
+}
+```
+
+For OpenCode V1 (>= 1.18.29), use the `plugin` key instead (older V1 releases expect a function entrypoint and cannot load this version):
+
+```jsonc
 {
+  // OpenCode V1
   "plugin": [
     "opencode-skills-collection@latest"
   ]
@@ -249,8 +261,20 @@ Beta versions are published from the `develop` branch for testing before officia
 
 To use the latest beta version, update your `~/.config/opencode/opencode.json`:
 
-```json
+```jsonc
+{
+  // OpenCode V2
+  "plugins": [
+    "opencode-skills-collection@beta"
+  ]
+}
+```
+
+For OpenCode V1 (>= 1.18.29):
+
+```jsonc
 {
+  // OpenCode V1
   "plugin": [
     "opencode-skills-collection@beta"
   ]

package/dist/index.d.ts

@@ -1,13 +1,8 @@
-import type { Plugin } from "@opencode-ai/plugin";
-/**
- * OpenCode Skills Collection plugin.
- *
- * On every OpenCode startup:
- * 1. Copies bundled skills directly into the vault
- *    (~/.config/opencode/skill-libraries/) organised by category.
- *    The active skills directory is never used as staging.
- * 2. Generates lightweight category pointer SKILL.md files in
- *    ~/.config/opencode/skills/ without touching user custom skills.
- */
-declare const OpenCodeSkillsCollection: Plugin;
-export default OpenCodeSkillsCollection;
+import type { PluginInput } from "@opencode-ai/plugin";
+import { Plugin } from "@opencode/plugin";
+declare const _default: {
+    id: string;
+    setup: (context: Plugin.Context) => Promise<Plugin.Cleanup | void> | Plugin.Cleanup | void;
+    server(ctx: PluginInput): Promise<import("@opencode-ai/plugin").Hooks>;
+};
+export default _default;

package/dist/index.js

@@ -1,3 +1,4 @@
+import { Plugin } from "@opencode/plugin";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -11,8 +12,14 @@ function resolveBundledSkillsPath() {
 function resolveActiveSkillsDir() {
     return path.join(os.homedir(), ...ACTIVE_SKILLS_PATH_SEGMENTS);
 }
+function runStartupPipeline() {
+    const bundledSkillsPath = resolveBundledSkillsPath();
+    const activeSkillsDir = resolveActiveSkillsDir();
+    ensureDir(activeSkillsDir);
+    runSkillPointer({ bundledSkillsPath, activeSkillsDir });
+}
 /**
- * OpenCode Skills Collection plugin.
+ * OpenCode Skills Collection plugin (V1 + V2 from a single entrypoint).
  *
  * On every OpenCode startup:
  * 1. Copies bundled skills directly into the vault
@@ -21,16 +28,28 @@ function resolveActiveSkillsDir() {
  * 2. Generates lightweight category pointer SKILL.md files in
  *    ~/.config/opencode/skills/ without touching user custom skills.
  */
-const OpenCodeSkillsCollection = async (_ctx) => {
+const OpenCodeSkillsCollectionV1 = async (_ctx) => {
     try {
-        const bundledSkillsPath = resolveBundledSkillsPath();
-        const activeSkillsDir = resolveActiveSkillsDir();
-        ensureDir(activeSkillsDir);
-        runSkillPointer({ bundledSkillsPath, activeSkillsDir });
+        runStartupPipeline();
     }
     catch (error) {
         process.stderr.write(`[opencode-skills-collection] ${error}\n`);
     }
     return {};
 };
-export default OpenCodeSkillsCollection;
+export default {
+    ...Plugin.define({
+        id: "opencode-skills-collection",
+        async setup(_ctx) {
+            try {
+                runStartupPipeline();
+            }
+            catch (error) {
+                process.stderr.write(`[opencode-skills-collection] ${error}\n`);
+            }
+        },
+    }),
+    async server(ctx) {
+        return OpenCodeSkillsCollectionV1(ctx);
+    },
+};

package/dist/skill-pointer/pointer-generator.d.ts

@@ -4,7 +4,6 @@ import type { SkillIndexEntry } from "./vault-installer.js";
  * a lightweight pointer SKILL.md into the active skills directory.
  *
  * Each pointer includes the full list of skill names + descriptions
- * so keyword searches (e.g. "laravel", "wordpress") resolve correctly
- * via get_available_skills without loading every SKILL.md.
+ * so the agent can match tasks to skills without loading every SKILL.md.
  */
 export declare function generatePointers(activeSkillsDir: string, vaultDir: string, index?: SkillIndexEntry[]): void;

package/dist/skill-pointer/pointer-generator.js

@@ -28,7 +28,7 @@ ${skillList}
 ## How to load a skill
 
 1. Identify the skill name above matching your task.
-2. Use \`view_file\` to read its \`SKILL.md\` from the vault:
+2. Use \`read\` to load its \`SKILL.md\` from the vault:
    \`${normalizedPath}/<skill-name>/SKILL.md\`
 3. Follow those instructions to complete the request.
 
@@ -44,8 +44,7 @@ ${skillList}
  * a lightweight pointer SKILL.md into the active skills directory.
  *
  * Each pointer includes the full list of skill names + descriptions
- * so keyword searches (e.g. "laravel", "wordpress") resolve correctly
- * via get_available_skills without loading every SKILL.md.
+ * so the agent can match tasks to skills without loading every SKILL.md.
  */
 export function generatePointers(activeSkillsDir, vaultDir, index = []) {
     const byCategory = new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-skills-collection",
-  "version": "4.0.77",
+  "version": "4.1.0",
   "description": "OpenCode CLI plugin that automatically downloads and keeps skills up to date.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,17 +33,17 @@
   ],
   "author": "Davide Ladisa <info@davideladisa.it>",
   "license": "MIT",
-  "packageManager": "bun@1.3.14",
+  "packageManager": "bun@1.4.2",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
     "@opencode-ai/plugin": "^1.15.5",
+    "@opencode/plugin": "^2.0.18",
     "strip-json-comments": "^5.0.3"
   },
   "devDependencies": {
-    "@opencode-ai/sdk": "^1.15.5",
     "@types/bun": "*",
     "@types/node": "^26.0.0",
     "@types/strip-json-comments": "^3.0.0",