opencodekit 0.6.0 → 0.6.2

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.6.0",
+  version: "0.6.2",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {

package/dist/template/.opencode/AGENTS.md

@@ -289,7 +289,10 @@ Use `find_skills` → `use_skill` when:
 - Complex multi-step work → `writing-plans` → `executing-plans`
 - Finished implementation → `requesting-code-review`
 - Building UI → `frontend-aesthetics`
-- UI/UX with images → `ui-ux-research`
+- UI/UX with images → `ui-ux-research` or `visual-analysis`
+- Accessibility audit → `accessibility-audit`
+- Design system audit → `design-system-audit`
+- Mockups to code → `mockup-to-code`
 - Large codebase research → `gemini-large-context`
 
 Skip for simple questions, quick edits, or conversations.

package/dist/template/.opencode/command/skill-create.md

@@ -11,13 +11,13 @@ Use `use_skill("writing-skills")` to create a new skill.
 ## Workflow
 
 1. **Load skill** - `use_skill("writing-skills")`
-2. **Follow the TDD process** - Test with subagents before writing
-3. **Save to** `.opencode/skills/$ARGUMENTS/`
+2. **Follow by TDD process** - Test with subagents before writing
+3. **Save to** `.opencode/skill/$ARGUMENTS/`
 
 ## Skill Structure
 
 ```
-.opencode/skills/$ARGUMENTS/
+.opencode/skill/$ARGUMENTS/
 ├── SKILL.md          (Main skill definition)
 ├── instructions.md   (Detailed instructions)
 └── tests/            (Test scenarios)

package/dist/template/.opencode/command/skill-optimize.md

@@ -10,7 +10,7 @@ Use `use_skill("writing-skills")` to optimize an existing skill.
 
 ## Workflow
 
-1. **Read current skill** from `.opencode/skills/$ARGUMENTS/` or `.opencode/superpowers/skills/$ARGUMENTS/`
+1. **Read current skill** from `.opencode/skill/$ARGUMENTS/` or `.opencode/superpowers/skills/$ARGUMENTS/`
 2. **Load skill** - `use_skill("writing-skills")`
 3. **Apply TDD process** - Test, refine, verify
 4. **Test changes** with `use_skill("testing-skills-with-subagents")`

package/dist/template/.opencode/dcp.jsonc

@@ -1,43 +1,65 @@
 {
-  // Enable or disable the plugin
-  "enabled": true,
-  // Enable debug logging to ~/.config/opencode/logs/dcp/
-  "debug": false,
-  // Show toast when plugin updates are available
-  "showUpdateToasts": true,
-  // Summary display: "off", "minimal", or "detailed"
-  // Note: "detailed" may cause issues with extended thinking models
-  "pruningSummary": "off",
-  "strategies": {
-    // Deduplication runs automatically on every request
-    "deduplication": {
-      "enabled": true,
-      "protectedTools": [],
-    },
-    // Exposes prune tool to the LLM for manual context management
-    "pruneTool": {
-      "enabled": true,
-      "protectedTools": [
-        "task",
-        "todowrite",
-        "todoread",
-        "prune",
-        "batch",
-        "write",
-        "edit",
-      ],
-      // Nudge the AI to prune periodically
-      "nudge": {
-        "enabled": true,
-        "frequency": 10,
-      },
-    },
-    // LLM-based semantic analysis on idle (legacy, resource intensive)
-    "onIdle": {
-      "enabled": false,
-      "showModelErrorToasts": true,
-      "strictModelSelection": true,
-      "protectedTools": [],
-    },
-  },
+	// Enable or disable the plugin
+	"enabled": true,
+	// Enable debug logging to ~/.config/opencode/logs/dcp/
+	"debug": false,
+	// Notification display: "off", "minimal", or "detailed"
+	"pruneNotification": "off",
+	// Protect from pruning for <turns> message turns
+	"turnProtection": {
+		"enabled": true,
+		"turns": 4
+	},
+	// LLM-driven context pruning tools
+	"tools": {
+		// Shared settings for all prune tools
+		"settings": {
+			// Nudge the LLM to use prune tools (every <nudgeFrequency> tool results)
+			"nudgeEnabled": true,
+			"nudgeFrequency": 10,
+			// Additional tools to protect from pruning (defaults: task, todowrite, todoread, discard, extract, batch)
+			"protectedTools": [
+				"write",
+				"edit",
+				"memory-read",
+				"memory-update",
+				"observation",
+				"use_skill",
+				"skill"
+			]
+		},
+		// Removes tool content from context without preservation (for completed tasks or noise)
+		"discard": {
+			"enabled": true
+		},
+		// Distills key findings into preserved knowledge before removing raw content
+		"extract": {
+			"enabled": true,
+			// Show distillation content as an ignored message notification
+			"showDistillation": false
+		}
+	},
+	// Automatic pruning strategies
+	"strategies": {
+		// Remove duplicate tool calls (same tool with same arguments)
+		"deduplication": {
+			"enabled": true,
+			// Additional tools to protect from pruning
+			"protectedTools": []
+		},
+		// Prune write tool inputs when the file has been subsequently read
+		"supersedeWrites": {
+			"enabled": true
+		},
+		// (Legacy) Run an LLM to analyze what tool calls are no longer relevant on idle
+		"onIdle": {
+			"enabled": false,
+			// Additional tools to protect from pruning
+			"protectedTools": [],
+			// Show toast notifications when model selection fails
+			"showModelErrorToasts": true,
+			// When true, fallback models are not permitted
+			"strictModelSelection": false
+		}
+	}
 }

package/dist/template/.opencode/opencode.json

@@ -7,7 +7,7 @@
     },
     "build": {
       "description": "Primary development agent with full codebase access",
-      "model": "proxypal/gemini-claude-opus-4-5-thinking"
+      "model": "github-copilot/claude-opus-4.5"
     },
     "explore": {
       "description": "Fast codebase search specialist",
@@ -29,7 +29,7 @@
     },
     "rush": {
       "description": "Fast primary agent for small, well-defined tasks",
-      "model": "zai-coding-plan/glm-4.7"
+      "model": "proxypal/gemini-claude-opus-4-5-thinking"
     },
     "scout": {
       "description": "External research specialist for library docs and patterns",
@@ -153,7 +153,7 @@
       "type": "local"
     }
   },
-  "model": "proxypal/gemini-claude-opus-4-5-thinking",
+  "model": "github-copilot/claude-haiku-4.5",
   "permission": {
     "bash": {
       "git commit *": "ask",
@@ -168,7 +168,8 @@
   "plugin": [
     "opencode-gemini-auth",
     "@tarquinen/opencode-dcp@latest",
-    "@franlol/opencode-md-table-formatter@0.0.3"
+    "@franlol/opencode-md-table-formatter@0.0.3",
+    "./plugin/skill.ts"
   ],
   "provider": {
     "github-copilot": {

package/dist/template/.opencode/package.json

@@ -11,10 +11,10 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@opencode-ai/plugin": "1.0.186"
+    "@opencode-ai/plugin": "1.0.199"
   },
   "devDependencies": {
-    "@types/node": "^20.19.27",
+    "@types/node": "^25.0.3",
     "fs": "^0.0.1-security",
     "path": "^0.12.7",
     "typescript": "^5.9.3"

package/dist/template/.opencode/pickle-thinker.jsonc

@@ -0,0 +1,11 @@
+{
+  // Ultrathink config for pickle-thinker
+  // mode: "lite" keeps the original behavior (prefix user prompts only).
+  // mode: "tool" adds an extra user turn after each tool result to force deeper analysis.
+  // Note: tool mode increases turns/tokens and may impact subscription limits.
+  "enabled": true,
+  // "lite" | "tool"
+  "mode": "tool",
+  // Change the thinking keyword if you like
+  "prefix": "Ultrathink: "
+}

package/dist/template/.opencode/plugin/skill.ts

@@ -0,0 +1,275 @@
+/**
+ * Skills plugin for OpenCode.ai
+ *
+ * Provides custom tools for loading and discovering skills.
+ * Skills are loaded on-demand via use_skill tool, not auto-injected.
+ *
+ * OpenCode Official Skill Locations:
+ * - Project skills: .opencode/skill/
+ * - Personal skills: ~/.opencode/skill/
+ */
+
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { type Plugin, tool } from "@opencode-ai/plugin";
+
+interface SkillResolution {
+  skillFile: string;
+  sourceType: "project" | "personal";
+  skillPath: string;
+}
+
+interface SkillInfo {
+  path: string;
+  skillFile: string;
+  name: string;
+  description: string;
+  sourceType: "project" | "personal";
+}
+
+interface Frontmatter {
+  name: string;
+  description: string;
+}
+
+// ============================================
+// Skills Core Functions
+// ============================================
+
+function extractFrontmatter(filePath: string): Frontmatter {
+  try {
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split("\n");
+
+    let inFrontmatter = false;
+    let name = "";
+    let description = "";
+
+    for (const line of lines) {
+      if (line.trim() === "---") {
+        if (inFrontmatter) break;
+        inFrontmatter = true;
+        continue;
+      }
+
+      if (inFrontmatter) {
+        const match = line.match(/^(\w+):\s*(.*)$/);
+        if (match) {
+          const [, key, value] = match;
+          if (key === "name") name = value.trim();
+          if (key === "description") description = value.trim();
+        }
+      }
+    }
+
+    return { name, description };
+  } catch {
+    return { name: "", description: "" };
+  }
+}
+
+function findSkillsInDir(
+  dir: string,
+  sourceType: "project" | "personal",
+  maxDepth = 3,
+): SkillInfo[] {
+  const skills: SkillInfo[] = [];
+
+  if (!fs.existsSync(dir)) return skills;
+
+  function recurse(currentDir: string, depth: number) {
+    if (depth > maxDepth) return;
+
+    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(currentDir, entry.name);
+
+      if (entry.isDirectory()) {
+        const skillFile = path.join(fullPath, "SKILL.md");
+        if (fs.existsSync(skillFile)) {
+          const { name, description } = extractFrontmatter(skillFile);
+          skills.push({
+            path: fullPath,
+            skillFile,
+            name: name || entry.name,
+            description: description || "",
+            sourceType,
+          });
+        }
+        recurse(fullPath, depth + 1);
+      }
+    }
+  }
+
+  recurse(dir, 0);
+  return skills;
+}
+
+function stripFrontmatter(content: string): string {
+  const lines = content.split("\n");
+  let inFrontmatter = false;
+  let frontmatterEnded = false;
+  const contentLines: string[] = [];
+
+  for (const line of lines) {
+    if (line.trim() === "---") {
+      if (inFrontmatter) {
+        frontmatterEnded = true;
+        continue;
+      }
+      inFrontmatter = true;
+      continue;
+    }
+
+    if (frontmatterEnded || !inFrontmatter) {
+      contentLines.push(line);
+    }
+  }
+
+  return contentLines.join("\n").trim();
+}
+
+// ============================================
+// Plugin Export
+// ============================================
+
+export const SkillsPlugin: Plugin = async ({ client, directory }) => {
+  const homeDir = os.homedir();
+  const projectSkillsDir = path.join(directory, ".opencode/skill");
+  const personalSkillsDir = path.join(homeDir, ".opencode/skill");
+
+  return {
+    tool: {
+      use_skill: tool({
+        description:
+          "Load and read a specific skill to guide your work. Skills contain proven workflows, mandatory processes, and expert techniques.",
+        args: {
+          skill_name: tool.schema
+            .string()
+            .describe(
+              'Name of skill to load (e.g., "brainstorming", "my-custom-skill", or "project:my-skill")',
+            ),
+        },
+        execute: async (
+          args: { skill_name: string },
+          context: { sessionID: string },
+        ) => {
+          const { skill_name } = args;
+
+          // Resolve with priority: project > personal
+          const forceProject = skill_name.startsWith("project:");
+          const actualSkillName = forceProject
+            ? skill_name.replace(/^project:/, "")
+            : skill_name;
+
+          let resolved: SkillResolution | null = null;
+
+          // Try project skills first
+          if (forceProject) {
+            const projectSkillFile = path.join(
+              projectSkillsDir,
+              actualSkillName,
+              "SKILL.md",
+            );
+            if (fs.existsSync(projectSkillFile)) {
+              resolved = {
+                skillFile: projectSkillFile,
+                sourceType: "project",
+                skillPath: actualSkillName,
+              };
+            }
+          }
+
+          // Fall back to personal resolution
+          if (!resolved && !forceProject) {
+            const personalSkillFile = path.join(
+              personalSkillsDir,
+              skill_name,
+              "SKILL.md",
+            );
+            if (fs.existsSync(personalSkillFile)) {
+              resolved = {
+                skillFile: personalSkillFile,
+                sourceType: "personal",
+                skillPath: skill_name,
+              };
+            }
+          }
+
+          if (!resolved) {
+            return `Error: Skill "${skill_name}" not found.\n\nRun find_skills to see available skills.`;
+          }
+
+          const fullContent = fs.readFileSync(resolved.skillFile, "utf8");
+          const { name, description } = extractFrontmatter(resolved.skillFile);
+          const content = stripFrontmatter(fullContent);
+          const skillDirectory = path.dirname(resolved.skillFile);
+
+          const skillHeader = `# ${name || skill_name}
+# ${description || ""}
+# Supporting tools and docs are in ${skillDirectory}
+# ============================================`;
+
+          // Insert as user message with noReply for persistence across compaction
+          try {
+            await client.session.prompt({
+              path: { id: context.sessionID },
+              body: {
+                noReply: true,
+                parts: [
+                  {
+                    type: "text",
+                    text: `Loading skill: ${name || skill_name}`,
+                  },
+                  { type: "text", text: `${skillHeader}\n\n${content}` },
+                ],
+              },
+            });
+          } catch {
+            // Fallback: return content directly if message insertion fails
+            return `${skillHeader}\n\n${content}`;
+          }
+
+          return `Launching skill: ${name || skill_name}`;
+        },
+      }),
+
+      find_skills: tool({
+        description:
+          "List all available skills in project and personal skill libraries.",
+        args: {},
+        execute: async () => {
+          const projectSkills = findSkillsInDir(projectSkillsDir, "project", 3);
+          const personalSkills = findSkillsInDir(
+            personalSkillsDir,
+            "personal",
+            3,
+          );
+
+          const allSkills = [...projectSkills, ...personalSkills];
+
+          if (allSkills.length === 0) {
+            return `No skills found. Add project skills to .opencode/skill/ or personal skills to ~/.opencode/skill/`;
+          }
+
+          let output = "Available skills:\n\n";
+
+          for (const skill of allSkills) {
+            const namespace = skill.sourceType === "project" ? "project:" : "";
+            const skillName = skill.name || path.basename(skill.path);
+
+            output += `${namespace}${skillName}\n`;
+            if (skill.description) {
+              output += `  ${skill.description}\n`;
+            }
+            output += `  Directory: ${skill.path}\n\n`;
+          }
+
+          return output;
+        },
+      }),
+    },
+  };
+};

package/dist/template/.opencode/{skills → skill}/accessibility-audit/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: accessibility-audit
+description: Use when auditing UI components or pages for accessibility compliance, checking WCAG conformance, identifying keyboard navigation issues, color contrast problems, and pre-launch accessibility verification
+---
+
 # Accessibility Audit Skill
 
 Audit UI accessibility against WCAG 2.1/2.2 guidelines.

package/dist/template/.opencode/{skills → skill}/brainstorming/SKILL.md

@@ -46,8 +46,8 @@ Start by understanding the current project context, then ask questions one at a
 **Implementation (if continuing):**
 
 - Ask: "Ready to set up for implementation?"
-- Use superpowers:using-git-worktrees to create isolated workspace
-- Use superpowers:writing-plans to create detailed implementation plan
+- Use use_skill("using-git-worktrees") to create isolated workspace
+- Use use_skill("writing-plans") to create detailed implementation plan
 
 ## Key Principles
 

package/dist/template/.opencode/{skills → skill}/design-system-audit/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: design-system-audit
+description: Use when auditing existing design systems for consistency, documenting undocumented design tokens, identifying design debt, preparing for design system refactoring, or comparing implementation vs design specs
+---
+
 # Design System Audit Skill
 
 Audit, document, and improve design systems.

package/dist/template/.opencode/{skills → skill}/executing-plans/SKILL.md

@@ -16,28 +16,35 @@ Load plan, review critically, execute tasks in batches, report for review betwee
 ## The Process
 
 ### Step 1: Load and Review Plan
+
 1. Read plan file
 2. Review critically - identify any questions or concerns about the plan
 3. If concerns: Raise them with your human partner before starting
 4. If no concerns: Create TodoWrite and proceed
 
 ### Step 2: Execute Batch
+
 **Default: First 3 tasks**
 
 For each task:
+
 1. Mark as in_progress
 2. Follow each step exactly (plan has bite-sized steps)
 3. Run verifications as specified
 4. Mark as completed
 
 ### Step 3: Report
+
 When batch complete:
+
 - Show what was implemented
 - Show verification output
 - Say: "Ready for feedback."
 
 ### Step 4: Continue
+
 Based on feedback:
+
 - Apply changes if needed
 - Execute next batch
 - Repeat until complete
@@ -45,13 +52,15 @@ Based on feedback:
 ### Step 5: Complete Development
 
 After all tasks complete and verified:
-- Announce: "I'm using the finishing-a-development-branch skill to complete this work."
-- **REQUIRED SUB-SKILL:** Use superpowers:finishing-a-development-branch
+
+- Announce: "I'm using finishing-a-development-branch skill to complete this work."
+- **REQUIRED SUB-SKILL:** Use use_skill("finishing-a-development-branch")
 - Follow that skill to verify tests, present options, execute choice
 
 ## When to Stop and Ask for Help
 
 **STOP executing immediately when:**
+
 - Hit a blocker mid-batch (missing dependency, test fails, instruction unclear)
 - Plan has critical gaps preventing starting
 - You don't understand an instruction
@@ -62,12 +71,14 @@ After all tasks complete and verified:
 ## When to Revisit Earlier Steps
 
 **Return to Review (Step 1) when:**
+
 - Partner updates the plan based on your feedback
 - Fundamental approach needs rethinking
 
 **Don't force through blockers** - stop and ask.
 
 ## Remember
+
 - Review plan critically first
 - Follow plan steps exactly
 - Don't skip verifications

package/dist/template/.opencode/{skills → skill}/frontend-aesthetics/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: frontend-aesthetics
+description: Use when building landing pages, dashboards, forms, or any frontend generation task where you need to prevent generic "AI slop" and create distinctive, intentional designs
+---
+
 # Frontend Aesthetics Skill
 
 Prevent generic "AI slop" frontends. Create distinctive, intentional designs.

package/dist/template/.opencode/{skills → skill}/mockup-to-code/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: mockup-to-code
+description: Use when converting UI mockups, screenshots, Figma/Sketch designs, wireframes, or building component libraries from design systems into production-ready code
+---
+
 # Mockup to Code Skill
 
 Convert UI mockups, screenshots, and designs into production-ready code.