opencode-sa-assistant 0.2.3 → 0.2.5

package/README.md

@@ -28,10 +28,14 @@ This plugin activates when you use the `wadd` keyword in your messages, transfor
 
 ## Installation
 
-```bash
-# From the repository root
-cd packages/opencode-sa-assistant
-bun install
+Add the plugin to your `opencode.json`:
+
+```json
+{
+  "plugin": [
+    "opencode-sa-assistant"
+  ]
+}
 ```
 
 ## Usage
@@ -73,14 +77,14 @@ wadd bezos에게 고객 경험 관점에서 이 기능을 평가해달라고 해
 
 ## Skills
 
-The plugin includes 4 skill modules:
+The plugin includes 4 skill modules that are automatically installed to `~/.config/opencode/skills/`:
 
 - **guru**: Guru consultation patterns and philosophies
 - **mcp**: AWS MCP tools reference (search_documentation, read_documentation)
 - **docx**: AWS Blog-style document generation guidelines
 - **pptx**: SA presentation templates
 
-Skills are automatically loaded when needed.
+Skills are installed globally to ensure they are available before any plugin caching occurs. Use `/skill guru` or `/skill mcp` to load them.
 
 ## Testing
 
@@ -92,7 +96,7 @@ bun test
 bun test src/__tests__/integration.test.ts
 ```
 
-**Test Coverage**: 65 tests, 212 assertions, 100% pass rate
+**Test Coverage**: 80 tests, 234 assertions, 100% pass rate
 
 ## Development
 
@@ -163,6 +167,23 @@ Contributions are welcome! Please ensure:
 
 ## Changelog
 
+### v0.2.5 (2026-02-05)
+
+- Fix: Skills now installed to global location (`~/.config/opencode/skills/`)
+  - Resolves oh-my-opencode cache timing issue
+  - Skills are now available via `/skill` command immediately
+- Test coverage: 80 tests, 234 assertions
+
+### v0.2.4 (2026-02-05)
+
+- Added skill installation to `.opencode/skills/`
+- Skills: guru, mcp, docx, pptx
+
+### v0.2.3 (2026-02-05)
+
+- Aligned wadd hook with oh-my-opencode pattern
+- Added `removeCodeBlocks()` for keyword detection
+
 ### v0.1.0 (2026-02-05)
 
 - Initial release
@@ -171,4 +192,3 @@ Contributions are welcome! Please ensure:
 - Guru_Mandate consultation system
 - Well-Architected Framework integration
 - AWS MCP tools support
-- 65 tests, 100% pass rate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-sa-assistant",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
   "main": "src/index.ts",
   "description": "OpenCode plugin for AWS Solutions Architect assistant with multi-agent Guru system",

package/src/agents/index.ts

@@ -8,9 +8,10 @@
 import { SA_ORCHESTRATOR_PROMPT } from "../prompts/orchestrator";
 import { GURU_PROMPTS } from "../prompts/gurus";
 import { SPECIALIST_PROMPTS } from "../prompts/specialists";
-import { existsSync, mkdirSync, writeFileSync } from "fs";
-import { join } from "path";
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
+import { join, dirname } from "path";
 import { homedir } from "os";
+import { fileURLToPath } from "url";
 
 /**
  * Agent definition with frontmatter metadata
@@ -164,3 +165,109 @@ export function uninstallSAAgents(): string[] {
 
   return removed;
 }
+
+/**
+ * SA Skill names that will be installed
+ */
+export const SA_SKILL_NAMES = ["docx", "pptx", "mcp", "guru"] as const;
+
+/**
+ * Get the skills directory path for global installation
+ * Uses ~/.config/opencode/skills/ to ensure skills are available
+ * before any plugin loads (solving the oh-my-opencode cache timing issue)
+ */
+function getSkillsDir(): string {
+  return join(homedir(), ".config", "opencode", "skills");
+}
+
+/**
+ * Get the source skills directory (where SKILL.md files are bundled)
+ */
+function getSourceSkillsDir(): string {
+  // In ESM, use import.meta.url to find the module location
+  // Fallback to __dirname for CommonJS compatibility
+  try {
+    const currentFile = fileURLToPath(import.meta.url);
+    return join(dirname(currentFile), "..", "skills");
+  } catch {
+    // Fallback for environments where import.meta.url is not available
+    return join(__dirname, "..", "skills");
+  }
+}
+
+/**
+ * Install SA skills to ~/.config/opencode/skills/ (global location)
+ */
+export function installSASkills(): { installed: string[]; skipped: string[]; errors: string[] } {
+  const skillsDir = getSkillsDir();
+  const sourceDir = getSourceSkillsDir();
+  const installed: string[] = [];
+  const skipped: string[] = [];
+  const errors: string[] = [];
+
+  for (const skillName of SA_SKILL_NAMES) {
+    const targetDir = join(skillsDir, skillName);
+    const targetPath = join(targetDir, "SKILL.md");
+    const sourcePath = join(sourceDir, skillName, "SKILL.md");
+
+    try {
+      // Check if target already exists
+      if (existsSync(targetPath)) {
+        skipped.push(skillName);
+        continue;
+      }
+
+      // Read source file
+      if (!existsSync(sourcePath)) {
+        errors.push(`${skillName}: source file not found at ${sourcePath}`);
+        continue;
+      }
+
+      const content = readFileSync(sourcePath, "utf-8");
+
+      // Create target directory
+      if (!existsSync(targetDir)) {
+        mkdirSync(targetDir, { recursive: true });
+      }
+
+      // Write skill file
+      writeFileSync(targetPath, content, "utf-8");
+      installed.push(skillName);
+    } catch (err) {
+      errors.push(`${skillName}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+
+  return { installed, skipped, errors };
+}
+
+/**
+ * Uninstall SA skills from ~/.config/opencode/skills/
+ */
+export function uninstallSASkills(): string[] {
+  const skillsDir = getSkillsDir();
+  const removed: string[] = [];
+
+  for (const skillName of SA_SKILL_NAMES) {
+    const skillDir = join(skillsDir, skillName);
+    const skillPath = join(skillDir, "SKILL.md");
+    
+    if (existsSync(skillPath)) {
+      try {
+        const { unlinkSync, rmdirSync } = require("fs");
+        unlinkSync(skillPath);
+        // Try to remove the directory if empty
+        try {
+          rmdirSync(skillDir);
+        } catch {
+          // Directory not empty, leave it
+        }
+        removed.push(skillName);
+      } catch {
+        // Ignore errors during uninstall
+      }
+    }
+  }
+
+  return removed;
+}

package/src/index.ts

@@ -1,12 +1,21 @@
 import type { Plugin } from "@opencode-ai/plugin";
 import { chatMessageHook, systemTransformHook } from "./hooks/wadd-mode";
-import { installSAAgents } from "./agents";
+import { installSAAgents, installSASkills } from "./agents";
 
 export const SaAssistantPlugin: Plugin = async (ctx) => {
-  const { installed, skipped } = installSAAgents();
+  const agentResult = installSAAgents();
+  const skillResult = installSASkills();
   
-  if (installed.length > 0) {
-    console.log(`[SA Assistant] Installed agents: ${installed.join(", ")}`);
+  if (agentResult.installed.length > 0) {
+    console.log(`[SA Assistant] Installed agents: ${agentResult.installed.join(", ")}`);
+  }
+  
+  if (skillResult.installed.length > 0) {
+    console.log(`[SA Assistant] Installed skills: ${skillResult.installed.join(", ")}`);
+  }
+  
+  if (skillResult.errors.length > 0) {
+    console.warn(`[SA Assistant] Skill installation errors: ${skillResult.errors.join(", ")}`);
   }
 
   return {