Fix OpenCode slash command bridge (#483)

Add a first-class OpenCode command bridge across builds, installs, updates, linked installs, and pinned shortcuts. Preserve current provider behavior while backfilling missing or drifted command files.\n\nAI assistance: contributor and maintainer work used AI tools as disclosed in the PR discussion and commits.

scripts/lib/root-commands-sync.mjs

@@ -0,0 +1,27 @@
+/**
+ * Mirror generated provider command files (e.g. OpenCode's
+ * commands/impeccable.md) from dist/ into the tracked root harness folders.
+ * Without this, the release sync ships skills/agents/hooks but no slash
+ * command bridge, so direct GitHub, npx-skills, and submodule installs of
+ * OpenCode stay bridge-less (#483). Per-entry copy like the skills sync:
+ * the destination directory is never removed, so repo-local or pinned
+ * command files are preserved.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+
+export function syncRootCommands(distDir, rootDir, providers) {
+  const synced = [];
+  for (const { provider, configDir } of providers) {
+    const src = path.join(distDir, provider, configDir, 'commands');
+    if (!fs.existsSync(src)) continue;
+    const dest = path.join(rootDir, configDir, 'commands');
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+      if (!entry.isFile()) continue;
+      fs.copyFileSync(path.join(src, entry.name), path.join(dest, entry.name));
+    }
+    synced.push(configDir);
+  }
+  return synced;
+}

scripts/lib/transformers/factory.js

@@ -379,6 +379,28 @@ export function createTransformer(config) {
       }
     }
 
+    // Ship an explicit slash-command surface for OpenCode. OpenCode registers
+    // skill commands natively but its TUI autocomplete hides them by deliberate
+    // design (anomalyco/opencode#25439); this file also pins execution policy
+    // (agent: build, subtask: true) and routes through OpenCode's skill tool,
+    // which resolves the skill base dir for any install scope. Menu visibility
+    // is the only part contingent on OpenCode's design; the rest is intentional.
+    // Schema restricted to what OpenCode recognises (description, agent, model,
+    // variant, subtask).
+    if (provider === 'opencode' && skills.length > 0) {
+      const commandsDir = path.join(providerDir, `${configDir}/commands`);
+      ensureDir(commandsDir);
+      for (const skill of skills) {
+        const bridgeBody = `Call skill({ name: "${skill.name}" }) and follow its \`Setup\` and \`Commands\` sections to handle $ARGUMENTS.\n`;
+        const bridgeFrontmatter = generateYamlFrontmatter({
+          description: skill.description,
+          agent: 'build',
+          subtask: true,
+        });
+        writeFile(path.join(commandsDir, `${skill.name}.md`), `${bridgeFrontmatter}\n${bridgeBody}`.replace(/\n+$/, '\n'));
+      }
+    }
+
     if (config.agentFormat) {
       const agentsDir = path.join(providerDir, `${configDir}/agents`);
       for (const skill of skills) {