@intellectronica/ruler 0.3.18 → 0.3.20

package/README.md

@@ -84,6 +84,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Warp             | `WARP.md`                                        | -                                                |
 | Kiro             | `.kiro/steering/ruler_kiro_instructions.md`      | `.kiro/settings/mcp.json`                        |
 | Firebender       | `firebender.json`                                | `firebender.json` (rules and MCP in same file)   |
+| Mistral Vibe     | `AGENTS.md`                                      | `.vibe/config.toml`                              |
 
 ## Getting Started
 
@@ -319,7 +320,7 @@ ruler revert [options]
 | Option                         | Description                                                                                                                                                                                                                                                                   |
 | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `--project-root <path>`        | Path to your project's root (default: current directory)                                                                                                                                                                                                                      |
-| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to revert (agentsmd, aider, amazonqcli, amp, antigravity, augmentcode, claude, cline, codex, copilot, crush, cursor, firebase, firebender, gemini-cli, goose, jules, junie, kilocode, kiro, opencode, openhands, qwen, roo, trae, warp, windsurf, zed) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to revert (agentsmd, aider, amazonqcli, amp, antigravity, augmentcode, claude, cline, codex, copilot, crush, cursor, firebase, firebender, gemini-cli, goose, jules, junie, kilocode, kiro, mistral, opencode, openhands, qwen, roo, trae, warp, windsurf, zed) |
 | `--config <path>`              | Path to a custom `ruler.toml` configuration file                                                                                                                                                                                                                              |
 | `--keep-backups`               | Keep backup files (.bak) after restoration (default: false)                                                                                                                                                                                                                   |
 | `--dry-run`                    | Preview changes without actually reverting files                                                                                                                                                                                                                              |
@@ -557,15 +558,20 @@ export CODEX_HOME="$(pwd)/.codex"
 
 ## Skills Support (Experimental)
 
-**⚠️ Experimental Feature**: Skills support is currently experimental and requires `uv` (the Python package manager) to be installed on your system for MCP-based agent integration.
+**⚠️ Experimental Feature**: Skills support is currently experimental and requires `uv` (the Python package manager) to be installed on your system for MCP-based agent integration (agents without native skills support).
 
-Ruler can manage and propagate Claude Code-compatible skills to supported AI agents. Skills are stored in `.ruler/skills/` and are automatically distributed to compatible agents when you run `ruler apply`.
+Ruler can manage and propagate skills to supported AI agents. Skills are stored in `.ruler/skills/` and are automatically distributed to compatible agents when you run `ruler apply`.
 
 ### How It Works
 
 Skills are specialized knowledge packages that extend AI agent capabilities with domain-specific expertise, workflows, or tool integrations. Ruler discovers skills in your `.ruler/skills/` directory and propagates them to compatible agents:
 
-- **Claude Code agents**: Skills are copied to `.claude/skills/` in their native format
+- **Agents with native skills support**: Skills are copied directly to each agent's native skills directory:
+  - **Claude Code**: `.claude/skills/`
+  - **GitHub Copilot**: `.claude/skills/` (shared with Claude Code)
+  - **OpenAI Codex CLI**: `.codex/skills/`
+  - **OpenCode**: `.opencode/skill/`
+  - **Goose**: `.agents/skills/`
 - **Other MCP-compatible agents**: Skills are copied to `.skillz/` and a Skillz MCP server is automatically configured via `uvx`
 
 ### Skills Directory Structure
@@ -615,12 +621,14 @@ enabled = true  # or false to disable
 
 ### Skillz MCP Server
 
-For agents that support MCP but don't have native skills support (all agents except Claude Code), Ruler automatically:
+For agents that support MCP but don't have native skills support, Ruler automatically:
 
 1. Copies skills to `.skillz/` directory
 2. Configures a Skillz MCP server in the agent's configuration
 3. Uses `uvx` to launch the server with the absolute path to `.skillz`
 
+Agents using native skills support (Claude Code, GitHub Copilot, OpenAI Codex CLI, OpenCode, and Goose) **do not** use the Skillz MCP server and instead use their own native skills directories.
+
 Example auto-generated MCP server configuration:
 
 ```toml
@@ -633,15 +641,18 @@ args = ["skillz@latest", "/absolute/path/to/project/.skillz"]
 
 When skills support is enabled and gitignore integration is active, Ruler automatically adds:
 
-- `.claude/skills/` (for Claude Code agents)
-- `.skillz/` (for MCP-based agents)
+- `.claude/skills/` (for Claude Code and GitHub Copilot)
+- `.codex/skills/` (for OpenAI Codex CLI)
+- `.opencode/skill/` (for OpenCode)
+- `.agents/skills/` (for Goose)
+- `.skillz/` (for other MCP-based agents)
 
 to your `.gitignore` file within the managed Ruler block.
 
 ### Requirements
 
-- **For Claude Code**: No additional requirements
-- **For MCP agents**: `uv` must be installed and available in your PATH
+- **For agents with native skills support** (Claude Code, GitHub Copilot, OpenAI Codex CLI, OpenCode, Goose): No additional requirements
+- **For other MCP agents**: `uv` must be installed and available in your PATH
   ```bash
   # Install uv if needed
   curl -LsSf https://astral.sh/uv/install.sh | sh
@@ -688,7 +699,10 @@ EOF
 ruler apply
 
 # 3. Skills are now available to compatible agents:
-#    - Claude Code: .claude/skills/my-skill/
+#    - Claude Code & GitHub Copilot: .claude/skills/my-skill/
+#    - OpenAI Codex CLI: .codex/skills/my-skill/
+#    - OpenCode: .opencode/skill/my-skill/
+#    - Goose: .agents/skills/my-skill/
 #    - Other MCP agents: .skillz/my-skill/ + Skillz MCP server configured
 ```
 

package/dist/agents/GooseAgent.js

@@ -54,5 +54,8 @@ class GooseAgent extends AbstractAgent_1.AbstractAgent {
         // Goose doesn't support MCP configuration via local config files
         return '';
     }
+    supportsNativeSkills() {
+        return true;
+    }
 }
 exports.GooseAgent = GooseAgent;

package/dist/agents/MistralVibeAgent.js

@@ -0,0 +1,171 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MistralVibeAgent = void 0;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const toml_1 = require("@iarna/toml");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const constants_1 = require("../constants");
+/**
+ * Mistral Vibe CLI agent adapter.
+ * Propagates rules to AGENTS.md and MCP servers to .vibe/config.toml.
+ */
+class MistralVibeAgent {
+    constructor() {
+        this.agentsMdAgent = new AgentsMdAgent_1.AgentsMdAgent();
+    }
+    getIdentifier() {
+        return 'mistral';
+    }
+    getName() {
+        return 'Mistral';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig, backup = true) {
+        // First perform idempotent AGENTS.md write via composed AgentsMdAgent
+        await this.agentsMdAgent.applyRulerConfig(concatenatedRules, projectRoot, null, {
+            outputPath: agentConfig?.outputPath ||
+                agentConfig?.outputPathInstructions ||
+                undefined,
+        }, backup);
+        // Handle MCP configuration
+        const defaults = this.getDefaultOutputPath(projectRoot);
+        const mcpEnabled = agentConfig?.mcp?.enabled ?? true;
+        if (mcpEnabled && rulerMcpJson) {
+            // Apply MCP server filtering and transformation
+            const { filterMcpConfigForAgent } = await Promise.resolve().then(() => __importStar(require('../mcp/capabilities')));
+            const filteredMcpConfig = filterMcpConfigForAgent(rulerMcpJson, this);
+            if (!filteredMcpConfig) {
+                return; // No compatible servers found
+            }
+            const filteredRulerMcpJson = filteredMcpConfig;
+            // Determine the config file path
+            const configPath = agentConfig?.outputPathConfig ?? defaults.config;
+            // Ensure the parent directory exists
+            await fs_1.promises.mkdir(path.dirname(configPath), { recursive: true });
+            // Get the merge strategy
+            const strategy = agentConfig?.mcp?.strategy ?? 'merge';
+            // Transform ruler MCP servers to Vibe format
+            const rulerServers = filteredRulerMcpJson.mcpServers || {};
+            const vibeServers = [];
+            for (const [serverName, serverConfig] of Object.entries(rulerServers)) {
+                const vibeServer = {
+                    name: serverName,
+                    transport: this.determineTransport(serverConfig),
+                };
+                // Handle stdio servers
+                if (serverConfig.command) {
+                    vibeServer.command = serverConfig.command;
+                    if (serverConfig.args) {
+                        vibeServer.args = serverConfig.args;
+                    }
+                }
+                // Handle remote servers
+                if (serverConfig.url) {
+                    vibeServer.url = serverConfig.url;
+                }
+                // Handle headers
+                if (serverConfig.headers) {
+                    vibeServer.headers = serverConfig.headers;
+                }
+                // Handle env
+                if (serverConfig.env) {
+                    vibeServer.env = serverConfig.env;
+                }
+                vibeServers.push(vibeServer);
+            }
+            // Read existing TOML config if it exists
+            let existingConfig = {};
+            try {
+                const existingContent = await fs_1.promises.readFile(configPath, 'utf8');
+                existingConfig = (0, toml_1.parse)(existingContent);
+            }
+            catch {
+                // File doesn't exist or can't be parsed, use empty config
+            }
+            // Create the updated config
+            const updatedConfig = { ...existingConfig };
+            if (strategy === 'overwrite') {
+                // For overwrite strategy, replace the entire mcp_servers array
+                updatedConfig.mcp_servers = vibeServers;
+            }
+            else {
+                // For merge strategy, merge by server name
+                const existingServers = updatedConfig.mcp_servers || [];
+                // Keep existing servers that aren't being overwritten by ruler
+                const mergedServers = existingServers.filter((s) => !rulerServers[s.name]);
+                // Add all ruler servers
+                mergedServers.push(...vibeServers);
+                updatedConfig.mcp_servers = mergedServers;
+            }
+            // Convert to TOML and write
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const tomlContent = (0, toml_1.stringify)(updatedConfig);
+            await (0, FileSystemUtils_1.writeGeneratedFile)(configPath, tomlContent);
+        }
+    }
+    /**
+     * Determines the transport type based on server configuration.
+     */
+    determineTransport(server) {
+        if (server.command) {
+            return 'stdio';
+        }
+        if (server.url) {
+            // Default to http for remote servers
+            // Could potentially detect streamable-http based on URL patterns if needed
+            return 'http';
+        }
+        return 'stdio';
+    }
+    getDefaultOutputPath(projectRoot) {
+        return {
+            instructions: path.join(projectRoot, constants_1.DEFAULT_RULES_FILENAME),
+            config: path.join(projectRoot, '.vibe', 'config.toml'),
+        };
+    }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true; // Mistral Vibe supports http and streamable-http transports
+    }
+    supportsNativeSkills() {
+        // Mistral Vibe supports native skills in .vibe/skills/
+        return true;
+    }
+}
+exports.MistralVibeAgent = MistralVibeAgent;

package/dist/agents/OpenCodeAgent.js

@@ -95,5 +95,8 @@ class OpenCodeAgent {
     supportsMcpRemote() {
         return true;
     }
+    supportsNativeSkills() {
+        return true;
+    }
 }
 exports.OpenCodeAgent = OpenCodeAgent;

package/dist/agents/index.js

@@ -32,6 +32,7 @@ const TraeAgent_1 = require("./TraeAgent");
 const AmazonQCliAgent_1 = require("./AmazonQCliAgent");
 const FirebenderAgent_1 = require("./FirebenderAgent");
 const AntigravityAgent_1 = require("./AntigravityAgent");
+const MistralVibeAgent_1 = require("./MistralVibeAgent");
 exports.allAgents = [
     new CopilotAgent_1.CopilotAgent(),
     new ClaudeAgent_1.ClaudeAgent(),
@@ -61,6 +62,7 @@ exports.allAgents = [
     new AmazonQCliAgent_1.AmazonQCliAgent(),
     new FirebenderAgent_1.FirebenderAgent(),
     new AntigravityAgent_1.AntigravityAgent(),
+    new MistralVibeAgent_1.MistralVibeAgent(),
 ];
 /**
  * Generates a comma-separated list of agent identifiers for CLI help text.

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILLZ_MCP_SERVER_NAME = exports.SKILL_MD_FILENAME = exports.SKILLZ_DIR = exports.CODEX_SKILLS_PATH = exports.CLAUDE_SKILLS_PATH = exports.RULER_SKILLS_PATH = exports.SKILLS_DIR = exports.DEFAULT_RULES_FILENAME = exports.ERROR_PREFIX = void 0;
+exports.SKILLZ_MCP_SERVER_NAME = exports.SKILL_MD_FILENAME = exports.SKILLZ_DIR = exports.VIBE_SKILLS_PATH = exports.GOOSE_SKILLS_PATH = exports.OPENCODE_SKILLS_PATH = exports.CODEX_SKILLS_PATH = exports.CLAUDE_SKILLS_PATH = exports.RULER_SKILLS_PATH = exports.SKILLS_DIR = exports.DEFAULT_RULES_FILENAME = exports.ERROR_PREFIX = void 0;
 exports.actionPrefix = actionPrefix;
 exports.createRulerError = createRulerError;
 exports.logVerbose = logVerbose;
@@ -54,6 +54,9 @@ exports.SKILLS_DIR = 'skills';
 exports.RULER_SKILLS_PATH = '.ruler/skills';
 exports.CLAUDE_SKILLS_PATH = '.claude/skills';
 exports.CODEX_SKILLS_PATH = '.codex/skills';
+exports.OPENCODE_SKILLS_PATH = '.opencode/skill';
+exports.GOOSE_SKILLS_PATH = '.agents/skills';
+exports.VIBE_SKILLS_PATH = '.vibe/skills';
 exports.SKILLZ_DIR = '.skillz';
 exports.SKILL_MD_FILENAME = 'SKILL.md';
 exports.SKILLZ_MCP_SERVER_NAME = 'skillz';

package/dist/core/SkillsProcessor.js

@@ -38,6 +38,9 @@ exports.getSkillsGitignorePaths = getSkillsGitignorePaths;
 exports.propagateSkills = propagateSkills;
 exports.propagateSkillsForClaude = propagateSkillsForClaude;
 exports.propagateSkillsForCodex = propagateSkillsForCodex;
+exports.propagateSkillsForOpenCode = propagateSkillsForOpenCode;
+exports.propagateSkillsForGoose = propagateSkillsForGoose;
+exports.propagateSkillsForVibe = propagateSkillsForVibe;
 exports.propagateSkillsForSkillz = propagateSkillsForSkillz;
 exports.buildSkillzMcpConfig = buildSkillzMcpConfig;
 const path = __importStar(require("path"));
@@ -75,10 +78,13 @@ async function getSkillsGitignorePaths(projectRoot) {
         return [];
     }
     // Import here to avoid circular dependency
-    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, SKILLZ_DIR } = await Promise.resolve().then(() => __importStar(require('../constants')));
+    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, OPENCODE_SKILLS_PATH, GOOSE_SKILLS_PATH, VIBE_SKILLS_PATH, SKILLZ_DIR, } = await Promise.resolve().then(() => __importStar(require('../constants')));
     return [
         path.join(projectRoot, CLAUDE_SKILLS_PATH),
         path.join(projectRoot, CODEX_SKILLS_PATH),
+        path.join(projectRoot, OPENCODE_SKILLS_PATH),
+        path.join(projectRoot, GOOSE_SKILLS_PATH),
+        path.join(projectRoot, VIBE_SKILLS_PATH),
         path.join(projectRoot, SKILLZ_DIR),
     ];
 }
@@ -102,12 +108,15 @@ function warnOnceExperimentalAndUv(verbose, dryRun) {
     (0, constants_1.logWarn)('Skills MCP server (Skillz) requires uv. Install: https://github.com/astral-sh/uv', dryRun);
 }
 /**
- * Cleans up skills directories (.claude/skills, .codex/skills and .skillz) when skills are disabled.
+ * Cleans up skills directories when skills are disabled.
  * This ensures that stale skills from previous runs don't persist when skills are turned off.
  */
 async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     const claudeSkillsPath = path.join(projectRoot, constants_1.CLAUDE_SKILLS_PATH);
     const codexSkillsPath = path.join(projectRoot, constants_1.CODEX_SKILLS_PATH);
+    const opencodeSkillsPath = path.join(projectRoot, constants_1.OPENCODE_SKILLS_PATH);
+    const gooseSkillsPath = path.join(projectRoot, constants_1.GOOSE_SKILLS_PATH);
+    const vibeSkillsPath = path.join(projectRoot, constants_1.VIBE_SKILLS_PATH);
     const skillzPath = path.join(projectRoot, constants_1.SKILLZ_DIR);
     // Clean up .claude/skills
     try {
@@ -137,6 +146,48 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
+    // Clean up .opencode/skill
+    try {
+        await fs.access(opencodeSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.OPENCODE_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(opencodeSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.OPENCODE_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
+    // Clean up .agents/skills
+    try {
+        await fs.access(gooseSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.GOOSE_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(gooseSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.GOOSE_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
+    // Clean up .vibe/skills
+    try {
+        await fs.access(vibeSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.VIBE_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(vibeSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.VIBE_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
     // Clean up .skillz
     try {
         await fs.access(skillzPath);
@@ -199,6 +250,12 @@ async function propagateSkills(projectRoot, agents, skillsEnabled, verbose, dryR
         await propagateSkillsForClaude(projectRoot, { dryRun });
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.CODEX_SKILLS_PATH} for OpenAI Codex CLI`, verbose, dryRun);
         await propagateSkillsForCodex(projectRoot, { dryRun });
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.OPENCODE_SKILLS_PATH} for OpenCode`, verbose, dryRun);
+        await propagateSkillsForOpenCode(projectRoot, { dryRun });
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.GOOSE_SKILLS_PATH} for Goose`, verbose, dryRun);
+        await propagateSkillsForGoose(projectRoot, { dryRun });
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.VIBE_SKILLS_PATH} for Mistral Vibe`, verbose, dryRun);
+        await propagateSkillsForVibe(projectRoot, { dryRun });
     }
     // Copy to .skillz directory if needed
     if (hasMcpAgent) {
@@ -306,6 +363,156 @@ async function propagateSkillsForCodex(projectRoot, options) {
     }
     return [];
 }
+/**
+ * Propagates skills for OpenCode by copying .ruler/skills to .opencode/skill.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+async function propagateSkillsForOpenCode(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const opencodeSkillsPath = path.join(projectRoot, constants_1.OPENCODE_SKILLS_PATH);
+    const opencodeDir = path.dirname(opencodeSkillsPath);
+    // Check if source skills directory exists
+    try {
+        await fs.access(skillsDir);
+    }
+    catch {
+        // No skills directory - return empty
+        return [];
+    }
+    if (options.dryRun) {
+        return [`Copy skills from ${constants_1.RULER_SKILLS_PATH} to ${constants_1.OPENCODE_SKILLS_PATH}`];
+    }
+    // Ensure .opencode directory exists
+    await fs.mkdir(opencodeDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(opencodeDir, `skill.tmp-${Date.now()}`);
+    try {
+        // Copy to temp directory
+        await (0, SkillsUtils_1.copySkillsDirectory)(skillsDir, tempDir);
+        // Atomically replace the target
+        // First, remove existing target if it exists
+        try {
+            await fs.rm(opencodeSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, opencodeSkillsPath);
+    }
+    catch (error) {
+        // Clean up temp directory on error
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+    return [];
+}
+/**
+ * Propagates skills for Goose by copying .ruler/skills to .agents/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+async function propagateSkillsForGoose(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const gooseSkillsPath = path.join(projectRoot, constants_1.GOOSE_SKILLS_PATH);
+    const gooseDir = path.dirname(gooseSkillsPath);
+    // Check if source skills directory exists
+    try {
+        await fs.access(skillsDir);
+    }
+    catch {
+        // No skills directory - return empty
+        return [];
+    }
+    if (options.dryRun) {
+        return [`Copy skills from ${constants_1.RULER_SKILLS_PATH} to ${constants_1.GOOSE_SKILLS_PATH}`];
+    }
+    // Ensure .agents directory exists
+    await fs.mkdir(gooseDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(gooseDir, `skills.tmp-${Date.now()}`);
+    try {
+        // Copy to temp directory
+        await (0, SkillsUtils_1.copySkillsDirectory)(skillsDir, tempDir);
+        // Atomically replace the target
+        // First, remove existing target if it exists
+        try {
+            await fs.rm(gooseSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, gooseSkillsPath);
+    }
+    catch (error) {
+        // Clean up temp directory on error
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+    return [];
+}
+/**
+ * Propagates skills for Mistral Vibe by copying .ruler/skills to .vibe/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+async function propagateSkillsForVibe(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const vibeSkillsPath = path.join(projectRoot, constants_1.VIBE_SKILLS_PATH);
+    const vibeDir = path.dirname(vibeSkillsPath);
+    // Check if source skills directory exists
+    try {
+        await fs.access(skillsDir);
+    }
+    catch {
+        // No skills directory - return empty
+        return [];
+    }
+    if (options.dryRun) {
+        return [`Copy skills from ${constants_1.RULER_SKILLS_PATH} to ${constants_1.VIBE_SKILLS_PATH}`];
+    }
+    // Ensure .vibe directory exists
+    await fs.mkdir(vibeDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(vibeDir, `skills.tmp-${Date.now()}`);
+    try {
+        // Copy to temp directory
+        await (0, SkillsUtils_1.copySkillsDirectory)(skillsDir, tempDir);
+        // Atomically replace the target
+        // First, remove existing target if it exists
+        try {
+            await fs.rm(vibeSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, vibeSkillsPath);
+    }
+    catch (error) {
+        // Clean up temp directory on error
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+    return [];
+}
 /**
  * Propagates skills for MCP agents by copying .ruler/skills to .skillz.
  * Uses atomic replace to ensure safe overwriting of existing skills.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectronica/ruler",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {