agent-skills-standard 2.3.0 → 2.4.1

package/dist/index.js

@@ -268,7 +268,7 @@ var Agent = /* @__PURE__ */ function(Agent) {
 	Agent["Claude"] = "claude";
 	Agent["Copilot"] = "copilot";
 	Agent["Antigravity"] = "antigravity";
-	Agent["OpenAI"] = "openai";
+	Agent["Codex"] = "codex";
 	Agent["OpenCode"] = "opencode";
 	Agent["Gemini"] = "gemini";
 	Agent["Roo"] = "roo";
@@ -671,13 +671,24 @@ function getFrameworkType(framework) {
 }
 var DEFAULT_REGISTER = "https://github.com/HoangNguyen0403/agent-skills-standard";
 var DEFAULT_WORKFLOWS = [
+	"sdlc",
+	"brainstorm-feature",
 	"code-review",
 	"codebase-review",
+	"design-solution",
+	"deploy-release",
 	"plan-feature",
+	"implementation-readiness",
+	"review-ticket",
+	"traceability-audit",
+	"session-report",
+	"publish-notes",
+	"retro-learn",
 	"skill-benchmark",
 	"pentest",
 	"dev-fix",
 	"implement-feature",
+	"verify-work",
 	"verify-bug"
 ];
 var getAgentDefinition = (id) => {
@@ -692,7 +703,9 @@ var getAgentDefinition = (id) => {
 			detectionFiles: [".cursor", ".cursorrules"],
 			workflowFormat: "skill",
 			workflowPath: ".cursor/skills",
-			agentPath: ".cursor/agents"
+			agentPath: ".cursor/agents",
+			hookScriptPath: ".cursor/hooks/preedit-skill-loader.js",
+			hookConfigPath: ".cursor/hooks.json"
 		};
 		case Agent.Trae: return {
 			id,
@@ -716,7 +729,9 @@ var getAgentDefinition = (id) => {
 			detectionFiles: [".claude"],
 			workflowFormat: "command",
 			workflowPath: ".claude/commands",
-			agentPath: ".claude/agents"
+			agentPath: ".claude/agents",
+			hookScriptPath: ".claude/hooks/preedit-skill-loader.js",
+			hookConfigPath: ".claude/settings.json"
 		};
 		case Agent.Copilot: return {
 			id,
@@ -728,7 +743,9 @@ var getAgentDefinition = (id) => {
 			detectionFiles: [".github"],
 			workflowFormat: "prompt",
 			workflowPath: ".github/prompts",
-			agentPath: ".github/copilot-agents"
+			agentPath: ".github/copilot-agents",
+			hookScriptPath: ".github/hooks/preedit-skill-loader.js",
+			hookConfigPath: ".github/hooks.json"
 		};
 		case Agent.Antigravity: return {
 			id,
@@ -741,9 +758,9 @@ var getAgentDefinition = (id) => {
 			workflowFormat: "native",
 			workflowPath: ".agents/workflows"
 		};
-		case Agent.OpenAI: return {
+		case Agent.Codex: return {
 			id,
-			name: "OpenAI",
+			name: "Codex",
 			path: ".codex/skills",
 			ruleFile: ".codex/rules",
 			ruleExtension: ".md",
@@ -751,7 +768,9 @@ var getAgentDefinition = (id) => {
 			detectionFiles: [".codex"],
 			workflowFormat: "skill",
 			workflowPath: ".codex/skills",
-			agentPath: ".codex/agents"
+			agentPath: ".codex/agents",
+			hookScriptPath: ".codex/hooks/preedit-skill-loader.js",
+			hookConfigPath: ".codex/hooks.json"
 		};
 		case Agent.OpenCode: return {
 			id,
@@ -775,7 +794,9 @@ var getAgentDefinition = (id) => {
 			detectionFiles: [".gemini"],
 			workflowFormat: "toml",
 			workflowPath: ".gemini/commands",
-			agentPath: ".gemini/agents"
+			agentPath: ".gemini/agents",
+			hookScriptPath: ".gemini/hooks/preedit-skill-loader.js",
+			hookConfigPath: ".gemini/hooks.json"
 		};
 		case Agent.Roo: return {
 			id,
@@ -797,7 +818,9 @@ var getAgentDefinition = (id) => {
 			frontmatterStyle: "cursor",
 			detectionFiles: [".windsurf"],
 			workflowFormat: "none",
-			workflowPath: ""
+			workflowPath: "",
+			hookScriptPath: ".windsurf/hooks/preedit-skill-loader.js",
+			hookConfigPath: ".windsurf/hooks.json"
 		};
 		case Agent.Kiro: return {
 			id,
@@ -809,7 +832,8 @@ var getAgentDefinition = (id) => {
 			detectionFiles: [".kiro"],
 			workflowFormat: "native",
 			workflowPath: ".agents/workflows",
-			agentPath: ".kiro/agents"
+			agentPath: ".kiro/agents",
+			hookScriptPath: ".kiro/hooks/ags-skill-loader.md"
 		};
 	}
 };
@@ -949,7 +973,10 @@ var McpConfigSchema = zod.z.object({
 });
 var SkillConfigSchema = zod.z.object({
 	registry: zod.z.string().url(),
-	agents: zod.z.array(zod.z.nativeEnum(Agent)).optional(),
+	agents: zod.z.preprocess((val) => {
+		if (Array.isArray(val)) return val.map((a) => typeof a === "string" && a.toLowerCase() === "openai" ? "codex" : a);
+		return val;
+	}, zod.z.array(zod.z.nativeEnum(Agent)).optional()),
 	skills: zod.z.record(zod.z.string(), zod.z.object({
 		ref: zod.z.string().optional(),
 		include: zod.z.array(zod.z.string()).optional(),
@@ -959,11 +986,17 @@ var SkillConfigSchema = zod.z.object({
 	workflows: zod.z.union([zod.z.boolean(), zod.z.array(zod.z.string())]).optional(),
 	mcp: McpConfigSchema.optional()
 });
+var DEFAULT_SDLC_SUPPORT_CATEGORIES = ["quality-engineering"];
 /**
 * Service for managing the `.skillsrc` configuration file.
 * Handles loading, saving, and initial construction of the configuration based on project metadata.
 */
 var ConfigService = class {
+	getCategoryRef(category, metadata) {
+		const categoryMetadata = metadata.categories?.[category];
+		if (!categoryMetadata?.version) return "main";
+		return `${categoryMetadata.tag_prefix || ""}${categoryMetadata.version}`;
+	}
 	/**
 	* Loads and validates the skill configuration from the workspace.
 	* @param cwd Current working directory
@@ -976,6 +1009,20 @@ var ConfigService = class {
 		try {
 			const content = await fs_extra.default.readFile(configPath, "utf8");
 			const rawConfig = js_yaml.default.load(content);
+			if (rawConfig && Array.isArray(rawConfig.agents)) {
+				let needsMigration = false;
+				const updatedAgents = rawConfig.agents.map((agent) => {
+					if (typeof agent === "string" && agent.toLowerCase() === "openai") {
+						needsMigration = true;
+						return Agent.Codex;
+					}
+					return agent;
+				});
+				if (needsMigration) {
+					rawConfig.agents = updatedAgents;
+					await fs_extra.default.outputFile(configPath, js_yaml.default.dump(rawConfig));
+				}
+			}
 			const parsed = SkillConfigSchema.safeParse(rawConfig);
 			if (!parsed.success) throw new Error(`Invalid .skillsrc format: ${parsed.error.message}`);
 			return parsed.data;
@@ -1015,6 +1062,7 @@ var ConfigService = class {
 				...commonExcludes.length > 0 && { exclude: commonExcludes }
 			};
 		}
+		for (const category of DEFAULT_SDLC_SUPPORT_CATEGORIES) if (metadata.categories?.[category] && !skills[category]) skills[category] = { ref: this.getCategoryRef(category, metadata) };
 		if (BACKEND_FRAMEWORKS.includes(framework) && metadata.categories?.["database"]) skills["database"] = { ref: metadata.categories["database"].version ? `${metadata.categories["database"].tag_prefix || ""}${metadata.categories["database"].version}` : "main" };
 		return {
 			registry,
@@ -1124,84 +1172,75 @@ var ConfigService = class {
 //#endregion
 //#region src/services/HookService.ts
 /**
-* Claude Code PreToolUse hook script (Python).
-* Fires before every Edit/Write — emits a load_skills_for_files() reminder as
-* prompt context so Claude always consults skill rules before editing.
-* Always exits 0 — never blocks tool execution.
+* Universal PreToolUse hook script (Node.js / JavaScript).
+* Reminds AI agents to call load_skills_for_files() before any code edit.
+* Guaranteed to execute on any machine running agent-skills-standard.
+* Always exits 0 to never block work.
 */
-var CLAUDE_SKILL_LOADER_PY = `#!/usr/bin/env python3
-"""PreToolUse hook: remind Claude to call load_skills_for_files() before any code edit.
-
-Installed by agent-skills-standard (ags sync). Remove via: ags hooks uninstall
-
-Why a hook (not just AGENTS.md or the MCP alone):
-    Context compaction silently drops the check-AGENTS.md instruction.
-    The MCP is on-demand - Claude must remember to call it.
-    A hook fires mechanically on every edit - 100% trigger rate, cannot be forgotten.
-
-Decision contract:
-    - stdout: short MCP trigger prompt (injected as prompt context)
-    - exit 0 always - never blocks the edit, only adds context
-    - Silent on any error - hook bugs must never block legitimate work
-"""
-from __future__ import annotations
-
-import json
-import os
-import sys
-from pathlib import Path
-
-REPO_ROOT = Path(os.environ.get("CLAUDE_PROJECT_DIR") or Path(__file__).resolve().parents[2])
-
-EDIT_TOOLS = {"Edit", "Write", "MultiEdit", "NotebookEdit"}
-
-_SKIP_DIRS = (
-    str(Path(os.path.realpath(REPO_ROOT / ".claude"))),
-    str(Path(os.path.realpath(REPO_ROOT / ".gemini"))),
-)
-_SKIP_FILES = (
-    str(Path(os.path.realpath(REPO_ROOT / "AGENTS.md"))),
-    str(Path(os.path.realpath(REPO_ROOT / "CLAUDE.md"))),
-)
-
-
-def _should_skip(file_path: str) -> bool:
-    try:
-        real = str(Path(os.path.realpath(file_path)))
-    except Exception:
-        return False
-    if any(real.startswith(d) for d in _SKIP_DIRS):
-        return True
-    if real in _SKIP_FILES:
-        return True
-    return False
-
-
-def main() -> None:
-    try:
-        data = json.load(sys.stdin)
-    except Exception:
-        sys.exit(0)
-
-    if data.get("tool_name") not in EDIT_TOOLS:
-        sys.exit(0)
+var UNIVERSAL_SKILL_LOADER_JS = `#!/usr/bin/env node
+/**
+ * PreToolUse hook: remind AI agent to call load_skills_for_files() before any code edit.
+ * Installed by agent-skills-standard (ags sync). Remove via: ags hooks uninstall
+ * Guaranteed to execute on any system with Node.js. Always exits 0 to never block work.
+ */
+const fs = require('fs');
+const path = require('path');
 
-    file_path = data.get("tool_input", {}).get("file_path", "")
-    if not file_path or _should_skip(file_path):
-        sys.exit(0)
+const REPO_ROOT = process.env.CLAUDE_PROJECT_DIR || path.resolve(__dirname, '../../');
+const EDIT_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+const SKIP_DIRS = [
+  path.resolve(REPO_ROOT, '.claude'),
+  path.resolve(REPO_ROOT, '.gemini'),
+  path.resolve(REPO_ROOT, '.codex'),
+  path.resolve(REPO_ROOT, '.github'),
+  path.resolve(REPO_ROOT, '.cursor'),
+  path.resolve(REPO_ROOT, '.roo'),
+  path.resolve(REPO_ROOT, '.trae'),
+  path.resolve(REPO_ROOT, '.opencode'),
+  path.resolve(REPO_ROOT, '.kiro'),
+  path.resolve(REPO_ROOT, '.windsurf'),
+  path.resolve(REPO_ROOT, '.agents'),
+  path.resolve(REPO_ROOT, '.vscode'),
+];
+const SKIP_FILES = [
+  path.resolve(REPO_ROOT, 'AGENTS.md'),
+  path.resolve(REPO_ROOT, 'CLAUDE.md'),
+];
 
-    print(
-        f"[SKILL TRIGGER] Editing: {Path(file_path).name}\\n"
-        f"-> Call load_skills_for_files(files=[ \\"{file_path}\\" ]) on the "
-        f"agent-skills-standard MCP. It returns applicable SKILL.md rules, "
-        f"or nothing if no skills match this file type."
-    )
+function shouldSkip(filePath) {
+  try {
+    const real = path.resolve(filePath);
+    if (SKIP_DIRS.some(d => real.startsWith(d))) return true;
+    if (SKIP_FILES.includes(real)) return true;
+    return false;
+  } catch {
+    return false;
+  }
+}
 
-    sys.exit(0)
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => { input += chunk; });
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    if (!EDIT_TOOLS.has(data.tool_name)) process.exit(0);
 
+    const filePath = data.tool_input?.file_path || '';
+    if (!filePath || shouldSkip(filePath)) process.exit(0);
 
-if __name__ == "__main__":
-    main()
+    const fileName = path.basename(filePath);
+    console.log(
+      '[SKILL TRIGGER] Editing: ' + fileName + '\\n' +
+      '-> Call load_skills_for_files(files=[ "' + filePath + '" ]) on the ' +
+      'agent-skills-standard MCP. It returns applicable SKILL.md rules, ' +
+      'or nothing if no skills match this file type.'
+    );
+    process.exit(0);
+  } catch {
+    process.exit(0);
+  }
+});
 `;
 /**
 * Kiro hook spec (Markdown + YAML frontmatter).
@@ -1221,9 +1260,6 @@ instructions: |
   file being edited, or nothing if no skills match. Apply all returned rules strictly.
 ---
 `;
-var CLAUDE_HOOK_SCRIPT_REL = ".claude/hooks/preedit-skill-loader.py";
-var CLAUDE_SETTINGS_REL = ".claude/settings.json";
-var CLAUDE_HOOK_CMD = "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/preedit-skill-loader.py\"";
 var CLAUDE_MCP_PERMISSION = "mcp__agent-skills-standard__*";
 var KIRO_HOOK_REL = ".kiro/hooks/ags-skill-loader.md";
 /**
@@ -1231,6 +1267,11 @@ var KIRO_HOOK_REL = ".kiro/hooks/ags-skill-loader.md";
 *
 * Supported hook systems:
 *   Claude Code — PreToolUse hook (blocking-capable, fires before every Edit/Write)
+*   Cursor      — PreToolUse hook
+*   Windsurf    — PreToolUse hook
+*   Gemini      — PreToolUse hook
+*   Codex       — PreToolUse hook
+*   Copilot     — PreToolUse hook
 *   Kiro        — File-save spec hook (advisory, cannot block edits)
 *
 * All other agents in the supported-agents list have no programmatic hook system;
@@ -1247,29 +1288,28 @@ var HookService = class {
 			writes: [],
 			unsupported: []
 		};
-		for (const agent of opts.agents) switch (agent) {
-			case Agent.Claude:
-				await this.installClaudeHook(opts.rootDir, report);
-				break;
-			case Agent.Kiro:
+		for (const agent of opts.agents) {
+			if (agent === Agent.Kiro) {
 				await this.installKiroHook(opts.rootDir, report);
-				break;
-			default: report.unsupported.push(agent);
+				continue;
+			}
+			const def = getAgentDefinition(agent);
+			if (def.hookScriptPath && def.hookConfigPath) await this.installStandardHookConfig({
+				rootDir: opts.rootDir,
+				agent,
+				scriptRelPath: def.hookScriptPath,
+				configRelPath: def.hookConfigPath,
+				hookCmd: agent === Agent.Claude ? "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/preedit-skill-loader.js\"" : `node "${def.hookScriptPath}"`,
+				report
+			});
+			else report.unsupported.push(agent);
 		}
 		return report;
 	}
 	async uninstall(opts) {
 		const removed = [];
-		for (const agent of opts.agents) switch (agent) {
-			case Agent.Claude: {
-				const files = await this.uninstallClaudeHook(opts.rootDir);
-				removed.push(...files.map((f) => ({
-					agent,
-					file: f
-				})));
-				break;
-			}
-			case Agent.Kiro: {
+		for (const agent of opts.agents) {
+			if (agent === Agent.Kiro) {
 				const abs = path.default.join(opts.rootDir, KIRO_HOOK_REL);
 				if (await fs_extra.default.pathExists(abs)) {
 					await fs_extra.default.remove(abs);
@@ -1278,57 +1318,57 @@ var HookService = class {
 						file: KIRO_HOOK_REL
 					});
 				}
-				break;
+				continue;
+			}
+			const def = getAgentDefinition(agent);
+			if (def.hookConfigPath) {
+				const files = await this.uninstallStandardHookConfig(opts.rootDir, def.hookConfigPath);
+				removed.push(...files.map((f) => ({
+					agent,
+					file: f
+				})));
 			}
-			default: break;
 		}
 		return { removed };
 	}
 	async status(opts) {
 		const rows = [];
-		for (const agent of opts.agents) switch (agent) {
-			case Agent.Claude: {
-				const scriptExists = await fs_extra.default.pathExists(path.default.join(opts.rootDir, CLAUDE_HOOK_SCRIPT_REL));
-				const registeredInSettings = await this.claudeHookIsRegistered(path.default.join(opts.rootDir, CLAUDE_SETTINGS_REL));
-				rows.push({
-					agent,
-					installed: scriptExists && registeredInSettings,
-					files: [CLAUDE_HOOK_SCRIPT_REL, CLAUDE_SETTINGS_REL]
-				});
-				break;
-			}
-			case Agent.Kiro: {
+		for (const agent of opts.agents) {
+			if (agent === Agent.Kiro) {
 				const exists = await fs_extra.default.pathExists(path.default.join(opts.rootDir, KIRO_HOOK_REL));
 				rows.push({
 					agent,
 					installed: exists,
 					files: [KIRO_HOOK_REL]
 				});
-				break;
+				continue;
 			}
-			default: break;
+			const def = getAgentDefinition(agent);
+			if (def.hookScriptPath && def.hookConfigPath) rows.push(await this.standardHookStatus(opts.rootDir, agent, def.hookScriptPath, def.hookConfigPath));
 		}
 		return rows;
 	}
-	async installClaudeHook(rootDir, report) {
-		const scriptAbs = path.default.join(rootDir, CLAUDE_HOOK_SCRIPT_REL);
+	async installStandardHookConfig(opts) {
+		const scriptAbs = path.default.join(opts.rootDir, opts.scriptRelPath);
 		const scriptExists = await fs_extra.default.pathExists(scriptAbs);
 		await fs_extra.default.ensureDir(path.default.dirname(scriptAbs));
+		const legacyPyAbs = scriptAbs.replace(/\.js$/, ".py");
+		if (await fs_extra.default.pathExists(legacyPyAbs)) await fs_extra.default.remove(legacyPyAbs).catch(() => {});
 		if (!scriptExists) {
-			await fs_extra.default.writeFile(scriptAbs, CLAUDE_SKILL_LOADER_PY);
-			report.writes.push({
-				agent: Agent.Claude,
-				file: CLAUDE_HOOK_SCRIPT_REL,
+			await fs_extra.default.writeFile(scriptAbs, UNIVERSAL_SKILL_LOADER_JS);
+			opts.report.writes.push({
+				agent: opts.agent,
+				file: opts.scriptRelPath,
 				action: "added"
 			});
-		} else report.writes.push({
-			agent: Agent.Claude,
-			file: CLAUDE_HOOK_SCRIPT_REL,
+		} else opts.report.writes.push({
+			agent: opts.agent,
+			file: opts.scriptRelPath,
 			action: "skipped-existing"
 		});
-		const settingsAbs = path.default.join(rootDir, CLAUDE_SETTINGS_REL);
-		const settingsExists = await fs_extra.default.pathExists(settingsAbs);
-		const existing = await this.readJson(settingsAbs);
+		const configAbs = path.default.join(opts.rootDir, opts.configRelPath);
+		const configExists = await fs_extra.default.pathExists(configAbs);
+		const existing = await this.readJson(configAbs);
 		let changed = false;
 		const permissions = this.ensureObject(existing, "permissions");
 		const allow = this.ensureArray(permissions, "allow");
@@ -1343,30 +1383,30 @@ var HookService = class {
 				matcher: "Edit|Write|MultiEdit|NotebookEdit",
 				hooks: [{
 					type: "command",
-					command: CLAUDE_HOOK_CMD,
+					command: opts.hookCmd,
 					timeout: 5
 				}]
 			});
 			changed = true;
 		}
 		if (changed) {
-			await this.writeAtomic(settingsAbs, existing);
-			report.writes.push({
-				agent: Agent.Claude,
-				file: CLAUDE_SETTINGS_REL,
-				action: settingsExists ? "updated" : "added"
+			await this.writeAtomic(configAbs, existing);
+			opts.report.writes.push({
+				agent: opts.agent,
+				file: opts.configRelPath,
+				action: configExists ? "updated" : "added"
 			});
-		} else report.writes.push({
-			agent: Agent.Claude,
-			file: CLAUDE_SETTINGS_REL,
+		} else opts.report.writes.push({
+			agent: opts.agent,
+			file: opts.configRelPath,
 			action: "skipped-existing"
 		});
 	}
-	async uninstallClaudeHook(rootDir) {
+	async uninstallStandardHookConfig(rootDir, configRelPath) {
 		const removed = [];
-		const settingsAbs = path.default.join(rootDir, CLAUDE_SETTINGS_REL);
-		if (!await fs_extra.default.pathExists(settingsAbs)) return removed;
-		const data = await this.readJson(settingsAbs);
+		const configAbs = path.default.join(rootDir, configRelPath);
+		if (!await fs_extra.default.pathExists(configAbs)) return removed;
+		const data = await this.readJson(configAbs);
 		let changed = false;
 		const permissions = this.ensureObject(data, "permissions");
 		const allow = this.ensureArray(permissions, "allow");
@@ -1382,11 +1422,20 @@ var HookService = class {
 			changed = true;
 		}
 		if (changed) {
-			await this.writeAtomic(settingsAbs, data);
-			removed.push(CLAUDE_SETTINGS_REL);
+			await this.writeAtomic(configAbs, data);
+			removed.push(configRelPath);
 		}
 		return removed;
 	}
+	async standardHookStatus(rootDir, agent, scriptRelPath, configRelPath) {
+		const scriptExists = await fs_extra.default.pathExists(path.default.join(rootDir, scriptRelPath));
+		const registeredInSettings = await this.claudeHookIsRegistered(path.default.join(rootDir, configRelPath));
+		return {
+			agent,
+			installed: scriptExists && registeredInSettings,
+			files: [scriptRelPath, configRelPath]
+		};
+	}
 	async claudeHookIsRegistered(settingsAbs) {
 		if (!await fs_extra.default.pathExists(settingsAbs)) return false;
 		const hooks = (await this.readJson(settingsAbs))["hooks"];
@@ -1794,9 +1843,8 @@ var InitService = class {
 #
 # Run 'ags list-skills' to view all available skills.
 #
-# TIP: For Jira/Zephyr automation and requirement analysis, manually add:
-# skills:
-#   quality-engineering: { ref: quality-engineering-v1.0.0 }
+# SDLC support skills such as quality-engineering are included by default.
+# Specialist definitions are synced separately as native sub-agents, not skills.
 #
 `;
 		const configPath = path.default.join(cwd, ".skillsrc");
@@ -2292,27 +2340,27 @@ var getTargets = (home = os.default.homedir()) => {
 		},
 		[Agent.Copilot]: {
 			agent: Agent.Copilot,
-			projectFile: ".vscode/mcp.json",
+			projectFile: ".github/mcp.json",
 			userFile: (() => {
 				if (process.platform === "darwin") return path.default.join(HOME, "Library", "Application Support", "Code", "User", "globalStorage", "github.copilot-chat", "mcp.json");
 				if (process.platform === "win32") return path.default.join(HOME, "AppData", "Roaming", "Code", "User", "globalStorage", "github.copilot-chat", "mcp.json");
 				if (process.platform === "linux") return path.default.join(HOME, ".config", "Code", "User", "globalStorage", "github.copilot-chat", "mcp.json");
 				return null;
 			})(),
-			key: "servers",
+			key: "mcpServers",
 			shape: "map"
 		},
 		[Agent.OpenCode]: {
 			agent: Agent.OpenCode,
-			projectFile: "opencode.json",
-			userFile: path.default.join(HOME, ".config", "opencode", "opencode.json"),
-			key: "mcp",
+			projectFile: ".opencode/mcp_config.json",
+			userFile: path.default.join(HOME, ".opencode", "mcp_config.json"),
+			key: "mcpServers",
 			shape: "map"
 		},
-		[Agent.OpenAI]: {
-			agent: Agent.OpenAI,
-			projectFile: ".codex/hooks.json",
-			userFile: path.default.join(HOME, ".codex", "hooks.json"),
+		[Agent.Codex]: {
+			agent: Agent.Codex,
+			projectFile: ".codex/mcp_config.json",
+			userFile: path.default.join(HOME, ".codex", "mcp_config.json"),
 			key: "mcpServers",
 			shape: "map"
 		}
@@ -3346,6 +3394,8 @@ var IndexGeneratorServiceImpl = class extends IndexGeneratorService {
 				"",
 				"| Tool | When to call it |",
 				"| --- | --- |",
+				"| `list_workflows()` | At the start of any task or session to discover available standard operating procedures |",
+				"| `get_workflow(name)` | Once a relevant workflow is identified to retrieve exact step-by-step instructions |",
 				"| `load_skills_for_files(files=[...])` | Before editing/reviewing any source file |",
 				"| `load_skills_for_keywords(keywords=[...])` | Planning before files are chosen |",
 				"| `get_skill(category, name)` | Direct lookup when you know the skill id |",
@@ -3868,7 +3918,7 @@ var SpecialistTransformer = class {
 				name: `${baseName}.md`,
 				content: `---\nname: ${baseName}\ndescription: "${description}"\n---\n\n${body}`
 			};
-			case Agent.OpenAI: return {
+			case Agent.Codex: return {
 				name: `${baseName}.toml`,
 				content: `name = "${baseName}"\ndescription = "${description}"\nsandbox_mode = "read-only"\ndeveloper_instructions = """\n${body}\n"""`
 			};
@@ -3886,6 +3936,56 @@ var SpecialistTransformer = class {
 * to native agent configuration directories.
 */
 var SpecialistSyncService = class {
+	constructor(githubService = new GithubService(process.env.GITHUB_TOKEN)) {
+		this.githubService = githubService;
+	}
+	async assembleSpecialists(config) {
+		const githubMatch = GithubService.parseGitHubUrl(config.registry);
+		if (!githubMatch) return [];
+		const { owner, repo } = githubMatch;
+		const ref = (await this.githubService.getRepoInfo(owner, repo))?.default_branch || "main";
+		const treeData = await this.githubService.getRepoTree(owner, repo, ref);
+		if (!treeData) return [];
+		const skillFiles = treeData.tree.filter((item) => item.type === "blob" && item.path.startsWith("skills/specialists/") && item.path.endsWith("/SKILL.md"));
+		const specialists = [];
+		for (const file of skillFiles) {
+			const specialistName = file.path.split("/")[2];
+			if (!specialistName) continue;
+			const content = await this.githubService.getRawFile(owner, repo, ref, file.path);
+			if (!content) continue;
+			specialists.push({
+				category: "specialists",
+				skill: specialistName,
+				files: [{
+					name: "SKILL.md",
+					content
+				}]
+			});
+		}
+		return specialists;
+	}
+	async syncCollectedSpecialists(rootDir, agents, specialists) {
+		if (specialists.length === 0) return;
+		for (const agentId of agents) {
+			const agentDef = SUPPORTED_AGENTS.find((a) => a.id === agentId);
+			if (!agentDef || !agentDef.agentPath) continue;
+			const targetDir = path.default.join(rootDir, agentDef.agentPath);
+			await fs_extra.default.ensureDir(targetDir);
+			let syncedCount = 0;
+			for (const specialist of specialists) {
+				const skillFile = specialist.files.find((file) => file.name === "SKILL.md");
+				if (!skillFile) continue;
+				const transformed = SpecialistTransformer.transform({
+					name: specialist.skill,
+					content: skillFile.content
+				}, agentId);
+				if (!transformed) continue;
+				await fs_extra.default.outputFile(path.default.join(targetDir, transformed.name), transformed.content);
+				syncedCount++;
+			}
+			if (syncedCount > 0) console.log(picocolors.default.green(`  ✅ ${syncedCount} specialists synced to ${agentDef.agentPath}/ (${agentDef.name})`));
+		}
+	}
 	/**
 	* Syncs all specialists from a source directory to active agents.
 	* @param rootDir Project root directory
@@ -3898,28 +3998,21 @@ var SpecialistSyncService = class {
 		const specialistFolders = (await fs_extra.default.readdir(specialistsDir)).filter((f) => {
 			return fs_extra.default.statSync(path.default.join(specialistsDir, f)).isDirectory();
 		});
-		for (const agentId of agents) {
-			const agentDef = SUPPORTED_AGENTS.find((a) => a.id === agentId);
-			if (!agentDef || !agentDef.agentPath) continue;
-			const targetDir = path.default.join(rootDir, agentDef.agentPath);
-			await fs_extra.default.ensureDir(targetDir);
-			let syncedCount = 0;
-			for (const folder of specialistFolders) {
-				const skillPath = path.default.join(specialistsDir, folder, "SKILL.md");
-				if (!await fs_extra.default.pathExists(skillPath)) continue;
-				const content = await fs_extra.default.readFile(skillPath, "utf8");
-				const transformed = SpecialistTransformer.transform({
-					name: folder,
+		const collected = [];
+		for (const folder of specialistFolders) {
+			const skillPath = path.default.join(specialistsDir, folder, "SKILL.md");
+			if (!await fs_extra.default.pathExists(skillPath)) continue;
+			const content = await fs_extra.default.readFile(skillPath, "utf8");
+			collected.push({
+				category: "specialists",
+				skill: folder,
+				files: [{
+					name: "SKILL.md",
 					content
-				}, agentId);
-				if (transformed) {
-					const targetFile = path.default.join(targetDir, transformed.name);
-					await fs_extra.default.outputFile(targetFile, transformed.content);
-					syncedCount++;
-				}
-			}
-			if (syncedCount > 0) console.log(picocolors.default.green(`  ✅ ${syncedCount} specialists synced to ${agentDef.agentPath}/ (${agentDef.name})`));
+				}]
+			});
 		}
+		return this.syncCollectedSpecialists(rootDir, agents, collected);
 	}
 };
 //#endregion
@@ -4075,7 +4168,8 @@ var SyncService = class {
 	}
 	async assembleSkills(categories, config) {
 		await this.warnIfSyncingFromSameRepo(config);
-		return this.skillSyncService.assembleSkills(categories, config);
+		const skillCategories = categories.filter((category) => category !== "specialists");
+		return this.skillSyncService.assembleSkills(skillCategories, config);
 	}
 	async warnIfSyncingFromSameRepo(config) {
 		const remoteUrl = this.gitService.getRemoteUrl(process.cwd());
@@ -4102,10 +4196,10 @@ var SyncService = class {
 	async syncSpecialists(config) {
 		const agents = await this.resolveTargetAgents(config);
 		if (agents.length === 0) return;
-		const primaryAgent = SUPPORTED_AGENTS.find((a) => a.id === agents[0]);
-		const sourceDir = primaryAgent ? path.default.join(process.cwd(), primaryAgent.path, "specialists") : path.default.join(process.cwd(), "skills/specialists");
-		const finalSourceDir = await fs_extra.default.pathExists(sourceDir) ? sourceDir : path.default.join(process.cwd(), "skills/specialists");
-		return this.specialistSyncService.syncSpecialists(process.cwd(), agents, finalSourceDir);
+		const localRegistrySource = path.default.join(process.cwd(), "skills/specialists");
+		if (await fs_extra.default.pathExists(localRegistrySource)) return this.specialistSyncService.syncSpecialists(process.cwd(), agents, localRegistrySource);
+		const specialists = await this.specialistSyncService.assembleSpecialists(config);
+		return this.specialistSyncService.syncCollectedSpecialists(process.cwd(), agents, specialists);
 	}
 	async applyIndices(config, targetAgents) {
 		const agents = targetAgents || await this.resolveTargetAgents(config);
@@ -4368,6 +4462,14 @@ var SyncCommand = class {
 	async runHookPhase(config) {
 		const agents = config.agents ?? [];
 		if (agents.length === 0) return;
+		const mcp = config.mcp ?? defaultMcpConfig();
+		if (!mcp.enabled || mcp.scope === "disabled") {
+			await this.hookService.uninstall({
+				rootDir: process.cwd(),
+				agents
+			});
+			return;
+		}
 		const writes = (await this.hookService.install({
 			rootDir: process.cwd(),
 			agents
@@ -4382,7 +4484,7 @@ var SyncCommand = class {
 };
 var package_default = {
 	name: "agent-skills-standard",
-	version: "2.3.0",
+	version: "2.4.1",
 	description: "A CLI to manage and sync AI agent skills standard for Cursor, Claude, Copilot, Windsurf, and more.",
 	main: "dist/index.js",
 	bin: {
@@ -4868,7 +4970,7 @@ var ValidateCommand = class {
 //#region src/index.ts
 dotenv.default.config();
 var program = new commander.Command();
-program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.3.0");
+program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.4.1");
 program.command("init").description("Initialize a .skillsrc configuration file interactively").action(async () => {
 	await new InitCommand().run();
 });