rulesync 3.32.0 → 3.33.0

package/dist/index.cjs

@@ -3536,6 +3536,12 @@ var CodexcliMcp = class _CodexcliMcp extends ToolMcp {
 
 // src/features/mcp/copilot-mcp.ts
 var import_node_path35 = require("path");
+function convertToCopilotFormat(mcpServers) {
+  return { servers: mcpServers };
+}
+function convertFromCopilotFormat(copilotConfig) {
+  return copilotConfig.servers ?? {};
+}
 var CopilotMcp = class _CopilotMcp extends ToolMcp {
   json;
   constructor(params) {
@@ -3575,16 +3581,20 @@ var CopilotMcp = class _CopilotMcp extends ToolMcp {
     rulesyncMcp,
     validate = true
   }) {
+    const copilotConfig = convertToCopilotFormat(rulesyncMcp.getMcpServers());
     return new _CopilotMcp({
       baseDir,
       relativeDirPath: this.getSettablePaths().relativeDirPath,
       relativeFilePath: this.getSettablePaths().relativeFilePath,
-      fileContent: rulesyncMcp.getFileContent(),
+      fileContent: JSON.stringify(copilotConfig, null, 2),
       validate
     });
   }
   toRulesyncMcp() {
-    return this.toRulesyncMcpDefault();
+    const mcpServers = convertFromCopilotFormat(this.json);
+    return this.toRulesyncMcpDefault({
+      fileContent: JSON.stringify({ mcpServers }, null, 2)
+    });
   }
   validate() {
     return { success: true, error: null };
@@ -3968,6 +3978,37 @@ var OpencodeMcp = class _OpencodeMcp extends ToolMcp {
 
 // src/features/mcp/roo-mcp.ts
 var import_node_path40 = require("path");
+function isRooMcpServers(value) {
+  return value !== void 0 && value !== null && typeof value === "object";
+}
+function convertToRooFormat(mcpServers) {
+  return Object.fromEntries(
+    Object.entries(mcpServers).map(([serverName, serverConfig]) => {
+      const converted = { ...serverConfig };
+      if (serverConfig.type === "http") {
+        converted.type = "streamable-http";
+      }
+      if (serverConfig.transport === "http") {
+        converted.transport = "streamable-http";
+      }
+      return [serverName, converted];
+    })
+  );
+}
+function convertFromRooFormat(mcpServers) {
+  return Object.fromEntries(
+    Object.entries(mcpServers).map(([serverName, serverConfig]) => {
+      const converted = { ...serverConfig };
+      if (serverConfig.type === "streamable-http") {
+        converted.type = "http";
+      }
+      if (serverConfig.transport === "streamable-http") {
+        converted.transport = "http";
+      }
+      return [serverName, converted];
+    })
+  );
+}
 var RooMcp = class _RooMcp extends ToolMcp {
   json;
   constructor(params) {
@@ -4007,7 +4048,9 @@ var RooMcp = class _RooMcp extends ToolMcp {
     rulesyncMcp,
     validate = true
   }) {
-    const fileContent = rulesyncMcp.getFileContent();
+    const mcpServers = rulesyncMcp.getMcpServers();
+    const convertedMcpServers = convertToRooFormat(mcpServers);
+    const fileContent = JSON.stringify({ mcpServers: convertedMcpServers }, null, 2);
     return new _RooMcp({
       baseDir,
       relativeDirPath: this.getSettablePaths().relativeDirPath,
@@ -4017,7 +4060,11 @@ var RooMcp = class _RooMcp extends ToolMcp {
     });
   }
   toRulesyncMcp() {
-    return this.toRulesyncMcpDefault();
+    const rawMcpServers = isRooMcpServers(this.json.mcpServers) ? this.json.mcpServers : {};
+    const convertedMcpServers = convertFromRooFormat(rawMcpServers);
+    return this.toRulesyncMcpDefault({
+      fileContent: JSON.stringify({ mcpServers: convertedMcpServers }, null, 2)
+    });
   }
   validate() {
     return { success: true, error: null };
@@ -4262,17 +4309,19 @@ var import_node_path84 = require("path");
 var import_toon = require("@toon-format/toon");
 var import_mini33 = require("zod/mini");
 
-// src/features/skills/codexcli-skill.ts
-var import_node_path44 = require("path");
-var import_mini20 = require("zod/mini");
-
 // src/constants/general.ts
 var SKILL_FILE_NAME = "SKILL.md";
 
-// src/features/skills/rulesync-skill.ts
-var import_node_path42 = require("path");
+// src/features/skills/agentsmd-skill.ts
+var import_node_path44 = require("path");
+
+// src/features/skills/simulated-skill.ts
+var import_node_path43 = require("path");
 var import_mini19 = require("zod/mini");
 
+// src/features/skills/tool-skill.ts
+var import_node_path42 = require("path");
+
 // src/types/ai-dir.ts
 var import_node_path41 = __toESM(require("path"), 1);
 var AiDir = class {
@@ -4385,113 +4434,7 @@ var AiDir = class {
   }
 };
 
-// src/features/skills/rulesync-skill.ts
-var RulesyncSkillFrontmatterSchemaInternal = import_mini19.z.object({
-  name: import_mini19.z.string(),
-  description: import_mini19.z.string(),
-  targets: import_mini19.z._default(RulesyncTargetsSchema, ["*"]),
-  claudecode: import_mini19.z.optional(
-    import_mini19.z.object({
-      "allowed-tools": import_mini19.z.optional(import_mini19.z.array(import_mini19.z.string()))
-    })
-  )
-});
-var RulesyncSkillFrontmatterSchema = RulesyncSkillFrontmatterSchemaInternal;
-var RulesyncSkill = class _RulesyncSkill extends AiDir {
-  constructor({
-    baseDir = process.cwd(),
-    relativeDirPath = RULESYNC_SKILLS_RELATIVE_DIR_PATH,
-    dirName,
-    frontmatter,
-    body,
-    otherFiles = [],
-    validate = true,
-    global = false
-  }) {
-    super({
-      baseDir,
-      relativeDirPath,
-      dirName,
-      mainFile: {
-        name: SKILL_FILE_NAME,
-        body,
-        frontmatter: { ...frontmatter }
-      },
-      otherFiles,
-      global
-    });
-    if (validate) {
-      const result = this.validate();
-      if (!result.success) {
-        throw result.error;
-      }
-    }
-  }
-  static getSettablePaths() {
-    return {
-      relativeDirPath: RULESYNC_SKILLS_RELATIVE_DIR_PATH
-    };
-  }
-  getFrontmatter() {
-    if (!this.mainFile?.frontmatter) {
-      throw new Error("Frontmatter is not defined");
-    }
-    const result = RulesyncSkillFrontmatterSchema.parse(this.mainFile.frontmatter);
-    return result;
-  }
-  getBody() {
-    return this.mainFile?.body ?? "";
-  }
-  validate() {
-    const result = RulesyncSkillFrontmatterSchema.safeParse(this.mainFile?.frontmatter);
-    if (!result.success) {
-      return {
-        success: false,
-        error: new Error(
-          `Invalid frontmatter in ${this.getDirPath()}: ${formatError(result.error)}`
-        )
-      };
-    }
-    return { success: true, error: null };
-  }
-  static async fromDir({
-    baseDir = process.cwd(),
-    relativeDirPath = RULESYNC_SKILLS_RELATIVE_DIR_PATH,
-    dirName,
-    global = false
-  }) {
-    const skillDirPath = (0, import_node_path42.join)(baseDir, relativeDirPath, dirName);
-    const skillFilePath = (0, import_node_path42.join)(skillDirPath, SKILL_FILE_NAME);
-    if (!await fileExists(skillFilePath)) {
-      throw new Error(`${SKILL_FILE_NAME} not found in ${skillDirPath}`);
-    }
-    const fileContent = await readFileContent(skillFilePath);
-    const { frontmatter, body: content } = parseFrontmatter(fileContent);
-    const result = RulesyncSkillFrontmatterSchema.safeParse(frontmatter);
-    if (!result.success) {
-      throw new Error(`Invalid frontmatter in ${skillFilePath}: ${formatError(result.error)}`);
-    }
-    const otherFiles = await this.collectOtherFiles(
-      baseDir,
-      relativeDirPath,
-      dirName,
-      SKILL_FILE_NAME
-    );
-    return new _RulesyncSkill({
-      baseDir,
-      relativeDirPath,
-      dirName,
-      frontmatter: result.data,
-      body: content.trim(),
-      otherFiles,
-      validate: true,
-      global
-    });
-  }
-};
-
 // src/features/skills/tool-skill.ts
-var import_node_path43 = require("path");
 var ToolSkill = class extends AiDir {
   /**
    * Get the settable paths for this tool's skill directories.
@@ -4565,8 +4508,8 @@ var ToolSkill = class extends AiDir {
   }) {
     const settablePaths = getSettablePaths({ global });
     const actualRelativeDirPath = relativeDirPath ?? settablePaths.relativeDirPath;
-    const skillDirPath = (0, import_node_path43.join)(baseDir, actualRelativeDirPath, dirName);
-    const skillFilePath = (0, import_node_path43.join)(skillDirPath, SKILL_FILE_NAME);
+    const skillDirPath = (0, import_node_path42.join)(baseDir, actualRelativeDirPath, dirName);
+    const skillFilePath = (0, import_node_path42.join)(skillDirPath, SKILL_FILE_NAME);
     if (!await fileExists(skillFilePath)) {
       throw new Error(`${SKILL_FILE_NAME} not found in ${skillDirPath}`);
     }
@@ -4590,21 +4533,22 @@ var ToolSkill = class extends AiDir {
   }
 };
 
-// src/features/skills/codexcli-skill.ts
-var CodexCliSkillFrontmatterSchema = import_mini20.z.object({
-  name: import_mini20.z.string(),
-  description: import_mini20.z.string()
+// src/features/skills/simulated-skill.ts
+var SimulatedSkillFrontmatterSchema = import_mini19.z.object({
+  name: import_mini19.z.string(),
+  description: import_mini19.z.string()
 });
-var CodexCliSkill = class _CodexCliSkill extends ToolSkill {
+var SimulatedSkill = class extends ToolSkill {
+  frontmatter;
+  body;
   constructor({
     baseDir = process.cwd(),
-    relativeDirPath = (0, import_node_path44.join)(".codex", "skills"),
+    relativeDirPath,
     dirName,
     frontmatter,
     body,
     otherFiles = [],
-    validate = true,
-    global = false
+    validate = true
   }) {
     super({
       baseDir,
@@ -4616,42 +4560,37 @@ var CodexCliSkill = class _CodexCliSkill extends ToolSkill {
         frontmatter: { ...frontmatter }
       },
       otherFiles,
-      global
+      global: false
+      // Simulated skills are project mode only
     });
     if (validate) {
-      const result = this.validate();
+      const result = SimulatedSkillFrontmatterSchema.safeParse(frontmatter);
       if (!result.success) {
-        throw result.error;
+        throw new Error(
+          `Invalid frontmatter in ${(0, import_node_path43.join)(relativeDirPath, dirName)}: ${formatError(result.error)}`
+        );
       }
     }
+    this.frontmatter = frontmatter;
+    this.body = body;
   }
-  static getSettablePaths({ global = false } = {}) {
-    if (!global) {
-      throw new Error("CodexCliSkill only supports global mode. Please pass { global: true }.");
-    }
-    return {
-      relativeDirPath: (0, import_node_path44.join)(".codex", "skills")
-    };
+  getBody() {
+    return this.body;
   }
   getFrontmatter() {
-    if (!this.mainFile?.frontmatter) {
-      throw new Error("Frontmatter is not defined");
-    }
-    const result = CodexCliSkillFrontmatterSchema.parse(this.mainFile.frontmatter);
-    return result;
+    return this.frontmatter;
   }
-  getBody() {
-    return this.mainFile?.body ?? "";
+  toRulesyncSkill() {
+    throw new Error("Not implemented because it is a SIMULATED skill.");
   }
   validate() {
-    if (!this.mainFile) {
-      return {
-        success: false,
-        error: new Error(`${this.getDirPath()}: ${SKILL_FILE_NAME} file does not exist`)
-      };
+    if (!this.frontmatter) {
+      return { success: true, error: null };
     }
-    const result = CodexCliSkillFrontmatterSchema.safeParse(this.mainFile.frontmatter);
-    if (!result.success) {
+    const result = SimulatedSkillFrontmatterSchema.safeParse(this.frontmatter);
+    if (result.success) {
+      return { success: true, error: null };
+    } else {
       return {
         success: false,
         error: new Error(
@@ -4659,98 +4598,141 @@ var CodexCliSkill = class _CodexCliSkill extends ToolSkill {
         )
       };
     }
-    return { success: true, error: null };
-  }
-  toRulesyncSkill() {
-    const frontmatter = this.getFrontmatter();
-    const rulesyncFrontmatter = {
-      name: frontmatter.name,
-      description: frontmatter.description,
-      targets: ["*"]
-    };
-    return new RulesyncSkill({
-      baseDir: this.baseDir,
-      relativeDirPath: this.relativeDirPath,
-      dirName: this.getDirName(),
-      frontmatter: rulesyncFrontmatter,
-      body: this.getBody(),
-      otherFiles: this.getOtherFiles(),
-      validate: true,
-      global: this.global
-    });
   }
-  static fromRulesyncSkill({
+  static fromRulesyncSkillDefault({
     rulesyncSkill,
-    validate = true,
-    global = false
+    validate = true
   }) {
-    const settablePaths = _CodexCliSkill.getSettablePaths({ global });
     const rulesyncFrontmatter = rulesyncSkill.getFrontmatter();
-    const codexFrontmatter = {
+    const simulatedFrontmatter = {
       name: rulesyncFrontmatter.name,
       description: rulesyncFrontmatter.description
     };
-    return new _CodexCliSkill({
+    return {
       baseDir: rulesyncSkill.getBaseDir(),
-      relativeDirPath: settablePaths.relativeDirPath,
+      relativeDirPath: this.getSettablePaths().relativeDirPath,
       dirName: rulesyncSkill.getDirName(),
-      frontmatter: codexFrontmatter,
+      frontmatter: simulatedFrontmatter,
       body: rulesyncSkill.getBody(),
       otherFiles: rulesyncSkill.getOtherFiles(),
-      validate,
-      global
-    });
-  }
-  static isTargetedByRulesyncSkill(rulesyncSkill) {
-    const targets = rulesyncSkill.getFrontmatter().targets;
-    return targets.includes("*") || targets.includes("codexcli");
+      validate
+    };
   }
-  static async fromDir(params) {
-    const loaded = await this.loadSkillDirContent({
-      ...params,
-      getSettablePaths: _CodexCliSkill.getSettablePaths
-    });
-    const result = CodexCliSkillFrontmatterSchema.safeParse(loaded.frontmatter);
-    if (!result.success) {
-      const skillDirPath = (0, import_node_path44.join)(loaded.baseDir, loaded.relativeDirPath, loaded.dirName);
-      throw new Error(
-        `Invalid frontmatter in ${(0, import_node_path44.join)(skillDirPath, SKILL_FILE_NAME)}: ${formatError(result.error)}`
-      );
+  static async fromDirDefault({
+    baseDir = process.cwd(),
+    relativeDirPath,
+    dirName
+  }) {
+    const settablePaths = this.getSettablePaths();
+    const actualRelativeDirPath = relativeDirPath ?? settablePaths.relativeDirPath;
+    const skillDirPath = (0, import_node_path43.join)(baseDir, actualRelativeDirPath, dirName);
+    const skillFilePath = (0, import_node_path43.join)(skillDirPath, SKILL_FILE_NAME);
+    if (!await fileExists(skillFilePath)) {
+      throw new Error(`${SKILL_FILE_NAME} not found in ${skillDirPath}`);
     }
-    return new _CodexCliSkill({
-      baseDir: loaded.baseDir,
-      relativeDirPath: loaded.relativeDirPath,
-      dirName: loaded.dirName,
+    const fileContent = await readFileContent(skillFilePath);
+    const { frontmatter, body: content } = parseFrontmatter(fileContent);
+    const result = SimulatedSkillFrontmatterSchema.safeParse(frontmatter);
+    if (!result.success) {
+      throw new Error(`Invalid frontmatter in ${skillFilePath}: ${formatError(result.error)}`);
+    }
+    const otherFiles = await this.collectOtherFiles(
+      baseDir,
+      actualRelativeDirPath,
+      dirName,
+      SKILL_FILE_NAME
+    );
+    return {
+      baseDir,
+      relativeDirPath: actualRelativeDirPath,
+      dirName,
       frontmatter: result.data,
-      body: loaded.body,
-      otherFiles: loaded.otherFiles,
-      validate: true,
-      global: loaded.global
+      body: content.trim(),
+      otherFiles,
+      validate: true
+    };
+  }
+  /**
+   * Check if a RulesyncSkill should be converted to this simulated skill type.
+   * Uses the targets field in the RulesyncSkill frontmatter to determine targeting.
+   */
+  static isTargetedByRulesyncSkillDefault({
+    rulesyncSkill,
+    toolTarget
+  }) {
+    const frontmatter = rulesyncSkill.getFrontmatter();
+    const targets = frontmatter.targets;
+    if (targets.includes("*")) {
+      return true;
+    }
+    return targets.includes(toolTarget);
+  }
+  /**
+   * Get the settable paths for this tool's skill directories.
+   * Must be implemented by concrete subclasses.
+   */
+  static getSettablePaths(_options) {
+    throw new Error("Please implement this method in the subclass.");
+  }
+};
+
+// src/features/skills/agentsmd-skill.ts
+var AgentsmdSkill = class _AgentsmdSkill extends SimulatedSkill {
+  static getSettablePaths(options) {
+    if (options?.global) {
+      throw new Error("AgentsmdSkill does not support global mode.");
+    }
+    return {
+      relativeDirPath: (0, import_node_path44.join)(".agents", "skills")
+    };
+  }
+  static async fromDir(params) {
+    const baseParams = await this.fromDirDefault(params);
+    return new _AgentsmdSkill(baseParams);
+  }
+  static fromRulesyncSkill(params) {
+    const baseParams = {
+      ...this.fromRulesyncSkillDefault(params),
+      relativeDirPath: this.getSettablePaths().relativeDirPath
+    };
+    return new _AgentsmdSkill(baseParams);
+  }
+  static isTargetedByRulesyncSkill(rulesyncSkill) {
+    return this.isTargetedByRulesyncSkillDefault({
+      rulesyncSkill,
+      toolTarget: "agentsmd"
     });
   }
 };
 
-// src/features/skills/copilot-skill.ts
+// src/features/skills/codexcli-skill.ts
 var import_node_path46 = require("path");
+var import_mini21 = require("zod/mini");
 
-// src/features/skills/simulated-skill.ts
+// src/features/skills/rulesync-skill.ts
 var import_node_path45 = require("path");
-var import_mini21 = require("zod/mini");
-var SimulatedSkillFrontmatterSchema = import_mini21.z.object({
-  name: import_mini21.z.string(),
-  description: import_mini21.z.string()
+var import_mini20 = require("zod/mini");
+var RulesyncSkillFrontmatterSchemaInternal = import_mini20.z.object({
+  name: import_mini20.z.string(),
+  description: import_mini20.z.string(),
+  targets: import_mini20.z._default(RulesyncTargetsSchema, ["*"]),
+  claudecode: import_mini20.z.optional(
+    import_mini20.z.object({
+      "allowed-tools": import_mini20.z.optional(import_mini20.z.array(import_mini20.z.string()))
+    })
+  )
 });
-var SimulatedSkill = class extends ToolSkill {
-  frontmatter;
-  body;
+var RulesyncSkillFrontmatterSchema = RulesyncSkillFrontmatterSchemaInternal;
+var RulesyncSkill = class _RulesyncSkill extends AiDir {
   constructor({
     baseDir = process.cwd(),
-    relativeDirPath,
+    relativeDirPath = RULESYNC_SKILLS_RELATIVE_DIR_PATH,
     dirName,
     frontmatter,
     body,
     otherFiles = [],
-    validate = true
+    validate = true,
+    global = false
   }) {
     super({
       baseDir,
@@ -4762,37 +4744,33 @@ var SimulatedSkill = class extends ToolSkill {
         frontmatter: { ...frontmatter }
       },
       otherFiles,
-      global: false
-      // Simulated skills are project mode only
+      global
     });
     if (validate) {
-      const result = SimulatedSkillFrontmatterSchema.safeParse(frontmatter);
+      const result = this.validate();
       if (!result.success) {
-        throw new Error(
-          `Invalid frontmatter in ${(0, import_node_path45.join)(relativeDirPath, dirName)}: ${formatError(result.error)}`
-        );
+        throw result.error;
       }
     }
-    this.frontmatter = frontmatter;
-    this.body = body;
   }
-  getBody() {
-    return this.body;
+  static getSettablePaths() {
+    return {
+      relativeDirPath: RULESYNC_SKILLS_RELATIVE_DIR_PATH
+    };
   }
   getFrontmatter() {
-    return this.frontmatter;
+    if (!this.mainFile?.frontmatter) {
+      throw new Error("Frontmatter is not defined");
+    }
+    const result = RulesyncSkillFrontmatterSchema.parse(this.mainFile.frontmatter);
+    return result;
   }
-  toRulesyncSkill() {
-    throw new Error("Not implemented because it is a SIMULATED skill.");
+  getBody() {
+    return this.mainFile?.body ?? "";
   }
   validate() {
-    if (!this.frontmatter) {
-      return { success: true, error: null };
-    }
-    const result = SimulatedSkillFrontmatterSchema.safeParse(this.frontmatter);
-    if (result.success) {
-      return { success: true, error: null };
-    } else {
+    const result = RulesyncSkillFrontmatterSchema.safeParse(this.mainFile?.frontmatter);
+    if (!result.success) {
       return {
         success: false,
         error: new Error(
@@ -4800,92 +4778,193 @@ var SimulatedSkill = class extends ToolSkill {
         )
       };
     }
+    return { success: true, error: null };
   }
-  static fromRulesyncSkillDefault({
-    rulesyncSkill,
-    validate = true
-  }) {
-    const rulesyncFrontmatter = rulesyncSkill.getFrontmatter();
-    const simulatedFrontmatter = {
-      name: rulesyncFrontmatter.name,
-      description: rulesyncFrontmatter.description
-    };
-    return {
-      baseDir: rulesyncSkill.getBaseDir(),
-      relativeDirPath: this.getSettablePaths().relativeDirPath,
-      dirName: rulesyncSkill.getDirName(),
-      frontmatter: simulatedFrontmatter,
-      body: rulesyncSkill.getBody(),
-      otherFiles: rulesyncSkill.getOtherFiles(),
-      validate
-    };
-  }
-  static async fromDirDefault({
+  static async fromDir({
     baseDir = process.cwd(),
-    relativeDirPath,
-    dirName
+    relativeDirPath = RULESYNC_SKILLS_RELATIVE_DIR_PATH,
+    dirName,
+    global = false
   }) {
-    const settablePaths = this.getSettablePaths();
-    const actualRelativeDirPath = relativeDirPath ?? settablePaths.relativeDirPath;
-    const skillDirPath = (0, import_node_path45.join)(baseDir, actualRelativeDirPath, dirName);
+    const skillDirPath = (0, import_node_path45.join)(baseDir, relativeDirPath, dirName);
     const skillFilePath = (0, import_node_path45.join)(skillDirPath, SKILL_FILE_NAME);
     if (!await fileExists(skillFilePath)) {
       throw new Error(`${SKILL_FILE_NAME} not found in ${skillDirPath}`);
     }
     const fileContent = await readFileContent(skillFilePath);
     const { frontmatter, body: content } = parseFrontmatter(fileContent);
-    const result = SimulatedSkillFrontmatterSchema.safeParse(frontmatter);
+    const result = RulesyncSkillFrontmatterSchema.safeParse(frontmatter);
     if (!result.success) {
       throw new Error(`Invalid frontmatter in ${skillFilePath}: ${formatError(result.error)}`);
     }
     const otherFiles = await this.collectOtherFiles(
       baseDir,
-      actualRelativeDirPath,
+      relativeDirPath,
       dirName,
       SKILL_FILE_NAME
     );
-    return {
+    return new _RulesyncSkill({
       baseDir,
-      relativeDirPath: actualRelativeDirPath,
+      relativeDirPath,
       dirName,
       frontmatter: result.data,
       body: content.trim(),
       otherFiles,
-      validate: true
+      validate: true,
+      global
+    });
+  }
+};
+
+// src/features/skills/codexcli-skill.ts
+var CodexCliSkillFrontmatterSchema = import_mini21.z.object({
+  name: import_mini21.z.string(),
+  description: import_mini21.z.string()
+});
+var CodexCliSkill = class _CodexCliSkill extends ToolSkill {
+  constructor({
+    baseDir = process.cwd(),
+    relativeDirPath = (0, import_node_path46.join)(".codex", "skills"),
+    dirName,
+    frontmatter,
+    body,
+    otherFiles = [],
+    validate = true,
+    global = false
+  }) {
+    super({
+      baseDir,
+      relativeDirPath,
+      dirName,
+      mainFile: {
+        name: SKILL_FILE_NAME,
+        body,
+        frontmatter: { ...frontmatter }
+      },
+      otherFiles,
+      global
+    });
+    if (validate) {
+      const result = this.validate();
+      if (!result.success) {
+        throw result.error;
+      }
+    }
+  }
+  static getSettablePaths({ global = false } = {}) {
+    if (!global) {
+      throw new Error("CodexCliSkill only supports global mode. Please pass { global: true }.");
+    }
+    return {
+      relativeDirPath: (0, import_node_path46.join)(".codex", "skills")
     };
   }
-  /**
-   * Check if a RulesyncSkill should be converted to this simulated skill type.
-   * Uses the targets field in the RulesyncSkill frontmatter to determine targeting.
-   */
-  static isTargetedByRulesyncSkillDefault({
+  getFrontmatter() {
+    if (!this.mainFile?.frontmatter) {
+      throw new Error("Frontmatter is not defined");
+    }
+    const result = CodexCliSkillFrontmatterSchema.parse(this.mainFile.frontmatter);
+    return result;
+  }
+  getBody() {
+    return this.mainFile?.body ?? "";
+  }
+  validate() {
+    if (!this.mainFile) {
+      return {
+        success: false,
+        error: new Error(`${this.getDirPath()}: ${SKILL_FILE_NAME} file does not exist`)
+      };
+    }
+    const result = CodexCliSkillFrontmatterSchema.safeParse(this.mainFile.frontmatter);
+    if (!result.success) {
+      return {
+        success: false,
+        error: new Error(
+          `Invalid frontmatter in ${this.getDirPath()}: ${formatError(result.error)}`
+        )
+      };
+    }
+    return { success: true, error: null };
+  }
+  toRulesyncSkill() {
+    const frontmatter = this.getFrontmatter();
+    const rulesyncFrontmatter = {
+      name: frontmatter.name,
+      description: frontmatter.description,
+      targets: ["*"]
+    };
+    return new RulesyncSkill({
+      baseDir: this.baseDir,
+      relativeDirPath: this.relativeDirPath,
+      dirName: this.getDirName(),
+      frontmatter: rulesyncFrontmatter,
+      body: this.getBody(),
+      otherFiles: this.getOtherFiles(),
+      validate: true,
+      global: this.global
+    });
+  }
+  static fromRulesyncSkill({
     rulesyncSkill,
-    toolTarget
+    validate = true,
+    global = false
   }) {
-    const frontmatter = rulesyncSkill.getFrontmatter();
-    const targets = frontmatter.targets;
-    if (targets.includes("*")) {
-      return true;
-    }
-    return targets.includes(toolTarget);
+    const settablePaths = _CodexCliSkill.getSettablePaths({ global });
+    const rulesyncFrontmatter = rulesyncSkill.getFrontmatter();
+    const codexFrontmatter = {
+      name: rulesyncFrontmatter.name,
+      description: rulesyncFrontmatter.description
+    };
+    return new _CodexCliSkill({
+      baseDir: rulesyncSkill.getBaseDir(),
+      relativeDirPath: settablePaths.relativeDirPath,
+      dirName: rulesyncSkill.getDirName(),
+      frontmatter: codexFrontmatter,
+      body: rulesyncSkill.getBody(),
+      otherFiles: rulesyncSkill.getOtherFiles(),
+      validate,
+      global
+    });
   }
-  /**
-   * Get the settable paths for this tool's skill directories.
-   * Must be implemented by concrete subclasses.
-   */
-  static getSettablePaths(_options) {
-    throw new Error("Please implement this method in the subclass.");
+  static isTargetedByRulesyncSkill(rulesyncSkill) {
+    const targets = rulesyncSkill.getFrontmatter().targets;
+    return targets.includes("*") || targets.includes("codexcli");
+  }
+  static async fromDir(params) {
+    const loaded = await this.loadSkillDirContent({
+      ...params,
+      getSettablePaths: _CodexCliSkill.getSettablePaths
+    });
+    const result = CodexCliSkillFrontmatterSchema.safeParse(loaded.frontmatter);
+    if (!result.success) {
+      const skillDirPath = (0, import_node_path46.join)(loaded.baseDir, loaded.relativeDirPath, loaded.dirName);
+      throw new Error(
+        `Invalid frontmatter in ${(0, import_node_path46.join)(skillDirPath, SKILL_FILE_NAME)}: ${formatError(result.error)}`
+      );
+    }
+    return new _CodexCliSkill({
+      baseDir: loaded.baseDir,
+      relativeDirPath: loaded.relativeDirPath,
+      dirName: loaded.dirName,
+      frontmatter: result.data,
+      body: loaded.body,
+      otherFiles: loaded.otherFiles,
+      validate: true,
+      global: loaded.global
+    });
   }
 };
 
 // src/features/skills/copilot-skill.ts
+var import_node_path47 = require("path");
 var CopilotSkill = class _CopilotSkill extends SimulatedSkill {
   static getSettablePaths(options) {
     if (options?.global) {
       throw new Error("CopilotSkill does not support global mode.");
     }
     return {
-      relativeDirPath: (0, import_node_path46.join)(".github", "skills")
+      relativeDirPath: (0, import_node_path47.join)(".github", "skills")
     };
   }
   static async fromDir(params) {
@@ -4908,31 +4987,61 @@ var CopilotSkill = class _CopilotSkill extends SimulatedSkill {
 };
 
 // src/features/skills/cursor-skill.ts
-var import_node_path47 = require("path");
+var import_node_path48 = require("path");
 var CursorSkill = class _CursorSkill extends SimulatedSkill {
   static getSettablePaths(options) {
     if (options?.global) {
-      throw new Error("CursorSkill does not support global mode.");
+      throw new Error("CursorSkill does not support global mode.");
+    }
+    return {
+      relativeDirPath: (0, import_node_path48.join)(".cursor", "skills")
+    };
+  }
+  static async fromDir(params) {
+    const baseParams = await this.fromDirDefault(params);
+    return new _CursorSkill(baseParams);
+  }
+  static fromRulesyncSkill(params) {
+    const baseParams = {
+      ...this.fromRulesyncSkillDefault(params),
+      relativeDirPath: this.getSettablePaths().relativeDirPath
+    };
+    return new _CursorSkill(baseParams);
+  }
+  static isTargetedByRulesyncSkill(rulesyncSkill) {
+    return this.isTargetedByRulesyncSkillDefault({
+      rulesyncSkill,
+      toolTarget: "cursor"
+    });
+  }
+};
+
+// src/features/skills/geminicli-skill.ts
+var import_node_path49 = require("path");
+var GeminiCliSkill = class _GeminiCliSkill extends SimulatedSkill {
+  static getSettablePaths(options) {
+    if (options?.global) {
+      throw new Error("GeminiCliSkill does not support global mode.");
     }
     return {
-      relativeDirPath: (0, import_node_path47.join)(".cursor", "skills")
+      relativeDirPath: (0, import_node_path49.join)(".gemini", "skills")
     };
   }
   static async fromDir(params) {
     const baseParams = await this.fromDirDefault(params);
-    return new _CursorSkill(baseParams);
+    return new _GeminiCliSkill(baseParams);
   }
   static fromRulesyncSkill(params) {
     const baseParams = {
       ...this.fromRulesyncSkillDefault(params),
       relativeDirPath: this.getSettablePaths().relativeDirPath
     };
-    return new _CursorSkill(baseParams);
+    return new _GeminiCliSkill(baseParams);
   }
   static isTargetedByRulesyncSkill(rulesyncSkill) {
     return this.isTargetedByRulesyncSkillDefault({
       rulesyncSkill,
-      toolTarget: "cursor"
+      toolTarget: "geminicli"
     });
   }
 };
@@ -4942,7 +5051,7 @@ var import_node_path52 = require("path");
 var import_mini23 = require("zod/mini");
 
 // src/types/dir-feature-processor.ts
-var import_node_path48 = require("path");
+var import_node_path50 = require("path");
 var DirFeatureProcessor = class {
   baseDir;
   constructor({ baseDir = process.cwd() }) {
@@ -4964,14 +5073,14 @@ var DirFeatureProcessor = class {
       await ensureDir(dirPath);
       const mainFile = aiDir.getMainFile();
       if (mainFile) {
-        const mainFilePath = (0, import_node_path48.join)(dirPath, mainFile.name);
+        const mainFilePath = (0, import_node_path50.join)(dirPath, mainFile.name);
         const content = stringifyFrontmatter(mainFile.body, mainFile.frontmatter);
         const contentWithNewline = addTrailingNewline(content);
         await writeFileContent(mainFilePath, contentWithNewline);
       }
       const otherFiles = aiDir.getOtherFiles();
       for (const file of otherFiles) {
-        const filePath = (0, import_node_path48.join)(dirPath, file.relativeFilePathToDirPath);
+        const filePath = (0, import_node_path50.join)(dirPath, file.relativeFilePathToDirPath);
         const contentWithNewline = addTrailingNewline(file.fileBuffer.toString("utf-8"));
         await writeFileContent(filePath, contentWithNewline);
       }
@@ -4985,38 +5094,8 @@ var DirFeatureProcessor = class {
   }
 };
 
-// src/features/skills/agentsmd-skill.ts
-var import_node_path49 = require("path");
-var AgentsmdSkill = class _AgentsmdSkill extends SimulatedSkill {
-  static getSettablePaths(options) {
-    if (options?.global) {
-      throw new Error("AgentsmdSkill does not support global mode.");
-    }
-    return {
-      relativeDirPath: (0, import_node_path49.join)(".agents", "skills")
-    };
-  }
-  static async fromDir(params) {
-    const baseParams = await this.fromDirDefault(params);
-    return new _AgentsmdSkill(baseParams);
-  }
-  static fromRulesyncSkill(params) {
-    const baseParams = {
-      ...this.fromRulesyncSkillDefault(params),
-      relativeDirPath: this.getSettablePaths().relativeDirPath
-    };
-    return new _AgentsmdSkill(baseParams);
-  }
-  static isTargetedByRulesyncSkill(rulesyncSkill) {
-    return this.isTargetedByRulesyncSkillDefault({
-      rulesyncSkill,
-      toolTarget: "agentsmd"
-    });
-  }
-};
-
 // src/features/skills/claudecode-skill.ts
-var import_node_path50 = require("path");
+var import_node_path51 = require("path");
 var import_mini22 = require("zod/mini");
 var ClaudecodeSkillFrontmatterSchema = import_mini22.z.object({
   name: import_mini22.z.string(),
@@ -5026,7 +5105,7 @@ var ClaudecodeSkillFrontmatterSchema = import_mini22.z.object({
 var ClaudecodeSkill = class _ClaudecodeSkill extends ToolSkill {
   constructor({
     baseDir = process.cwd(),
-    relativeDirPath = (0, import_node_path50.join)(".claude", "skills"),
+    relativeDirPath = (0, import_node_path51.join)(".claude", "skills"),
     dirName,
     frontmatter,
     body,
@@ -5057,7 +5136,7 @@ var ClaudecodeSkill = class _ClaudecodeSkill extends ToolSkill {
     global: _global = false
   } = {}) {
     return {
-      relativeDirPath: (0, import_node_path50.join)(".claude", "skills")
+      relativeDirPath: (0, import_node_path51.join)(".claude", "skills")
     };
   }
   getFrontmatter() {
@@ -5144,9 +5223,9 @@ var ClaudecodeSkill = class _ClaudecodeSkill extends ToolSkill {
     });
     const result = ClaudecodeSkillFrontmatterSchema.safeParse(loaded.frontmatter);
     if (!result.success) {
-      const skillDirPath = (0, import_node_path50.join)(loaded.baseDir, loaded.relativeDirPath, loaded.dirName);
+      const skillDirPath = (0, import_node_path51.join)(loaded.baseDir, loaded.relativeDirPath, loaded.dirName);
       throw new Error(
-        `Invalid frontmatter in ${(0, import_node_path50.join)(skillDirPath, SKILL_FILE_NAME)}: ${formatError(result.error)}`
+        `Invalid frontmatter in ${(0, import_node_path51.join)(skillDirPath, SKILL_FILE_NAME)}: ${formatError(result.error)}`
       );
     }
     return new _ClaudecodeSkill({
@@ -5162,36 +5241,6 @@ var ClaudecodeSkill = class _ClaudecodeSkill extends ToolSkill {
   }
 };
 
-// src/features/skills/geminicli-skill.ts
-var import_node_path51 = require("path");
-var GeminiCliSkill = class _GeminiCliSkill extends SimulatedSkill {
-  static getSettablePaths(options) {
-    if (options?.global) {
-      throw new Error("GeminiCliSkill does not support global mode.");
-    }
-    return {
-      relativeDirPath: (0, import_node_path51.join)(".gemini", "skills")
-    };
-  }
-  static async fromDir(params) {
-    const baseParams = await this.fromDirDefault(params);
-    return new _GeminiCliSkill(baseParams);
-  }
-  static fromRulesyncSkill(params) {
-    const baseParams = {
-      ...this.fromRulesyncSkillDefault(params),
-      relativeDirPath: this.getSettablePaths().relativeDirPath
-    };
-    return new _GeminiCliSkill(baseParams);
-  }
-  static isTargetedByRulesyncSkill(rulesyncSkill) {
-    return this.isTargetedByRulesyncSkillDefault({
-      rulesyncSkill,
-      toolTarget: "geminicli"
-    });
-  }
-};
-
 // src/features/skills/skills-processor.ts
 var skillsProcessorToolTargetTuple = [
   "agentsmd",
@@ -8005,33 +8054,196 @@ var rulesProcessorToolTargets = [
   "windsurf"
 ];
 var RulesProcessorToolTargetSchema = import_mini33.z.enum(rulesProcessorToolTargets);
-var rulesProcessorToolTargetsGlobal = [
-  "claudecode",
-  "claudecode-legacy",
-  "codexcli",
-  "geminicli"
-];
 var toolRuleFactories = /* @__PURE__ */ new Map([
-  ["agentsmd", { class: AgentsMdRule, meta: { extension: "md" } }],
-  ["amazonqcli", { class: AmazonQCliRule, meta: { extension: "md" } }],
-  ["antigravity", { class: AntigravityRule, meta: { extension: "md" } }],
-  ["augmentcode", { class: AugmentcodeRule, meta: { extension: "md" } }],
-  ["augmentcode-legacy", { class: AugmentcodeLegacyRule, meta: { extension: "md" } }],
-  ["claudecode", { class: ClaudecodeRule, meta: { extension: "md" } }],
-  ["claudecode-legacy", { class: ClaudecodeLegacyRule, meta: { extension: "md" } }],
-  ["cline", { class: ClineRule, meta: { extension: "md" } }],
-  ["codexcli", { class: CodexcliRule, meta: { extension: "md" } }],
-  ["copilot", { class: CopilotRule, meta: { extension: "md" } }],
-  ["cursor", { class: CursorRule, meta: { extension: "mdc" } }],
-  ["geminicli", { class: GeminiCliRule, meta: { extension: "md" } }],
-  ["junie", { class: JunieRule, meta: { extension: "md" } }],
-  ["kiro", { class: KiroRule, meta: { extension: "md" } }],
-  ["opencode", { class: OpenCodeRule, meta: { extension: "md" } }],
-  ["qwencode", { class: QwencodeRule, meta: { extension: "md" } }],
-  ["roo", { class: RooRule, meta: { extension: "md" } }],
-  ["warp", { class: WarpRule, meta: { extension: "md" } }],
-  ["windsurf", { class: WindsurfRule, meta: { extension: "md" } }]
+  [
+    "agentsmd",
+    {
+      class: AgentsMdRule,
+      meta: {
+        extension: "md",
+        supportsGlobal: false,
+        ruleDiscoveryMode: "toon",
+        additionalConventions: {
+          commands: { commandClass: AgentsmdCommand },
+          subagents: { subagentClass: AgentsmdSubagent },
+          skills: { skillClass: AgentsmdSkill }
+        }
+      }
+    }
+  ],
+  [
+    "amazonqcli",
+    {
+      class: AmazonQCliRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "auto" }
+    }
+  ],
+  [
+    "antigravity",
+    {
+      class: AntigravityRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "auto" }
+    }
+  ],
+  [
+    "augmentcode",
+    {
+      class: AugmentcodeRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "auto" }
+    }
+  ],
+  [
+    "augmentcode-legacy",
+    {
+      class: AugmentcodeLegacyRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "toon" }
+    }
+  ],
+  [
+    "claudecode",
+    {
+      class: ClaudecodeRule,
+      meta: { extension: "md", supportsGlobal: true, ruleDiscoveryMode: "auto" }
+    }
+  ],
+  [
+    "claudecode-legacy",
+    {
+      class: ClaudecodeLegacyRule,
+      meta: { extension: "md", supportsGlobal: true, ruleDiscoveryMode: "claudecode-legacy" }
+    }
+  ],
+  [
+    "cline",
+    {
+      class: ClineRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "auto" }
+    }
+  ],
+  [
+    "codexcli",
+    {
+      class: CodexcliRule,
+      meta: {
+        extension: "md",
+        supportsGlobal: true,
+        ruleDiscoveryMode: "toon",
+        additionalConventions: {
+          subagents: { subagentClass: CodexCliSubagent },
+          skills: { skillClass: CodexCliSkill, globalOnly: true }
+        }
+      }
+    }
+  ],
+  [
+    "copilot",
+    {
+      class: CopilotRule,
+      meta: {
+        extension: "md",
+        supportsGlobal: false,
+        ruleDiscoveryMode: "auto",
+        additionalConventions: {
+          commands: { commandClass: CopilotCommand },
+          subagents: { subagentClass: CopilotSubagent },
+          skills: { skillClass: CopilotSkill }
+        }
+      }
+    }
+  ],
+  [
+    "cursor",
+    {
+      class: CursorRule,
+      meta: {
+        extension: "mdc",
+        supportsGlobal: false,
+        ruleDiscoveryMode: "auto",
+        additionalConventions: {
+          commands: { commandClass: CursorCommand },
+          subagents: { subagentClass: CursorSubagent },
+          skills: { skillClass: CursorSkill }
+        },
+        createsSeparateConventionsRule: true
+      }
+    }
+  ],
+  [
+    "geminicli",
+    {
+      class: GeminiCliRule,
+      meta: {
+        extension: "md",
+        supportsGlobal: true,
+        ruleDiscoveryMode: "toon",
+        additionalConventions: {
+          commands: { commandClass: GeminiCliCommand },
+          subagents: { subagentClass: GeminiCliSubagent },
+          skills: { skillClass: GeminiCliSkill }
+        }
+      }
+    }
+  ],
+  [
+    "junie",
+    {
+      class: JunieRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "toon" }
+    }
+  ],
+  [
+    "kiro",
+    {
+      class: KiroRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "toon" }
+    }
+  ],
+  [
+    "opencode",
+    {
+      class: OpenCodeRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "toon" }
+    }
+  ],
+  [
+    "qwencode",
+    {
+      class: QwencodeRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "toon" }
+    }
+  ],
+  [
+    "roo",
+    {
+      class: RooRule,
+      meta: {
+        extension: "md",
+        supportsGlobal: false,
+        ruleDiscoveryMode: "auto",
+        additionalConventions: {
+          commands: { commandClass: RooCommand },
+          subagents: { subagentClass: RooSubagent }
+        },
+        createsSeparateConventionsRule: true
+      }
+    }
+  ],
+  [
+    "warp",
+    {
+      class: WarpRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "toon" }
+    }
+  ],
+  [
+    "windsurf",
+    {
+      class: WindsurfRule,
+      meta: { extension: "md", supportsGlobal: false, ruleDiscoveryMode: "auto" }
+    }
+  ]
 ]);
+var rulesProcessorToolTargetsGlobal = Array.from(toolRuleFactories.entries()).filter(([_, factory]) => factory.meta.supportsGlobal).map(([target]) => target);
 var defaultGetFactory6 = (target) => {
   const factory = toolRuleFactories.get(target);
   if (!factory) {
@@ -8046,6 +8258,7 @@ var RulesProcessor = class extends FeatureProcessor {
   simulateSkills;
   global;
   getFactory;
+  skills;
   constructor({
     baseDir = process.cwd(),
     toolTarget,
@@ -8053,7 +8266,8 @@ var RulesProcessor = class extends FeatureProcessor {
     simulateSubagents = false,
     simulateSkills = false,
     global = false,
-    getFactory = defaultGetFactory6
+    getFactory = defaultGetFactory6,
+    skills
   }) {
     super({ baseDir });
     const result = RulesProcessorToolTargetSchema.safeParse(toolTarget);
@@ -8068,12 +8282,14 @@ var RulesProcessor = class extends FeatureProcessor {
     this.simulateSubagents = simulateSubagents;
     this.simulateSkills = simulateSkills;
     this.getFactory = getFactory;
+    this.skills = skills;
   }
   async convertRulesyncFilesToToolFiles(rulesyncFiles) {
     const rulesyncRules = rulesyncFiles.filter(
       (file) => file instanceof RulesyncRule
     );
     const factory = this.getFactory(this.toolTarget);
+    const { meta } = factory;
     const toolRules = rulesyncRules.map((rulesyncRule) => {
       if (!factory.class.isTargetedByRulesyncRule(rulesyncRule)) {
         return null;
@@ -8086,153 +8302,105 @@ var RulesProcessor = class extends FeatureProcessor {
       });
     }).filter((rule) => rule !== null);
     const isSimulated = this.simulateCommands || this.simulateSubagents || this.simulateSkills;
-    if (isSimulated && this.toolTarget === "cursor") {
-      toolRules.push(
-        new CursorRule({
-          baseDir: this.baseDir,
-          frontmatter: {
-            alwaysApply: true
-          },
-          body: this.generateAdditionalConventionsSection({
-            commands: { relativeDirPath: CursorCommand.getSettablePaths().relativeDirPath },
-            subagents: {
-              relativeDirPath: CursorSubagent.getSettablePaths().relativeDirPath
-            },
-            skills: {
-              relativeDirPath: CursorSkill.getSettablePaths().relativeDirPath
-            }
-          }),
-          relativeDirPath: CursorRule.getSettablePaths().nonRoot.relativeDirPath,
-          relativeFilePath: "additional-conventions.mdc",
-          validate: true
-        })
-      );
-    }
-    if (isSimulated && this.toolTarget === "roo") {
-      toolRules.push(
-        new RooRule({
-          baseDir: this.baseDir,
-          relativeDirPath: RooRule.getSettablePaths().nonRoot.relativeDirPath,
-          relativeFilePath: "additional-conventions.md",
-          fileContent: this.generateAdditionalConventionsSection({
-            commands: { relativeDirPath: RooCommand.getSettablePaths().relativeDirPath },
-            subagents: {
-              relativeDirPath: RooSubagent.getSettablePaths().relativeDirPath
-            }
-          }),
-          validate: true
-        })
-      );
+    if (isSimulated && meta.createsSeparateConventionsRule && meta.additionalConventions) {
+      const conventionsContent = this.generateAdditionalConventionsSectionFromMeta(meta);
+      const settablePaths = factory.class.getSettablePaths();
+      const nonRootPath = "nonRoot" in settablePaths ? settablePaths.nonRoot : null;
+      if (nonRootPath) {
+        toolRules.push(
+          factory.class.fromRulesyncRule({
+            baseDir: this.baseDir,
+            rulesyncRule: new RulesyncRule({
+              baseDir: this.baseDir,
+              relativeDirPath: nonRootPath.relativeDirPath,
+              relativeFilePath: "additional-conventions.md",
+              frontmatter: {
+                root: false,
+                targets: [this.toolTarget]
+              },
+              body: conventionsContent
+            }),
+            validate: true,
+            global: this.global
+          })
+        );
+      }
     }
     const rootRuleIndex = toolRules.findIndex((rule) => rule.isRoot());
     if (rootRuleIndex === -1) {
       return toolRules;
     }
-    switch (this.toolTarget) {
-      case "agentsmd": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + this.generateAdditionalConventionsSection({
-            commands: { relativeDirPath: AgentsmdCommand.getSettablePaths().relativeDirPath },
-            subagents: {
-              relativeDirPath: AgentsmdSubagent.getSettablePaths().relativeDirPath
-            }
-          }) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "augmentcode-legacy": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "claudecode": {
-        return toolRules;
-      }
-      case "claudecode-legacy": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateReferencesSection(toolRules) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "codexcli": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + this.generateAdditionalConventionsSection({
-            subagents: {
-              relativeDirPath: CodexCliSubagent.getSettablePaths().relativeDirPath
-            },
-            // Codex CLI skills are only supported in global mode
-            ...this.global && {
-              skills: {
-                relativeDirPath: CodexCliSkill.getSettablePaths({ global: this.global }).relativeDirPath
-              }
-            }
-          }) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "copilot": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateAdditionalConventionsSection({
-            commands: { relativeDirPath: CopilotCommand.getSettablePaths().relativeDirPath },
-            subagents: {
-              relativeDirPath: CopilotSubagent.getSettablePaths().relativeDirPath
-            },
-            skills: {
-              relativeDirPath: CopilotSkill.getSettablePaths().relativeDirPath
-            }
-          }) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "geminicli": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + this.generateAdditionalConventionsSection({
-            commands: { relativeDirPath: GeminiCliCommand.getSettablePaths().relativeDirPath },
-            subagents: {
-              relativeDirPath: GeminiCliSubagent.getSettablePaths().relativeDirPath
-            }
-          }) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "kiro": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "opencode": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "qwencode": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
-      case "warp": {
-        const rootRule = toolRules[rootRuleIndex];
-        rootRule?.setFileContent(
-          this.generateToonReferencesSection(toolRules) + rootRule.getFileContent()
-        );
-        return toolRules;
-      }
+    const rootRule = toolRules[rootRuleIndex];
+    if (!rootRule) {
+      return toolRules;
+    }
+    const referenceSection = this.generateReferenceSectionFromMeta(meta, toolRules);
+    const conventionsSection = !meta.createsSeparateConventionsRule && meta.additionalConventions ? this.generateAdditionalConventionsSectionFromMeta(meta) : "";
+    const newContent = referenceSection + conventionsSection + rootRule.getFileContent();
+    rootRule.setFileContent(newContent);
+    return toolRules;
+  }
+  buildSkillList(skillClass) {
+    if (!this.skills) return [];
+    const toolRelativeDirPath = skillClass.getSettablePaths({
+      global: this.global
+    }).relativeDirPath;
+    return this.skills.filter((skill) => skillClass.isTargetedByRulesyncSkill(skill)).map((skill) => {
+      const frontmatter = skill.getFrontmatter();
+      const relativePath = (0, import_node_path84.join)(toolRelativeDirPath, skill.getDirName(), SKILL_FILE_NAME);
+      return {
+        name: frontmatter.name,
+        description: frontmatter.description,
+        path: relativePath
+      };
+    });
+  }
+  /**
+   * Generate reference section based on meta configuration.
+   */
+  generateReferenceSectionFromMeta(meta, toolRules) {
+    switch (meta.ruleDiscoveryMode) {
+      case "toon":
+        return this.generateToonReferencesSection(toolRules);
+      case "claudecode-legacy":
+        return this.generateReferencesSection(toolRules);
+      case "auto":
       default:
-        return toolRules;
+        return "";
+    }
+  }
+  /**
+   * Generate additional conventions section based on meta configuration.
+   */
+  generateAdditionalConventionsSectionFromMeta(meta) {
+    const { additionalConventions } = meta;
+    if (!additionalConventions) {
+      return "";
+    }
+    const conventions = {};
+    if (additionalConventions.commands) {
+      const { commandClass } = additionalConventions.commands;
+      const relativeDirPath = commandClass.getSettablePaths({
+        global: this.global
+      }).relativeDirPath;
+      conventions.commands = { relativeDirPath };
+    }
+    if (additionalConventions.subagents) {
+      const { subagentClass } = additionalConventions.subagents;
+      const relativeDirPath = subagentClass.getSettablePaths({
+        global: this.global
+      }).relativeDirPath;
+      conventions.subagents = { relativeDirPath };
     }
+    if (additionalConventions.skills) {
+      const { skillClass, globalOnly } = additionalConventions.skills;
+      if (!globalOnly || this.global) {
+        conventions.skills = {
+          skillList: this.buildSkillList(skillClass)
+        };
+      }
+    }
+    return this.generateAdditionalConventionsSection(conventions);
   }
   async convertToolFilesToRulesyncFiles(toolFiles) {
     const toolRules = toolFiles.filter((file) => file instanceof ToolRule);
@@ -8417,15 +8585,7 @@ Simulated subagents are specialized AI assistants that can be invoked to handle
 When users call a simulated subagent, it will look for the corresponding markdown file, \`${(0, import_node_path84.join)(RULESYNC_SUBAGENTS_RELATIVE_DIR_PATH, "{subagent}.md")}\`, and execute its contents as the block of operations.
 
 For example, if the user instructs \`Call planner subagent to plan the refactoring\`, you have to look for the markdown file, \`${(0, import_node_path84.join)(RULESYNC_SUBAGENTS_RELATIVE_DIR_PATH, "planner.md")}\`, and execute its contents as the block of operations.` : "";
-    const skillsSection = skills ? `## Simulated Skills
-
-Simulated skills are specialized capabilities that can be invoked to handle specific types of tasks.
-
-When users invoke a simulated skill, look for the corresponding SKILL.md file in \`${(0, import_node_path84.join)(RULESYNC_SKILLS_RELATIVE_DIR_PATH, "{skill}/SKILL.md")}\` and execute its contents as the block of operations.
-
-For example, if the user instructs \`Use the skill example-skill to achieve something\`, look for \`${(0, import_node_path84.join)(RULESYNC_SKILLS_RELATIVE_DIR_PATH, "example-skill/SKILL.md")}\` and execute its contents.
-
-Additionally, you should proactively consider using available skills when they would help accomplish a task more effectively, even if the user doesn't explicitly request them.` : "";
+    const skillsSection = skills ? this.generateSkillsSection(skills) : "";
     const result = [
       overview,
       ...this.simulateCommands && CommandsProcessor.getToolTargetsSimulated().includes(this.toolTarget) ? [commandsSection] : [],
@@ -8434,6 +8594,21 @@ Additionally, you should proactively consider using available skills when they w
     ].join("\n\n") + "\n\n";
     return result;
   }
+  generateSkillsSection(skills) {
+    if (!skills.skillList || skills.skillList.length === 0) {
+      return "";
+    }
+    const skillListWithAtPrefix = skills.skillList.map((skill) => ({
+      ...skill,
+      path: `@${skill.path}`
+    }));
+    const toonContent = (0, import_toon.encode)({ skillList: skillListWithAtPrefix });
+    return `## Simulated Skills
+
+Simulated skills are specialized capabilities that can be invoked to handle specific types of tasks. When you determine that a skill would be helpful for the current task, read the corresponding SKILL.md file and execute its instructions.
+
+${toonContent}`;
+  }
 };
 
 // src/cli/commands/generate.ts
@@ -8446,13 +8621,15 @@ async function generateCommand(options) {
     process.exit(1);
   }
   logger.info(`Base directories: ${config.getBaseDirs().join(", ")}`);
-  const totalRulesOutputs = await generateRules(config);
   const totalIgnoreOutputs = await generateIgnore(config);
   const totalMcpOutputs = await generateMcp(config);
   const totalCommandOutputs = await generateCommands(config);
   const totalSubagentOutputs = await generateSubagents(config);
-  const totalSkillOutputs = await generateSkills(config);
-  const totalGenerated = totalRulesOutputs + totalMcpOutputs + totalCommandOutputs + totalIgnoreOutputs + totalSubagentOutputs + totalSkillOutputs;
+  const skillsResult = await generateSkills(config);
+  const totalRulesOutputs = await generateRules(config, {
+    skills: skillsResult.skills
+  });
+  const totalGenerated = totalRulesOutputs + totalMcpOutputs + totalCommandOutputs + totalIgnoreOutputs + totalSubagentOutputs + skillsResult.totalOutputs;
   if (totalGenerated === 0) {
     const enabledFeatures = config.getFeatures().join(", ");
     logger.warn(`\u26A0\uFE0F  No files generated for enabled features: ${enabledFeatures}`);
@@ -8465,11 +8642,11 @@ async function generateCommand(options) {
     if (totalMcpOutputs > 0) parts.push(`${totalMcpOutputs} MCP files`);
     if (totalCommandOutputs > 0) parts.push(`${totalCommandOutputs} commands`);
     if (totalSubagentOutputs > 0) parts.push(`${totalSubagentOutputs} subagents`);
-    if (totalSkillOutputs > 0) parts.push(`${totalSkillOutputs} skills`);
+    if (skillsResult.totalOutputs > 0) parts.push(`${skillsResult.totalOutputs} skills`);
     logger.success(`\u{1F389} All done! Generated ${totalGenerated} file(s) total (${parts.join(" + ")})`);
   }
 }
-async function generateRules(config) {
+async function generateRules(config, options) {
   if (!config.getFeatures().includes("rules")) {
     logger.debug("Skipping rule generation (not in --features)");
     return 0;
@@ -8488,7 +8665,8 @@ async function generateRules(config) {
         global: config.getGlobal(),
         simulateCommands: config.getSimulateCommands(),
         simulateSubagents: config.getSimulateSubagents(),
-        simulateSkills: config.getSimulateSkills()
+        simulateSkills: config.getSimulateSkills(),
+        skills: options?.skills
       });
       if (config.getDelete()) {
         const oldToolFiles = await processor.loadToolFiles({ forDeletion: true });
@@ -8652,9 +8830,10 @@ async function generateSubagents(config) {
 async function generateSkills(config) {
   if (!config.getFeatures().includes("skills")) {
     logger.debug("Skipping skill generation (not in --features)");
-    return 0;
+    return { totalOutputs: 0, skills: [] };
   }
   let totalSkillOutputs = 0;
+  const allSkills = [];
   logger.info("Generating skill files...");
   const toolTargets = (0, import_es_toolkit2.intersection)(
     config.getTargets(),
@@ -8675,13 +8854,18 @@ async function generateSkills(config) {
         await processor.removeAiDirs(oldToolDirs);
       }
       const rulesyncDirs = await processor.loadRulesyncDirs();
+      for (const rulesyncDir of rulesyncDirs) {
+        if (rulesyncDir instanceof RulesyncSkill) {
+          allSkills.push(rulesyncDir);
+        }
+      }
       const toolDirs = await processor.convertRulesyncDirsToToolDirs(rulesyncDirs);
       const writtenCount = await processor.writeAiDirs(toolDirs);
       totalSkillOutputs += writtenCount;
       logger.success(`Generated ${writtenCount} ${toolTarget} skill(s) in ${baseDir}`);
     }
   }
-  return totalSkillOutputs;
+  return { totalOutputs: totalSkillOutputs, skills: allSkills };
 }
 
 // src/cli/commands/gitignore.ts
@@ -10249,7 +10433,7 @@ async function mcpCommand({ version }) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "3.32.0";
+var getVersion = () => "3.33.0";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();