fix: fallback to an existing bundled skills root

kompass.jsonc

@@ -54,12 +54,6 @@
     "summarize-changes": { "enabled": true },
   },
 
-  "skills": {
-    "entries": {
-      "kompass-workflows": { "enabled": true },
-    },
-  },
-
   "defaults": {
     "baseBranch": "main",
   },

packages/core/kompass.jsonc

@@ -54,12 +54,6 @@
     "summarize-changes": { "enabled": true },
   },
 
-  "skills": {
-    "entries": {
-      "kompass-workflows": { "enabled": true },
-    },
-  },
-
   "defaults": {
     "baseBranch": "main",
   },

packages/core/skills/README.md

@@ -1,2 +1,2 @@
-This directory intentionally exists so packaged OpenCode builds always ship a
-concrete `skills/` path, even when no bundled skill files are present yet.
+This directory contains bundled Kompass skills that ship with packaged OpenCode
+builds. Keep a concrete `skills/` path available for runtime registration.

packages/opencode/.opencode/kompass.jsonc

@@ -96,13 +96,6 @@
       "enabled": true
     }
   },
-  "skills": {
-    "entries": {
-      "kompass-workflows": {
-        "enabled": true
-      }
-    }
-  },
   "defaults": {
     "baseBranch": "main"
   },

packages/opencode/.opencode/skills/README.md

@@ -1,2 +1,2 @@
-This directory intentionally exists so packaged OpenCode builds always ship a
-concrete `skills/` path, even when no bundled skill files are present yet.
+This directory contains bundled Kompass skills that ship with packaged OpenCode
+builds. Keep a concrete `skills/` path available for runtime registration.

packages/opencode/config.ts

@@ -39,12 +39,29 @@ async function pathExists(filePath: string): Promise<boolean> {
   }
 }
 
+async function hasBundledSkillDirectories(root: string): Promise<boolean> {
+  try {
+    const entries = await readdir(root, { withFileTypes: true });
+    return entries.some((entry) => entry.isDirectory());
+  } catch {
+    return false;
+  }
+}
+
 async function resolveBundledSkillsRoot(): Promise<string | undefined> {
+  let firstExistingCandidate: string | undefined;
+
   for (const candidate of BUNDLED_SKILL_ROOT_CANDIDATES) {
-    if (await pathExists(candidate)) return candidate;
+    if (!await pathExists(candidate)) continue;
+
+    firstExistingCandidate ??= candidate;
+
+    if (await hasBundledSkillDirectories(candidate)) {
+      return candidate;
+    }
   }
 
-  return undefined;
+  return firstExistingCandidate;
 }
 
 type ApplyConfigOptions = {

packages/opencode/kompass.jsonc

@@ -54,12 +54,6 @@
     "summarize-changes": { "enabled": true },
   },
 
-  "skills": {
-    "entries": {
-      "kompass-workflows": { "enabled": true },
-    },
-  },
-
   "defaults": {
     "baseBranch": "main",
   },

packages/web/src/content/docs/docs/reference/skills/index.mdx

@@ -5,14 +5,8 @@ description: Overview of skill support in Kompass.
 
 Kompass supports bundled and plugin-provided skills through config-driven filtering.
 
-The base config currently enables the `kompass-workflows` skill entry.
+The base config does not enable any bundled Kompass skills yet.
 
 ## Bundled skills
 
-### `kompass-workflows`
-
-Bundled Kompass workflow skill entry enabled by the base config.
-
-- enabled through `skills.entries`
-- registered automatically by the OpenCode adapter
-- backed by a concrete bundled `skills/` path even when the directory is intentionally sparse
+None yet.