opencode-plugin-preload-skills 1.0.0

package/README.md

@@ -0,0 +1,188 @@
+# opencode-plugin-preload-skills
+
+> Automatically load skills into agent memory at session start
+
+[![npm version](https://img.shields.io/npm/v/opencode-plugin-preload-skills.svg)](https://www.npmjs.com/package/opencode-plugin-preload-skills)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A plugin for [OpenCode](https://opencode.ai) that preloads specified skills into the agent's context automatically when a session starts. Skills persist across context compaction, ensuring your agent always has access to the knowledge it needs.
+
+---
+
+## Features
+
+- **Automatic Loading** — Skills are injected on the first message of each session
+- **Compaction Persistence** — Skills survive context compaction and remain available
+- **Multiple Skill Sources** — Searches project and global skill directories
+- **Debug Logging** — Optional verbose logging for troubleshooting
+- **Zero Runtime Overhead** — Skills loaded once per session
+
+---
+
+## Installation
+
+```bash
+npm install opencode-plugin-preload-skills
+```
+
+---
+
+## Quick Start
+
+**1. Add the plugin to your `opencode.json`:**
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-plugin-preload-skills"],
+  "opencode-plugin-preload-skills": {
+    "skills": ["my-coding-standards", "project-architecture"]
+  }
+}
+```
+
+**2. Create a skill file:**
+
+```
+.opencode/skills/my-coding-standards/SKILL.md
+```
+
+```markdown
+---
+name: my-coding-standards
+description: Coding standards and conventions for this project
+---
+
+## Code Style
+
+- Use 2 spaces for indentation
+- Prefer `const` over `let`
+- Use TypeScript strict mode
+...
+```
+
+**3. Start OpenCode** — your skills are automatically loaded!
+
+---
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `skills` | `string[]` | `[]` | Skill names to auto-load |
+| `persistAfterCompaction` | `boolean` | `true` | Re-inject skills after context compaction |
+| `debug` | `boolean` | `false` | Enable debug logging |
+
+### Full Example
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-plugin-preload-skills"],
+  "opencode-plugin-preload-skills": {
+    "skills": [
+      "coding-standards",
+      "api-patterns",
+      "testing-guide"
+    ],
+    "persistAfterCompaction": true,
+    "debug": false
+  }
+}
+```
+
+---
+
+## Skill Locations
+
+The plugin searches for skills in the following locations (in order):
+
+| Priority | Path | Scope |
+|----------|------|-------|
+| 1 | `.opencode/skills/<name>/SKILL.md` | Project |
+| 2 | `.claude/skills/<name>/SKILL.md` | Project (Claude-compatible) |
+| 3 | `~/.config/opencode/skills/<name>/SKILL.md` | Global |
+| 4 | `~/.claude/skills/<name>/SKILL.md` | Global (Claude-compatible) |
+
+The first matching skill file is used.
+
+---
+
+## Skill File Format
+
+Skills use markdown with YAML frontmatter:
+
+```markdown
+---
+name: skill-name
+description: Brief description shown in logs
+---
+
+# Skill Content
+
+Your skill instructions here. This entire content
+is injected into the agent's context.
+
+## Sections
+
+Organize with headers, code blocks, lists, etc.
+```
+
+### Required Fields
+
+- `name` — Must match the directory name (lowercase, hyphen-separated)
+- `description` — Brief description for logging
+
+---
+
+## How It Works
+
+```
+Session Start
+     │
+     ▼
+┌─────────────────────┐
+│  Plugin loads       │
+│  configured skills  │
+│  from disk          │
+└─────────────────────┘
+     │
+     ▼
+┌─────────────────────┐
+│  First message      │──▶ Skills injected as synthetic content
+│  in session         │
+└─────────────────────┘
+     │
+     ▼
+┌─────────────────────┐
+│  Context            │──▶ Skills added to compaction context
+│  compaction         │    (if persistAfterCompaction: true)
+└─────────────────────┘
+     │
+     ▼
+┌─────────────────────┐
+│  Session            │──▶ Cleanup session tracking
+│  deleted            │
+└─────────────────────┘
+```
+
+---
+
+## Troubleshooting
+
+### Skills not loading?
+
+1. **Check the skill path** — Ensure `SKILL.md` exists in the correct directory
+2. **Verify frontmatter** — Both `name` and `description` are required
+3. **Enable debug mode** — Set `"debug": true` in config
+4. **Check logs** — Look for `preload-skills` service messages
+
+### Skills lost after compaction?
+
+Ensure `persistAfterCompaction` is `true` (this is the default).
+
+---
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,190 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var fs = require('fs');
+var path = require('path');
+var os = require('os');
+
+// src/skill-loader.ts
+var SKILL_FILENAME = "SKILL.md";
+var SKILL_SEARCH_PATHS = [
+  (dir) => path.join(dir, ".opencode", "skills"),
+  (dir) => path.join(dir, ".claude", "skills"),
+  () => path.join(os.homedir(), ".config", "opencode", "skills"),
+  () => path.join(os.homedir(), ".claude", "skills")
+];
+function findSkillFile(skillName, projectDir) {
+  for (const getPath of SKILL_SEARCH_PATHS) {
+    const skillDir = getPath(projectDir);
+    const skillPath = path.join(skillDir, skillName, SKILL_FILENAME);
+    if (fs.existsSync(skillPath)) {
+      return skillPath;
+    }
+  }
+  return null;
+}
+function parseFrontmatter(content) {
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch?.[1]) {
+    return {};
+  }
+  const frontmatter = frontmatterMatch[1];
+  const result = {};
+  const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+  if (nameMatch?.[1]) {
+    result.name = nameMatch[1].trim();
+  }
+  const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+  if (descMatch?.[1]) {
+    result.description = descMatch[1].trim();
+  }
+  return result;
+}
+function loadSkill(skillName, projectDir) {
+  const filePath = findSkillFile(skillName, projectDir);
+  if (!filePath) {
+    return null;
+  }
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const { name, description } = parseFrontmatter(content);
+    return {
+      name: name ?? skillName,
+      description: description ?? "",
+      content,
+      filePath
+    };
+  } catch {
+    return null;
+  }
+}
+function loadSkills(skillNames, projectDir) {
+  const skills = [];
+  for (const name of skillNames) {
+    const skill = loadSkill(name, projectDir);
+    if (skill) {
+      skills.push(skill);
+    }
+  }
+  return skills;
+}
+function formatSkillsForInjection(skills) {
+  if (skills.length === 0) {
+    return "";
+  }
+  const parts = skills.map(
+    (skill) => `<preloaded-skill name="${skill.name}">
+${skill.content}
+</preloaded-skill>`
+  );
+  return `<preloaded-skills>
+The following skills have been automatically loaded for this session:
+
+${parts.join("\n\n")}
+</preloaded-skills>`;
+}
+
+// src/index.ts
+var DEFAULT_CONFIG = {
+  skills: [],
+  persistAfterCompaction: true,
+  debug: false
+};
+var PreloadSkillsPlugin = async (ctx) => {
+  const injectedSessions = /* @__PURE__ */ new Set();
+  let loadedSkills = [];
+  let formattedContent = "";
+  let config = DEFAULT_CONFIG;
+  const log = (level, message, extra) => {
+    if (level === "debug" && !config.debug) return;
+    ctx.client.app.log({
+      body: {
+        service: "preload-skills",
+        level,
+        message,
+        extra
+      }
+    });
+  };
+  return {
+    config: async (openCodeConfig) => {
+      const pluginConfig = openCodeConfig["opencode-plugin-preload-skills"];
+      config = {
+        ...DEFAULT_CONFIG,
+        ...pluginConfig
+      };
+      if (config.skills.length === 0) {
+        log("warn", "No skills configured for preloading");
+        return;
+      }
+      loadedSkills = loadSkills(config.skills, ctx.directory);
+      formattedContent = formatSkillsForInjection(loadedSkills);
+      const loadedNames = loadedSkills.map((s) => s.name);
+      const missingNames = config.skills.filter((s) => !loadedNames.includes(s));
+      log("info", `Loaded ${loadedSkills.length} skills for preloading`, {
+        loaded: loadedNames,
+        missing: missingNames.length > 0 ? missingNames : void 0
+      });
+      if (missingNames.length > 0) {
+        log("warn", "Some configured skills were not found", {
+          missing: missingNames
+        });
+      }
+    },
+    "chat.message": async (input, output) => {
+      if (loadedSkills.length === 0 || !formattedContent) {
+        return;
+      }
+      if (injectedSessions.has(input.sessionID)) {
+        log("debug", "Skills already injected for session", {
+          sessionID: input.sessionID
+        });
+        return;
+      }
+      injectedSessions.add(input.sessionID);
+      const syntheticPart = {
+        type: "text",
+        text: formattedContent
+      };
+      output.parts.unshift(syntheticPart);
+      log("info", "Injected preloaded skills into session", {
+        sessionID: input.sessionID,
+        skillCount: loadedSkills.length,
+        skills: loadedSkills.map((s) => s.name)
+      });
+    },
+    "experimental.session.compacting": async (input, output) => {
+      if (!config.persistAfterCompaction || loadedSkills.length === 0) {
+        return;
+      }
+      output.context.push(
+        `## Preloaded Skills
+
+The following skills were auto-loaded at session start and should persist:
+
+${formattedContent}`
+      );
+      injectedSessions.delete(input.sessionID);
+      log("info", "Added preloaded skills to compaction context", {
+        sessionID: input.sessionID,
+        skillCount: loadedSkills.length
+      });
+    },
+    event: async ({ event }) => {
+      if (event.type === "session.deleted" && "sessionID" in event.properties) {
+        const sessionID = event.properties.sessionID;
+        injectedSessions.delete(sessionID);
+        log("debug", "Cleaned up session tracking", { sessionID });
+      }
+    }
+  };
+};
+var index_default = PreloadSkillsPlugin;
+
+exports.PreloadSkillsPlugin = PreloadSkillsPlugin;
+exports.default = index_default;
+exports.formatSkillsForInjection = formatSkillsForInjection;
+exports.loadSkills = loadSkills;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skill-loader.ts","../src/index.ts"],"names":["join","homedir","existsSync","readFileSync"],"mappings":"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","file":"index.cjs","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\"\nimport { join } from \"node:path\"\nimport { homedir } from \"node:os\"\nimport type { ParsedSkill } from \"./types.js\"\n\nconst SKILL_FILENAME = \"SKILL.md\"\n\nconst SKILL_SEARCH_PATHS = [\n  (dir: string) => join(dir, \".opencode\", \"skills\"),\n  (dir: string) => join(dir, \".claude\", \"skills\"),\n  () => join(homedir(), \".config\", \"opencode\", \"skills\"),\n  () => join(homedir(), \".claude\", \"skills\"),\n]\n\nfunction findSkillFile(skillName: string, projectDir: string): string | null {\n  for (const getPath of SKILL_SEARCH_PATHS) {\n    const skillDir = getPath(projectDir)\n    const skillPath = join(skillDir, skillName, SKILL_FILENAME)\n\n    if (existsSync(skillPath)) {\n      return skillPath\n    }\n  }\n  return null\n}\n\nfunction parseFrontmatter(content: string): { name?: string; description?: string } {\n  const frontmatterMatch = content.match(/^---\\s*\\n([\\s\\S]*?)\\n---/)\n  if (!frontmatterMatch?.[1]) {\n    return {}\n  }\n\n  const frontmatter = frontmatterMatch[1]\n  const result: { name?: string; description?: string } = {}\n\n  const nameMatch = frontmatter.match(/^name:\\s*(.+)$/m)\n  if (nameMatch?.[1]) {\n    result.name = nameMatch[1].trim()\n  }\n\n  const descMatch = frontmatter.match(/^description:\\s*(.+)$/m)\n  if (descMatch?.[1]) {\n    result.description = descMatch[1].trim()\n  }\n\n  return result\n}\n\nexport function loadSkill(skillName: string, projectDir: string): ParsedSkill | null {\n  const filePath = findSkillFile(skillName, projectDir)\n\n  if (!filePath) {\n    return null\n  }\n\n  try {\n    const content = readFileSync(filePath, \"utf-8\")\n    const { name, description } = parseFrontmatter(content)\n\n    return {\n      name: name ?? skillName,\n      description: description ?? \"\",\n      content,\n      filePath,\n    }\n  } catch {\n    return null\n  }\n}\n\nexport function loadSkills(skillNames: string[], projectDir: string): ParsedSkill[] {\n  const skills: ParsedSkill[] = []\n\n  for (const name of skillNames) {\n    const skill = loadSkill(name, projectDir)\n    if (skill) {\n      skills.push(skill)\n    }\n  }\n\n  return skills\n}\n\nexport function formatSkillsForInjection(skills: ParsedSkill[]): string {\n  if (skills.length === 0) {\n    return \"\"\n  }\n\n  const parts = skills.map(\n    (skill) =>\n      `<preloaded-skill name=\"${skill.name}\">\\n${skill.content}\\n</preloaded-skill>`\n  )\n\n  return `<preloaded-skills>\nThe following skills have been automatically loaded for this session:\n\n${parts.join(\"\\n\\n\")}\n</preloaded-skills>`\n}\n","import type { Plugin, PluginInput } from \"@opencode-ai/plugin\"\nimport type { Event, UserMessage, Part, Config } from \"@opencode-ai/sdk\"\nimport type { PreloadSkillsConfig, ParsedSkill } from \"./types.js\"\nimport { loadSkills, formatSkillsForInjection } from \"./skill-loader.js\"\n\nexport type { PreloadSkillsConfig, ParsedSkill }\nexport { loadSkills, formatSkillsForInjection }\n\nconst DEFAULT_CONFIG: PreloadSkillsConfig = {\n  skills: [],\n  persistAfterCompaction: true,\n  debug: false,\n}\n\nexport const PreloadSkillsPlugin: Plugin = async (ctx: PluginInput) => {\n  const injectedSessions = new Set<string>()\n  let loadedSkills: ParsedSkill[] = []\n  let formattedContent = \"\"\n  let config: PreloadSkillsConfig = DEFAULT_CONFIG\n\n  const log = (\n    level: \"debug\" | \"info\" | \"warn\" | \"error\",\n    message: string,\n    extra?: Record<string, unknown>\n  ) => {\n    if (level === \"debug\" && !config.debug) return\n\n    ctx.client.app.log({\n      body: {\n        service: \"preload-skills\",\n        level,\n        message,\n        extra,\n      },\n    })\n  }\n\n  return {\n    config: async (openCodeConfig: Config) => {\n      const pluginConfig = (openCodeConfig as Record<string, unknown>)[\n        \"opencode-plugin-preload-skills\"\n      ] as Partial<PreloadSkillsConfig> | undefined\n\n      config = {\n        ...DEFAULT_CONFIG,\n        ...pluginConfig,\n      }\n\n      if (config.skills.length === 0) {\n        log(\"warn\", \"No skills configured for preloading\")\n        return\n      }\n\n      loadedSkills = loadSkills(config.skills, ctx.directory)\n      formattedContent = formatSkillsForInjection(loadedSkills)\n\n      const loadedNames = loadedSkills.map((s) => s.name)\n      const missingNames = config.skills.filter((s) => !loadedNames.includes(s))\n\n      log(\"info\", `Loaded ${loadedSkills.length} skills for preloading`, {\n        loaded: loadedNames,\n        missing: missingNames.length > 0 ? missingNames : undefined,\n      })\n\n      if (missingNames.length > 0) {\n        log(\"warn\", \"Some configured skills were not found\", {\n          missing: missingNames,\n        })\n      }\n    },\n\n    \"chat.message\": async (\n      input: {\n        sessionID: string\n        agent?: string\n        model?: { providerID: string; modelID: string }\n        messageID?: string\n        variant?: string\n      },\n      output: { message: UserMessage; parts: Part[] }\n    ): Promise<void> => {\n      if (loadedSkills.length === 0 || !formattedContent) {\n        return\n      }\n\n      if (injectedSessions.has(input.sessionID)) {\n        log(\"debug\", \"Skills already injected for session\", {\n          sessionID: input.sessionID,\n        })\n        return\n      }\n\n      injectedSessions.add(input.sessionID)\n\n      const syntheticPart = {\n        type: \"text\",\n        text: formattedContent,\n      } as Part\n\n      output.parts.unshift(syntheticPart)\n\n      log(\"info\", \"Injected preloaded skills into session\", {\n        sessionID: input.sessionID,\n        skillCount: loadedSkills.length,\n        skills: loadedSkills.map((s) => s.name),\n      })\n    },\n\n    \"experimental.session.compacting\": async (\n      input: { sessionID: string },\n      output: { context: string[]; prompt?: string }\n    ): Promise<void> => {\n      if (!config.persistAfterCompaction || loadedSkills.length === 0) {\n        return\n      }\n\n      output.context.push(\n        `## Preloaded Skills\\n\\nThe following skills were auto-loaded at session start and should persist:\\n\\n${formattedContent}`\n      )\n\n      injectedSessions.delete(input.sessionID)\n\n      log(\"info\", \"Added preloaded skills to compaction context\", {\n        sessionID: input.sessionID,\n        skillCount: loadedSkills.length,\n      })\n    },\n\n    event: async ({ event }: { event: Event }): Promise<void> => {\n      if (\n        event.type === \"session.deleted\" &&\n        \"sessionID\" in event.properties\n      ) {\n        const sessionID = event.properties.sessionID as string\n        injectedSessions.delete(sessionID)\n        log(\"debug\", \"Cleaned up session tracking\", { sessionID })\n      }\n    },\n  }\n}\n\nexport default PreloadSkillsPlugin\n"]}

package/dist/index.d.cts

@@ -0,0 +1,20 @@
+import { Plugin } from '@opencode-ai/plugin';
+
+interface PreloadSkillsConfig {
+    skills: string[];
+    persistAfterCompaction?: boolean;
+    debug?: boolean;
+}
+interface ParsedSkill {
+    name: string;
+    description: string;
+    content: string;
+    filePath: string;
+}
+
+declare function loadSkills(skillNames: string[], projectDir: string): ParsedSkill[];
+declare function formatSkillsForInjection(skills: ParsedSkill[]): string;
+
+declare const PreloadSkillsPlugin: Plugin;
+
+export { type ParsedSkill, type PreloadSkillsConfig, PreloadSkillsPlugin, PreloadSkillsPlugin as default, formatSkillsForInjection, loadSkills };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { Plugin } from '@opencode-ai/plugin';
+
+interface PreloadSkillsConfig {
+    skills: string[];
+    persistAfterCompaction?: boolean;
+    debug?: boolean;
+}
+interface ParsedSkill {
+    name: string;
+    description: string;
+    content: string;
+    filePath: string;
+}
+
+declare function loadSkills(skillNames: string[], projectDir: string): ParsedSkill[];
+declare function formatSkillsForInjection(skills: ParsedSkill[]): string;
+
+declare const PreloadSkillsPlugin: Plugin;
+
+export { type ParsedSkill, type PreloadSkillsConfig, PreloadSkillsPlugin, PreloadSkillsPlugin as default, formatSkillsForInjection, loadSkills };

package/dist/index.js

@@ -0,0 +1,183 @@
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// src/skill-loader.ts
+var SKILL_FILENAME = "SKILL.md";
+var SKILL_SEARCH_PATHS = [
+  (dir) => join(dir, ".opencode", "skills"),
+  (dir) => join(dir, ".claude", "skills"),
+  () => join(homedir(), ".config", "opencode", "skills"),
+  () => join(homedir(), ".claude", "skills")
+];
+function findSkillFile(skillName, projectDir) {
+  for (const getPath of SKILL_SEARCH_PATHS) {
+    const skillDir = getPath(projectDir);
+    const skillPath = join(skillDir, skillName, SKILL_FILENAME);
+    if (existsSync(skillPath)) {
+      return skillPath;
+    }
+  }
+  return null;
+}
+function parseFrontmatter(content) {
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch?.[1]) {
+    return {};
+  }
+  const frontmatter = frontmatterMatch[1];
+  const result = {};
+  const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+  if (nameMatch?.[1]) {
+    result.name = nameMatch[1].trim();
+  }
+  const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+  if (descMatch?.[1]) {
+    result.description = descMatch[1].trim();
+  }
+  return result;
+}
+function loadSkill(skillName, projectDir) {
+  const filePath = findSkillFile(skillName, projectDir);
+  if (!filePath) {
+    return null;
+  }
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    const { name, description } = parseFrontmatter(content);
+    return {
+      name: name ?? skillName,
+      description: description ?? "",
+      content,
+      filePath
+    };
+  } catch {
+    return null;
+  }
+}
+function loadSkills(skillNames, projectDir) {
+  const skills = [];
+  for (const name of skillNames) {
+    const skill = loadSkill(name, projectDir);
+    if (skill) {
+      skills.push(skill);
+    }
+  }
+  return skills;
+}
+function formatSkillsForInjection(skills) {
+  if (skills.length === 0) {
+    return "";
+  }
+  const parts = skills.map(
+    (skill) => `<preloaded-skill name="${skill.name}">
+${skill.content}
+</preloaded-skill>`
+  );
+  return `<preloaded-skills>
+The following skills have been automatically loaded for this session:
+
+${parts.join("\n\n")}
+</preloaded-skills>`;
+}
+
+// src/index.ts
+var DEFAULT_CONFIG = {
+  skills: [],
+  persistAfterCompaction: true,
+  debug: false
+};
+var PreloadSkillsPlugin = async (ctx) => {
+  const injectedSessions = /* @__PURE__ */ new Set();
+  let loadedSkills = [];
+  let formattedContent = "";
+  let config = DEFAULT_CONFIG;
+  const log = (level, message, extra) => {
+    if (level === "debug" && !config.debug) return;
+    ctx.client.app.log({
+      body: {
+        service: "preload-skills",
+        level,
+        message,
+        extra
+      }
+    });
+  };
+  return {
+    config: async (openCodeConfig) => {
+      const pluginConfig = openCodeConfig["opencode-plugin-preload-skills"];
+      config = {
+        ...DEFAULT_CONFIG,
+        ...pluginConfig
+      };
+      if (config.skills.length === 0) {
+        log("warn", "No skills configured for preloading");
+        return;
+      }
+      loadedSkills = loadSkills(config.skills, ctx.directory);
+      formattedContent = formatSkillsForInjection(loadedSkills);
+      const loadedNames = loadedSkills.map((s) => s.name);
+      const missingNames = config.skills.filter((s) => !loadedNames.includes(s));
+      log("info", `Loaded ${loadedSkills.length} skills for preloading`, {
+        loaded: loadedNames,
+        missing: missingNames.length > 0 ? missingNames : void 0
+      });
+      if (missingNames.length > 0) {
+        log("warn", "Some configured skills were not found", {
+          missing: missingNames
+        });
+      }
+    },
+    "chat.message": async (input, output) => {
+      if (loadedSkills.length === 0 || !formattedContent) {
+        return;
+      }
+      if (injectedSessions.has(input.sessionID)) {
+        log("debug", "Skills already injected for session", {
+          sessionID: input.sessionID
+        });
+        return;
+      }
+      injectedSessions.add(input.sessionID);
+      const syntheticPart = {
+        type: "text",
+        text: formattedContent
+      };
+      output.parts.unshift(syntheticPart);
+      log("info", "Injected preloaded skills into session", {
+        sessionID: input.sessionID,
+        skillCount: loadedSkills.length,
+        skills: loadedSkills.map((s) => s.name)
+      });
+    },
+    "experimental.session.compacting": async (input, output) => {
+      if (!config.persistAfterCompaction || loadedSkills.length === 0) {
+        return;
+      }
+      output.context.push(
+        `## Preloaded Skills
+
+The following skills were auto-loaded at session start and should persist:
+
+${formattedContent}`
+      );
+      injectedSessions.delete(input.sessionID);
+      log("info", "Added preloaded skills to compaction context", {
+        sessionID: input.sessionID,
+        skillCount: loadedSkills.length
+      });
+    },
+    event: async ({ event }) => {
+      if (event.type === "session.deleted" && "sessionID" in event.properties) {
+        const sessionID = event.properties.sessionID;
+        injectedSessions.delete(sessionID);
+        log("debug", "Cleaned up session tracking", { sessionID });
+      }
+    }
+  };
+};
+var index_default = PreloadSkillsPlugin;
+
+export { PreloadSkillsPlugin, index_default as default, formatSkillsForInjection, loadSkills };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skill-loader.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { existsSync, readFileSync } from \"node:fs\"\nimport { join } from \"node:path\"\nimport { homedir } from \"node:os\"\nimport type { ParsedSkill } from \"./types.js\"\n\nconst SKILL_FILENAME = \"SKILL.md\"\n\nconst SKILL_SEARCH_PATHS = [\n  (dir: string) => join(dir, \".opencode\", \"skills\"),\n  (dir: string) => join(dir, \".claude\", \"skills\"),\n  () => join(homedir(), \".config\", \"opencode\", \"skills\"),\n  () => join(homedir(), \".claude\", \"skills\"),\n]\n\nfunction findSkillFile(skillName: string, projectDir: string): string | null {\n  for (const getPath of SKILL_SEARCH_PATHS) {\n    const skillDir = getPath(projectDir)\n    const skillPath = join(skillDir, skillName, SKILL_FILENAME)\n\n    if (existsSync(skillPath)) {\n      return skillPath\n    }\n  }\n  return null\n}\n\nfunction parseFrontmatter(content: string): { name?: string; description?: string } {\n  const frontmatterMatch = content.match(/^---\\s*\\n([\\s\\S]*?)\\n---/)\n  if (!frontmatterMatch?.[1]) {\n    return {}\n  }\n\n  const frontmatter = frontmatterMatch[1]\n  const result: { name?: string; description?: string } = {}\n\n  const nameMatch = frontmatter.match(/^name:\\s*(.+)$/m)\n  if (nameMatch?.[1]) {\n    result.name = nameMatch[1].trim()\n  }\n\n  const descMatch = frontmatter.match(/^description:\\s*(.+)$/m)\n  if (descMatch?.[1]) {\n    result.description = descMatch[1].trim()\n  }\n\n  return result\n}\n\nexport function loadSkill(skillName: string, projectDir: string): ParsedSkill | null {\n  const filePath = findSkillFile(skillName, projectDir)\n\n  if (!filePath) {\n    return null\n  }\n\n  try {\n    const content = readFileSync(filePath, \"utf-8\")\n    const { name, description } = parseFrontmatter(content)\n\n    return {\n      name: name ?? skillName,\n      description: description ?? \"\",\n      content,\n      filePath,\n    }\n  } catch {\n    return null\n  }\n}\n\nexport function loadSkills(skillNames: string[], projectDir: string): ParsedSkill[] {\n  const skills: ParsedSkill[] = []\n\n  for (const name of skillNames) {\n    const skill = loadSkill(name, projectDir)\n    if (skill) {\n      skills.push(skill)\n    }\n  }\n\n  return skills\n}\n\nexport function formatSkillsForInjection(skills: ParsedSkill[]): string {\n  if (skills.length === 0) {\n    return \"\"\n  }\n\n  const parts = skills.map(\n    (skill) =>\n      `<preloaded-skill name=\"${skill.name}\">\\n${skill.content}\\n</preloaded-skill>`\n  )\n\n  return `<preloaded-skills>\nThe following skills have been automatically loaded for this session:\n\n${parts.join(\"\\n\\n\")}\n</preloaded-skills>`\n}\n","import type { Plugin, PluginInput } from \"@opencode-ai/plugin\"\nimport type { Event, UserMessage, Part, Config } from \"@opencode-ai/sdk\"\nimport type { PreloadSkillsConfig, ParsedSkill } from \"./types.js\"\nimport { loadSkills, formatSkillsForInjection } from \"./skill-loader.js\"\n\nexport type { PreloadSkillsConfig, ParsedSkill }\nexport { loadSkills, formatSkillsForInjection }\n\nconst DEFAULT_CONFIG: PreloadSkillsConfig = {\n  skills: [],\n  persistAfterCompaction: true,\n  debug: false,\n}\n\nexport const PreloadSkillsPlugin: Plugin = async (ctx: PluginInput) => {\n  const injectedSessions = new Set<string>()\n  let loadedSkills: ParsedSkill[] = []\n  let formattedContent = \"\"\n  let config: PreloadSkillsConfig = DEFAULT_CONFIG\n\n  const log = (\n    level: \"debug\" | \"info\" | \"warn\" | \"error\",\n    message: string,\n    extra?: Record<string, unknown>\n  ) => {\n    if (level === \"debug\" && !config.debug) return\n\n    ctx.client.app.log({\n      body: {\n        service: \"preload-skills\",\n        level,\n        message,\n        extra,\n      },\n    })\n  }\n\n  return {\n    config: async (openCodeConfig: Config) => {\n      const pluginConfig = (openCodeConfig as Record<string, unknown>)[\n        \"opencode-plugin-preload-skills\"\n      ] as Partial<PreloadSkillsConfig> | undefined\n\n      config = {\n        ...DEFAULT_CONFIG,\n        ...pluginConfig,\n      }\n\n      if (config.skills.length === 0) {\n        log(\"warn\", \"No skills configured for preloading\")\n        return\n      }\n\n      loadedSkills = loadSkills(config.skills, ctx.directory)\n      formattedContent = formatSkillsForInjection(loadedSkills)\n\n      const loadedNames = loadedSkills.map((s) => s.name)\n      const missingNames = config.skills.filter((s) => !loadedNames.includes(s))\n\n      log(\"info\", `Loaded ${loadedSkills.length} skills for preloading`, {\n        loaded: loadedNames,\n        missing: missingNames.length > 0 ? missingNames : undefined,\n      })\n\n      if (missingNames.length > 0) {\n        log(\"warn\", \"Some configured skills were not found\", {\n          missing: missingNames,\n        })\n      }\n    },\n\n    \"chat.message\": async (\n      input: {\n        sessionID: string\n        agent?: string\n        model?: { providerID: string; modelID: string }\n        messageID?: string\n        variant?: string\n      },\n      output: { message: UserMessage; parts: Part[] }\n    ): Promise<void> => {\n      if (loadedSkills.length === 0 || !formattedContent) {\n        return\n      }\n\n      if (injectedSessions.has(input.sessionID)) {\n        log(\"debug\", \"Skills already injected for session\", {\n          sessionID: input.sessionID,\n        })\n        return\n      }\n\n      injectedSessions.add(input.sessionID)\n\n      const syntheticPart = {\n        type: \"text\",\n        text: formattedContent,\n      } as Part\n\n      output.parts.unshift(syntheticPart)\n\n      log(\"info\", \"Injected preloaded skills into session\", {\n        sessionID: input.sessionID,\n        skillCount: loadedSkills.length,\n        skills: loadedSkills.map((s) => s.name),\n      })\n    },\n\n    \"experimental.session.compacting\": async (\n      input: { sessionID: string },\n      output: { context: string[]; prompt?: string }\n    ): Promise<void> => {\n      if (!config.persistAfterCompaction || loadedSkills.length === 0) {\n        return\n      }\n\n      output.context.push(\n        `## Preloaded Skills\\n\\nThe following skills were auto-loaded at session start and should persist:\\n\\n${formattedContent}`\n      )\n\n      injectedSessions.delete(input.sessionID)\n\n      log(\"info\", \"Added preloaded skills to compaction context\", {\n        sessionID: input.sessionID,\n        skillCount: loadedSkills.length,\n      })\n    },\n\n    event: async ({ event }: { event: Event }): Promise<void> => {\n      if (\n        event.type === \"session.deleted\" &&\n        \"sessionID\" in event.properties\n      ) {\n        const sessionID = event.properties.sessionID as string\n        injectedSessions.delete(sessionID)\n        log(\"debug\", \"Cleaned up session tracking\", { sessionID })\n      }\n    },\n  }\n}\n\nexport default PreloadSkillsPlugin\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "opencode-plugin-preload-skills",
+  "version": "1.0.0",
+  "description": "OpenCode plugin that auto-loads specified skills into agent memory on session start",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "skills",
+    "preload",
+    "agent"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.0.85",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0"
+  }
+}