vskill 0.5.102 → 0.5.104

package/README.md

@@ -10,7 +10,7 @@
   <a href="https://www.npmjs.com/package/vskill"><img src="https://img.shields.io/npm/dw/vskill?color=cb3837&logo=npm&label=downloads" alt="downloads" /></a>
   <img src="https://img.shields.io/badge/agents-49_platforms-0969DA" alt="49 agents" />
   <img src="https://img.shields.io/badge/plugins-5-8B5CF6" alt="5 plugins" />
-  <img src="https://img.shields.io/badge/skills-7-10B981" alt="7 skills" />
+  <img src="https://img.shields.io/badge/skills-8-10B981" alt="8 skills" />
   <a href="https://verified-skill.com"><img src="https://img.shields.io/badge/registry-verified--skill.com-F59E0B" alt="registry" /></a>
   <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT" />
 </p>
@@ -124,7 +124,7 @@ Then invoke as `/plugin:skill` in your agent:
 | **mobile** | React Native, Expo, Flutter, SwiftUI, Jetpack Compose, app store | `appstore` |
 | **marketing** | Social media content creation, posting, and engagement across 11 platforms, plus Slack messaging | `social-media-posting` `slack-messaging` |
 | **google-workspace** | Google Workspace CLI (gws) for Drive, Sheets, Docs, Calendar, Chat, Admin | `gws` |
-| **skills** | Skill discovery and recommendations | `scout` |
+| **skills** | Skill discovery, recommendations, and authoring | `scout` `skill-builder` |
 | **productivity** | Expert network survey completion and paid expertise sharing | `survey-passing` |
 
 <br/>
@@ -166,6 +166,28 @@ vskill init                 Initialize vskill in a project
 
 <br/>
 
+## Skill Authoring
+
+Create and manage universal cross-tool skills with the `vskill skill` command family.
+The bundled `skill-builder` meta-skill drives the flow from inside any supported
+agent host (Claude Code, Cursor, Codex, Gemini CLI, etc.) with an automatic
+path A/B/C fallback chain.
+
+```bash
+vskill skill new --prompt "lint markdown" --targets=claude-code,codex
+vskill skill import ./existing-skill/SKILL.md
+vskill skill list
+vskill skill info skill-builder
+vskill skill publish skill-builder
+```
+
+Every emitted skill carries an `x-sw-schema-version: 1` marker on its frontmatter,
+and ships with a `<name>-divergence.md` report that documents any frontmatter
+fields dropped or translated per target (e.g. `allowed-tools` → OpenCode
+`permission.bash: ask`).
+
+<br/>
+
 ## Security Audit
 
 Scan entire projects for security issues — not just skills:

package/agents.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-04-24T16:11:28.626Z",
+  "generatedAt": "2026-04-24T19:22:02.720Z",
   "agentPrefixes": [
     ".adal",
     ".agent",

package/dist/agents/agents-registry.d.ts

@@ -30,8 +30,19 @@ export interface AgentDefinition {
     globalSkillsDir: string;
     /** Whether this agent supports the universal skill format */
     isUniversal: boolean;
-    /** Shell command to detect if the agent is installed */
-    detectInstalled: string;
+    /** Detect whether the agent is installed.
+     *
+     * 0706 T-002: historically this was a literal shell string (e.g. `'which
+     * claude'`) executed through `exec()`. That pipes through `cmd.exe` on
+     * Windows where `which`, `~`, `&&`, `2>/dev/null`, etc. don't exist, so
+     * detection returned empty on Windows. New preferred form is a function
+     * that returns a boolean (using `detectBinary()` + direct fs probes).
+     *
+     * The string form is retained as a legacy escape hatch so this change is
+     * non-breaking for any external consumer who built their own registry
+     * row with a shell string. `detectInstalledAgents()` handles both shapes.
+     */
+    detectInstalled: string | (() => Promise<boolean>);
     /** Parent company or organization */
     parentCompany: string;
     /** Feature support matrix */

package/dist/agents/agents-registry.js

@@ -7,6 +7,35 @@
  * Source of truth for the count: `TOTAL_AGENTS` (derived from AGENTS_REGISTRY.length).
  * The numbers in this header are documentation only; tests assert against TOTAL_AGENTS.
  */
+// 0706 T-002 / T-003: imports for function-based detectInstalled.
+// `detectBinary` is the platform-aware replacement for literal "which <bin>"
+// strings that fail on Windows cmd.exe.
+//
+// 0703 follow-up: node:fs / node:os / node:path / resolve-binary all pull
+// node-only APIs that vite refuses to bundle for the browser. The UI imports
+// AGENTS_REGISTRY purely for static data (ids, display names, feature
+// flags). Lazy-import every runtime probe so the UI bundle ignores them
+// while server callers pay a one-shot dynamic import inside `detectInstalled`.
+async function detectBinary(binary) {
+    const mod = await import("../utils/resolve-binary.js");
+    return mod.detectBinary(binary);
+}
+async function fsExistsAsync(path) {
+    const fs = await import("node:fs");
+    return fs.existsSync(path);
+}
+async function fsReaddirAsync(path) {
+    const fs = await import("node:fs");
+    return fs.readdirSync(path);
+}
+async function pathJoinAsync(...parts) {
+    const p = await import("node:path");
+    return p.join(...parts);
+}
+async function osHomedirAsync() {
+    const os = await import("node:os");
+    return os.homedir();
+}
 /** 0694 (AC-US1-04): Backward-compat alias map for renamed agent ids.
  *  Consumed by `getAgent()` so existing scripts/lockfiles continue to work
  *  after a rename. Keys are legacy ids, values are current canonical ids. */
@@ -31,7 +60,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.amp/skills',
         globalSkillsDir: '~/.config/agents/skills',
         isUniversal: true,
-        detectInstalled: 'which amp',
+        detectInstalled: () => detectBinary('amp'),
         parentCompany: 'Sourcegraph',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -41,7 +70,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.cline/skills',
         globalSkillsDir: '~/.cline/skills',
         isUniversal: true,
-        detectInstalled: 'which cline',
+        detectInstalled: () => detectBinary('cline'),
         parentCompany: 'Cline',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -51,7 +80,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.codex/skills',
         globalSkillsDir: '~/.codex/skills',
         isUniversal: true,
-        detectInstalled: 'which codex',
+        detectInstalled: () => detectBinary('codex'),
         parentCompany: 'OpenAI',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -61,7 +90,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.cursor/skills',
         globalSkillsDir: '~/.cursor/skills',
         isUniversal: true,
-        detectInstalled: 'which cursor',
+        detectInstalled: () => detectBinary('cursor'),
         parentCompany: 'Anysphere',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -71,7 +100,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.gemini/skills',
         globalSkillsDir: '~/.gemini/skills',
         isUniversal: true,
-        detectInstalled: 'which gemini',
+        detectInstalled: () => detectBinary('gemini'),
         parentCompany: 'Google',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -86,7 +115,25 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.github/copilot/skills',
         globalSkillsDir: '~/.config/github-copilot/skills',
         isUniversal: true,
-        detectInstalled: 'which code && ls ~/.vscode/extensions/github.copilot-* 2>/dev/null',
+        // 0706 T-003: pure-Node detection — the old shell pipe
+        // (`which code && ls ~/.vscode/extensions/github.copilot-* 2>/dev/null`)
+        // can't run on Windows cmd.exe (no `which`, no `~`, no `&&`, no
+        // `2>/dev/null`). Replace with a portable probe: VS Code on PATH AND
+        // at least one `github.copilot-*` dir under `~/.vscode/extensions`.
+        detectInstalled: async () => {
+            if (!(await detectBinary('code')))
+                return false;
+            const extDir = await pathJoinAsync(await osHomedirAsync(), '.vscode', 'extensions');
+            if (!(await fsExistsAsync(extDir)))
+                return false;
+            try {
+                const entries = await fsReaddirAsync(extDir);
+                return entries.some((e) => e.startsWith('github.copilot-'));
+            }
+            catch {
+                return false;
+            }
+        },
         parentCompany: 'GitHub (Microsoft)',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -96,7 +143,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.kimi/skills',
         globalSkillsDir: '~/.config/agents/skills',
         isUniversal: true,
-        detectInstalled: 'which kimi',
+        detectInstalled: () => detectBinary('kimi'),
         parentCompany: 'Moonshot AI',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -106,7 +153,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.opencode/skills',
         globalSkillsDir: '~/.config/opencode/skills',
         isUniversal: true,
-        detectInstalled: 'which opencode',
+        detectInstalled: () => detectBinary('opencode'),
         parentCompany: 'Community',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -119,7 +166,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.agent/skills',
         globalSkillsDir: '~/.gemini/antigravity/skills',
         isUniversal: false,
-        detectInstalled: 'which antigravity',
+        detectInstalled: () => detectBinary('antigravity'),
         parentCompany: 'Google',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -129,7 +176,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.augment/skills',
         globalSkillsDir: '~/.augment/skills',
         isUniversal: false,
-        detectInstalled: 'which augment',
+        detectInstalled: () => detectBinary('augment'),
         parentCompany: 'Augment',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -139,7 +186,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.claude/skills',
         globalSkillsDir: '~/.claude/skills',
         isUniversal: false,
-        detectInstalled: 'which claude',
+        detectInstalled: () => detectBinary('claude'),
         parentCompany: 'Anthropic',
         featureSupport: { slashCommands: true, hooks: true, mcp: true, customSystemPrompt: true },
         pluginCacheDir: '~/.claude/plugins/cache',
@@ -151,7 +198,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.openclaw/skills',
         globalSkillsDir: '~/.openclaw/skills',
         isUniversal: false,
-        detectInstalled: 'which openclaw',
+        detectInstalled: () => detectBinary('openclaw'),
         parentCompany: 'Community',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -161,7 +208,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.replit/skills',
         globalSkillsDir: '~/.config/agents/skills',
         isUniversal: false,
-        detectInstalled: 'which replit',
+        detectInstalled: () => detectBinary('replit'),
         parentCompany: 'Replit',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
         isRemoteOnly: true,
@@ -172,7 +219,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.codebuddy/skills',
         globalSkillsDir: '~/.codebuddy/skills',
         isUniversal: false,
-        detectInstalled: 'which codebuddy',
+        detectInstalled: () => detectBinary('codebuddy'),
         parentCompany: 'CodeBuddy',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -182,7 +229,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.commandcode/skills',
         globalSkillsDir: '~/.commandcode/skills',
         isUniversal: false,
-        detectInstalled: 'which command-code',
+        detectInstalled: () => detectBinary('command-code'),
         parentCompany: 'Command',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -192,7 +239,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.continue/skills',
         globalSkillsDir: '~/.continue/skills',
         isUniversal: false,
-        detectInstalled: 'which continue',
+        detectInstalled: () => detectBinary('continue'),
         parentCompany: 'Continue',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -202,7 +249,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.crush/skills',
         globalSkillsDir: '~/.config/crush/skills',
         isUniversal: false,
-        detectInstalled: 'which crush',
+        detectInstalled: () => detectBinary('crush'),
         parentCompany: 'Crush',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -212,7 +259,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.factory/skills',
         globalSkillsDir: '~/.factory/skills',
         isUniversal: false,
-        detectInstalled: 'which droid',
+        detectInstalled: () => detectBinary('droid'),
         parentCompany: 'Factory',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -222,7 +269,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.goose/skills',
         globalSkillsDir: '~/.config/goose/skills',
         isUniversal: false,
-        detectInstalled: 'which goose',
+        detectInstalled: () => detectBinary('goose'),
         parentCompany: 'Block',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -232,7 +279,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.junie/skills',
         globalSkillsDir: '~/.junie/skills',
         isUniversal: false,
-        detectInstalled: 'which junie',
+        detectInstalled: () => detectBinary('junie'),
         parentCompany: 'JetBrains',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -242,7 +289,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.iflow/skills',
         globalSkillsDir: '~/.iflow/skills',
         isUniversal: false,
-        detectInstalled: 'which iflow',
+        detectInstalled: () => detectBinary('iflow'),
         parentCompany: 'iFlow',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -252,7 +299,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.kilocode/skills',
         globalSkillsDir: '~/.kilocode/skills',
         isUniversal: false,
-        detectInstalled: 'which kilocode',
+        detectInstalled: () => detectBinary('kilocode'),
         parentCompany: 'Kilo Code',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -262,7 +309,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.kiro/skills',
         globalSkillsDir: '~/.kiro/skills',
         isUniversal: false,
-        detectInstalled: 'which kiro',
+        detectInstalled: () => detectBinary('kiro'),
         parentCompany: 'AWS',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -272,7 +319,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.kode/skills',
         globalSkillsDir: '~/.kode/skills',
         isUniversal: false,
-        detectInstalled: 'which kode',
+        detectInstalled: () => detectBinary('kode'),
         parentCompany: 'Kode',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -282,7 +329,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.mcpjam/skills',
         globalSkillsDir: '~/.mcpjam/skills',
         isUniversal: false,
-        detectInstalled: 'which mcpjam',
+        detectInstalled: () => detectBinary('mcpjam'),
         parentCompany: 'MCPJam',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: false },
     },
@@ -292,7 +339,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.vibe/skills',
         globalSkillsDir: '~/.vibe/skills',
         isUniversal: false,
-        detectInstalled: 'which vibe',
+        detectInstalled: () => detectBinary('vibe'),
         parentCompany: 'Mistral AI',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -302,7 +349,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.mux/skills',
         globalSkillsDir: '~/.mux/skills',
         isUniversal: false,
-        detectInstalled: 'which mux',
+        detectInstalled: () => detectBinary('mux'),
         parentCompany: 'Mux',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -312,7 +359,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.openhands/skills',
         globalSkillsDir: '~/.openhands/skills',
         isUniversal: false,
-        detectInstalled: 'which openhands',
+        detectInstalled: () => detectBinary('openhands'),
         parentCompany: 'All Hands AI',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -322,7 +369,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.pi/skills',
         globalSkillsDir: '~/.pi/agent/skills',
         isUniversal: false,
-        detectInstalled: 'which pi',
+        detectInstalled: () => detectBinary('pi'),
         parentCompany: 'Pi',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -332,7 +379,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.qoder/skills',
         globalSkillsDir: '~/.qoder/skills',
         isUniversal: false,
-        detectInstalled: 'which qoder',
+        detectInstalled: () => detectBinary('qoder'),
         parentCompany: 'Qoder',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -342,7 +389,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.qwen/skills',
         globalSkillsDir: '~/.qwen/skills',
         isUniversal: false,
-        detectInstalled: 'which qwen-code',
+        detectInstalled: () => detectBinary('qwen-code'),
         parentCompany: 'Alibaba',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -352,7 +399,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.roo/skills',
         globalSkillsDir: '~/.roo/skills',
         isUniversal: false,
-        detectInstalled: 'which roo',
+        detectInstalled: () => detectBinary('roo'),
         parentCompany: 'Roo',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -362,7 +409,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.trae/skills',
         globalSkillsDir: '~/.trae/skills',
         isUniversal: false,
-        detectInstalled: 'which trae',
+        detectInstalled: () => detectBinary('trae'),
         parentCompany: 'ByteDance',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -372,7 +419,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.trae-cn/skills',
         globalSkillsDir: '~/.trae-cn/skills',
         isUniversal: false,
-        detectInstalled: 'which trae-cn',
+        detectInstalled: () => detectBinary('trae-cn'),
         parentCompany: 'ByteDance',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -382,7 +429,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.windsurf/skills',
         globalSkillsDir: '~/.codeium/windsurf/skills',
         isUniversal: false,
-        detectInstalled: 'which windsurf',
+        detectInstalled: () => detectBinary('windsurf'),
         parentCompany: 'Codeium',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -392,7 +439,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.zencoder/skills',
         globalSkillsDir: '~/.zencoder/skills',
         isUniversal: false,
-        detectInstalled: 'which zencoder',
+        detectInstalled: () => detectBinary('zencoder'),
         parentCompany: 'ZenCoder',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -402,7 +449,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.neovate/skills',
         globalSkillsDir: '~/.neovate/skills',
         isUniversal: false,
-        detectInstalled: 'which neovate',
+        detectInstalled: () => detectBinary('neovate'),
         parentCompany: 'Neovate',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -412,7 +459,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.pochi/skills',
         globalSkillsDir: '~/.pochi/skills',
         isUniversal: false,
-        detectInstalled: 'which pochi',
+        detectInstalled: () => detectBinary('pochi'),
         parentCompany: 'Pochi',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -422,7 +469,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.adal/skills',
         globalSkillsDir: '~/.adal/skills',
         isUniversal: false,
-        detectInstalled: 'which adal',
+        detectInstalled: () => detectBinary('adal'),
         parentCompany: 'Adal',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -432,7 +479,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.cortex/skills',
         globalSkillsDir: '~/.snowflake/cortex/skills',
         isUniversal: false,
-        detectInstalled: 'which cortex',
+        detectInstalled: () => detectBinary('cortex'),
         parentCompany: 'Cortex',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -442,7 +489,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.aider/skills',
         globalSkillsDir: '~/.aider/skills',
         isUniversal: false,
-        detectInstalled: 'which aider',
+        detectInstalled: () => detectBinary('aider'),
         parentCompany: 'Aider',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -452,7 +499,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.tabnine/skills',
         globalSkillsDir: '~/.tabnine/skills',
         isUniversal: false,
-        detectInstalled: 'which tabnine',
+        detectInstalled: () => detectBinary('tabnine'),
         parentCompany: 'Tabnine',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -465,7 +512,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.devin/skills',
         globalSkillsDir: '~/.devin/skills',
         isUniversal: false,
-        detectInstalled: 'which devin',
+        detectInstalled: () => detectBinary('devin'),
         parentCompany: 'Cognition',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
         isRemoteOnly: true,
@@ -477,7 +524,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.bolt/skills',
         globalSkillsDir: '~/.bolt/skills',
         isUniversal: false,
-        detectInstalled: 'which bolt',
+        detectInstalled: () => detectBinary('bolt'),
         parentCompany: 'StackBlitz',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
         isRemoteOnly: true,
@@ -489,7 +536,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.v0/skills',
         globalSkillsDir: '~/.v0/skills',
         isUniversal: false,
-        detectInstalled: 'which v0',
+        detectInstalled: () => detectBinary('v0'),
         parentCompany: 'Vercel',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
         isRemoteOnly: true,
@@ -500,7 +547,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.gpt-pilot/skills',
         globalSkillsDir: '~/.gpt-pilot/skills',
         isUniversal: false,
-        detectInstalled: 'which gpt-pilot',
+        detectInstalled: () => detectBinary('gpt-pilot'),
         parentCompany: 'Pythagora',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -510,7 +557,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.plandex/skills',
         globalSkillsDir: '~/.plandex/skills',
         isUniversal: false,
-        detectInstalled: 'which plandex',
+        detectInstalled: () => detectBinary('plandex'),
         parentCompany: 'Plandex',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -520,7 +567,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.sweep/skills',
         globalSkillsDir: '~/.sweep/skills',
         isUniversal: false,
-        detectInstalled: 'which sweep',
+        detectInstalled: () => detectBinary('sweep'),
         parentCompany: 'Sweep AI',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -530,7 +577,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.mentat/skills',
         globalSkillsDir: '~/.mentat/skills',
         isUniversal: false,
-        detectInstalled: 'which mentat',
+        detectInstalled: () => detectBinary('mentat'),
         parentCompany: 'AbanteAI',
         featureSupport: { slashCommands: false, hooks: false, mcp: false, customSystemPrompt: true },
     },
@@ -545,7 +592,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.copilot/skills',
         globalSkillsDir: '~/.copilot/skills',
         isUniversal: false,
-        detectInstalled: 'which copilot',
+        detectInstalled: () => detectBinary('copilot'),
         parentCompany: 'GitHub (Microsoft)',
         featureSupport: { slashCommands: true, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -559,7 +606,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.warp/skills',
         globalSkillsDir: '~/.warp/skills',
         isUniversal: false,
-        detectInstalled: 'which warp',
+        detectInstalled: () => detectBinary('warp'),
         parentCompany: 'Warp',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -573,7 +620,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.amazonq/skills',
         globalSkillsDir: '~/.aws/amazonq/skills',
         isUniversal: false,
-        detectInstalled: 'which q',
+        detectInstalled: () => detectBinary('q'),
         parentCompany: 'AWS',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -588,7 +635,7 @@ export const AGENTS_REGISTRY = [
         localSkillsDir: '.zed/skills',
         globalSkillsDir: '~/.config/zed/skills',
         isUniversal: false,
-        detectInstalled: 'which zed',
+        detectInstalled: () => detectBinary('zed'),
         parentCompany: 'Zed Industries',
         featureSupport: { slashCommands: false, hooks: false, mcp: true, customSystemPrompt: true },
     },
@@ -739,11 +786,27 @@ export async function detectInstalledAgents() {
         // so the Tier 2 directory fallback would false-positive without this guard.
         if (agent.isRemoteOnly === true)
             return;
-        // Tier 1: CLI binary detection
+        // Tier 1: CLI binary detection.
+        //
+        // 0706 T-002: `detectInstalled` can be a legacy shell string (e.g.
+        // `'which claude'`) OR a function returning `Promise<boolean>`. Strings
+        // still go through exec (kept for backward compat with any external
+        // consumer that built rows the old way); functions are called directly
+        // — they own their own platform branching via `detectBinary()`.
         try {
-            await execAsync(agent.detectInstalled);
-            results.push(agent);
-            return;
+            const detector = agent.detectInstalled;
+            if (typeof detector === 'function') {
+                const ok = await detector();
+                if (ok) {
+                    results.push(agent);
+                    return;
+                }
+            }
+            else {
+                await execAsync(detector);
+                results.push(agent);
+                return;
+            }
         }
         catch {
             // Binary not found — try directory fallback