From 260a20824f63060d4ecbee2557e0b3b7223b15f7 Mon Sep 17 00:00:00 2001
From: Mike Ramirez <mike@labelgrid.com>
Date: Sat, 1 Aug 2026 23:33:51 -0600
Subject: [PATCH] fix: repair release verification

---
 README.md                          | 8 ++++++--
 src/__tests__/skill-loader.test.ts | 2 +-
 src/skill-loader.ts                | 2 +-
 src/tools/skill-mcp.ts             | 2 +-
 4 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 94520e7..6d96390 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,8 @@ Or install it locally:
 
 ## Quick Start
 
-This repo includes a working example skill. After installing the plugin, try:
+This repository includes a working project skill. From a clone of the repository,
+try:
 
 ```
 skill(name="playwright-example")
@@ -62,7 +63,10 @@ Then use the embedded MCP:
 skill_mcp(mcp_name="playwright", tool_name="browser_navigate", arguments='{"url": "https://example.com"}')
 ```
 
-See [`.opencode/skills/playwright-example/SKILL.md`](.opencode/skills/playwright-example/SKILL.md) for the full example.
+The npm package does not install example skills into your OpenCode configuration.
+When installing from npm, copy
+[`.opencode/skills/playwright-example/SKILL.md`](.opencode/skills/playwright-example/SKILL.md)
+to one of the supported skill roots below before trying it.
 
 ## Usage
 
diff --git a/src/__tests__/skill-loader.test.ts b/src/__tests__/skill-loader.test.ts
index 064a69d..b5eba36 100644
--- a/src/__tests__/skill-loader.test.ts
+++ b/src/__tests__/skill-loader.test.ts
@@ -101,7 +101,7 @@ describe('skill discovery', () => {
     expect(skills).toHaveLength(1)
     expect(skills[0]).toMatchObject({
       name: 'shared',
-      scope: 'opencode-project',
+      scope: 'claude-project',
       mcpConfig: {
         'project-mcp': {
           command: ['node', 'server.js']
diff --git a/src/skill-loader.ts b/src/skill-loader.ts
index 886d7d0..63c8e6f 100644
--- a/src/skill-loader.ts
+++ b/src/skill-loader.ts
@@ -223,7 +223,7 @@ async function discoverNativeProjectSkills(): Promise<LoadedSkill[][]> {
 }
 
 /**
- * Discover all skills from both opencode locations
+ * Discover skills from all supported global and project roots
  * Priority: project > global
  */
 export async function discoverSkills(): Promise<LoadedSkill[]> {
diff --git a/src/tools/skill-mcp.ts b/src/tools/skill-mcp.ts
index ef3e94e..300f989 100644
--- a/src/tools/skill-mcp.ts
+++ b/src/tools/skill-mcp.ts
@@ -167,7 +167,7 @@ export function createSkillMcpTool(options: CreateSkillMcpToolOptions): ToolDefi
           `MCP server "${args.mcp_name}" not found.\n\n` +
           `Available MCP servers in loaded skills:\n` +
           formatAvailableMcps(skills) + '\n\n' +
-          `Hint: Ensure the skill is located in a supported directory (.opencode/skills, .claude/skills, .agents/skills, ~/.config/opencode/skills, ~/.claude/skills, ~/.agents/skills), then restart OpenCode.`
+          `Hint: Verify mcp_name matches an embedded MCP definition. If you added or moved the skill in a supported skills directory, restart OpenCode to refresh discovery.`
         )
       }