@intellectronica/ruler 0.3.17 → 0.3.19

package/README.md

@@ -557,15 +557,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 +620,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 +640,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 +698,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/CodexCliAgent.js

@@ -139,5 +139,8 @@ class CodexCliAgent {
     supportsMcpRemote() {
         return false; // Codex CLI only supports STDIO based on PR description
     }
+    supportsNativeSkills() {
+        return true;
+    }
 }
 exports.CodexCliAgent = CodexCliAgent;

package/dist/agents/CopilotAgent.js

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

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/OpenCodeAgent.js

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

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.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.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;
@@ -53,6 +53,9 @@ function logVerboseInfo(message, isVerbose, dryRun = false) {
 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.SKILLZ_DIR = '.skillz';
 exports.SKILL_MD_FILENAME = 'SKILL.md';
 exports.SKILLZ_MCP_SERVER_NAME = 'skillz';

package/dist/core/SkillsProcessor.js

@@ -37,6 +37,9 @@ exports.discoverSkills = discoverSkills;
 exports.getSkillsGitignorePaths = getSkillsGitignorePaths;
 exports.propagateSkills = propagateSkills;
 exports.propagateSkillsForClaude = propagateSkillsForClaude;
+exports.propagateSkillsForCodex = propagateSkillsForCodex;
+exports.propagateSkillsForOpenCode = propagateSkillsForOpenCode;
+exports.propagateSkillsForGoose = propagateSkillsForGoose;
 exports.propagateSkillsForSkillz = propagateSkillsForSkillz;
 exports.buildSkillzMcpConfig = buildSkillzMcpConfig;
 const path = __importStar(require("path"));
@@ -74,9 +77,12 @@ async function getSkillsGitignorePaths(projectRoot) {
         return [];
     }
     // Import here to avoid circular dependency
-    const { CLAUDE_SKILLS_PATH, SKILLZ_DIR } = await Promise.resolve().then(() => __importStar(require('../constants')));
+    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, OPENCODE_SKILLS_PATH, GOOSE_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, SKILLZ_DIR),
     ];
 }
@@ -100,11 +106,14 @@ 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 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 skillzPath = path.join(projectRoot, constants_1.SKILLZ_DIR);
     // Clean up .claude/skills
     try {
@@ -120,6 +129,48 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
+    // Clean up .codex/skills
+    try {
+        await fs.access(codexSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.CODEX_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(codexSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.CODEX_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    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 .skillz
     try {
         await fs.access(skillzPath);
@@ -178,8 +229,14 @@ async function propagateSkills(projectRoot, agents, skillsEnabled, verbose, dryR
     }
     // Copy to Claude skills directory if needed
     if (hasNativeSkillsAgent) {
-        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.CLAUDE_SKILLS_PATH} for Claude Code`, verbose, dryRun);
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.CLAUDE_SKILLS_PATH} for Claude Code and GitHub Copilot`, verbose, dryRun);
         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 });
     }
     // Copy to .skillz directory if needed
     if (hasMcpAgent) {
@@ -237,6 +294,156 @@ async function propagateSkillsForClaude(projectRoot, options) {
     }
     return [];
 }
+/**
+ * Propagates skills for OpenAI Codex CLI by copying .ruler/skills to .codex/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 propagateSkillsForCodex(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const codexSkillsPath = path.join(projectRoot, constants_1.CODEX_SKILLS_PATH);
+    const codexDir = path.dirname(codexSkillsPath);
+    // 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.CODEX_SKILLS_PATH}`];
+    }
+    // Ensure .codex directory exists
+    await fs.mkdir(codexDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(codexDir, `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(codexSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, codexSkillsPath);
+    }
+    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 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 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.17",
+  "version": "0.3.19",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {