prpm 2.1.16 → 2.1.17

package/dist/index.js

@@ -8645,6 +8645,96 @@ var init_from_zed = __esm({
   }
 });
 
+// ../converters/dist/from-codex.js
+function parseFrontmatter8(content) {
+  const normalizedContent = content.replace(/\r\n/g, "\n");
+  const match = normalizedContent.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) {
+    return { frontmatter: {}, body: normalizedContent };
+  }
+  try {
+    const frontmatter = jsYaml.load(match[1]);
+    const body = match[2];
+    return { frontmatter: frontmatter || {}, body };
+  } catch (error) {
+    return { frontmatter: {}, body: normalizedContent };
+  }
+}
+function parseAllowedTools(toolsString) {
+  return toolsString.split(/\s+/).filter(Boolean).map((tool) => {
+    const match = tool.match(/^([A-Za-z]+)(?:\([^)]*\))?$/);
+    return match ? match[1] : tool;
+  }).filter((tool, index, arr) => arr.indexOf(tool) === index);
+}
+function fromCodex(content, metadata) {
+  const { frontmatter, body } = parseFrontmatter8(content);
+  const fm = frontmatter;
+  const sections = [];
+  const metadataSection = {
+    type: "metadata",
+    data: {
+      title: fm.name || metadata.name || metadata.id,
+      description: fm.description || metadata.description || "",
+      version: metadata.version || "1.0.0",
+      author: metadata.author
+    }
+  };
+  metadataSection.data.agentSkills = {
+    name: fm.name,
+    license: fm.license,
+    compatibility: fm.compatibility,
+    allowedTools: fm["allowed-tools"],
+    metadata: fm.metadata
+  };
+  sections.push(metadataSection);
+  if (fm["allowed-tools"]) {
+    const tools = parseAllowedTools(fm["allowed-tools"]);
+    if (tools.length > 0) {
+      const toolsSection = {
+        type: "tools",
+        tools,
+        description: "Pre-approved tools for this skill"
+      };
+      sections.push(toolsSection);
+    }
+  }
+  if (body.trim()) {
+    sections.push({
+      type: "instructions",
+      title: "Instructions",
+      content: body.trim()
+    });
+  }
+  const canonicalContent = {
+    format: "canonical",
+    version: "1.0",
+    sections
+  };
+  const pkg = {
+    ...metadata,
+    id: metadata.id,
+    name: fm.name || metadata.name || metadata.id,
+    version: metadata.version,
+    author: metadata.author,
+    description: fm.description || metadata.description || "",
+    license: fm.license || metadata.license,
+    tags: metadata.tags || [],
+    format: "codex",
+    subtype: "skill",
+    content: canonicalContent
+  };
+  setTaxonomy(pkg, "codex", "skill");
+  return pkg;
+}
+var init_from_codex = __esm({
+  "../converters/dist/from-codex.js"() {
+    "use strict";
+    init_cjs_shims();
+    init_taxonomy_utils();
+    init_js_yaml();
+  }
+});
+
 // ../converters/dist/from-mcp-server.js
 function fromMCPServer(mcpServerJson, metadata) {
   var _a;
@@ -8758,7 +8848,7 @@ function loadSchema(format, subtype) {
       "claude:slash-command": "claude-slash-command.schema.json",
       "claude:hook": "claude-hook.schema.json",
       "claude:plugin": "claude-plugin.schema.json",
-      "copilot:skill": "copilot-skill.schema.json",
+      "copilot:skill": "agent-skills.schema.json",
       "cursor:slash-command": "cursor-command.schema.json",
       "cursor:hook": "cursor-hooks.schema.json",
       // cursor + hook subtype uses cursor-hooks schema
@@ -8769,6 +8859,7 @@ function loadSchema(format, subtype) {
       "droid:hook": "droid-hook.schema.json",
       "opencode:slash-command": "opencode-slash-command.schema.json",
       "opencode:plugin": "opencode-plugin.schema.json",
+      "codex:skill": "agent-skills.schema.json",
       "gemini:extension": "gemini-extension.schema.json",
       "mcp:server": "mcp-server.schema.json"
     };
@@ -9875,17 +9966,19 @@ ${content}`;
 function convertToSkill(pkg, config, warnings) {
   var _a, _b;
   let qualityScore = 100;
-  const skillName = config.skillName || ((_a = pkg.name) == null ? void 0 : _a.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 64)) || pkg.id.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 64);
+  const metadataSection = pkg.content.sections.find((s) => s.type === "metadata");
+  const agentSkillsData = (metadataSection == null ? void 0 : metadataSection.type) === "metadata" ? metadataSection.data.agentSkills : void 0;
+  const skillName = (agentSkillsData == null ? void 0 : agentSkillsData.name) || config.skillName || ((_a = pkg.name) == null ? void 0 : _a.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 64)) || pkg.id.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 64);
   const skillDescription = config.skillDescription || pkg.description || ((_b = pkg.metadata) == null ? void 0 : _b.description) || "";
   if (!skillDescription) {
     warnings.push("Skill requires a description - using empty string");
     qualityScore -= 20;
   }
-  if (!/^[a-z0-9-]+$/.test(skillName)) {
-    warnings.push("Skill name should be lowercase with hyphens only");
+  if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(skillName)) {
+    warnings.push("Skill name should be lowercase alphanumeric with single hyphens (no start/end/consecutive hyphens)");
     qualityScore -= 10;
   }
-  const frontmatter = generateSkillFrontmatter(skillName, skillDescription);
+  const frontmatter = generateSkillFrontmatter(skillName, skillDescription, pkg, agentSkillsData);
   const content = convertSkillContent(pkg, warnings);
   const fullContent = `${frontmatter}
 
@@ -9902,12 +9995,28 @@ ${content}`;
     qualityScore
   };
 }
-function generateSkillFrontmatter(name, description) {
+function generateSkillFrontmatter(name, description, pkg, agentSkillsData) {
   const lines = ["---"];
   lines.push(`name: ${name}`);
   const truncatedDesc = description.length > 1024 ? description.slice(0, 1021) + "..." : description;
   const quotedDesc = `"${truncatedDesc.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\r/g, "\\r").replace(/\n/g, "\\n")}"`;
   lines.push(`description: ${quotedDesc}`);
+  const license = (agentSkillsData == null ? void 0 : agentSkillsData.license) || pkg.license;
+  if (license) {
+    lines.push(`license: ${license}`);
+  }
+  if (agentSkillsData == null ? void 0 : agentSkillsData.compatibility) {
+    lines.push(`compatibility: "${agentSkillsData.compatibility}"`);
+  }
+  if (agentSkillsData == null ? void 0 : agentSkillsData.allowedTools) {
+    lines.push(`allowed-tools: ${agentSkillsData.allowedTools}`);
+  }
+  if ((agentSkillsData == null ? void 0 : agentSkillsData.metadata) && Object.keys(agentSkillsData.metadata).length > 0) {
+    lines.push("metadata:");
+    for (const [key, value] of Object.entries(agentSkillsData.metadata)) {
+      lines.push(`  ${key}: "${value}"`);
+    }
+  }
   lines.push("---");
   return lines.join("\n");
 }
@@ -12297,9 +12406,12 @@ function toCodex(pkg, options = {}) {
   let qualityScore = 100;
   try {
     const config = options.codexConfig || {};
+    const isSkill = pkg.subtype === "skill";
     const isSlashCommand = pkg.subtype === "slash-command";
     let content;
-    if (isSlashCommand) {
+    if (isSkill && !config.forceAgentsMd) {
+      content = convertToSkillMd(pkg, warnings);
+    } else if (isSlashCommand) {
       content = convertSlashCommandToSection(pkg, warnings);
       if (config.appendMode && config.existingContent) {
         content = appendToExistingAgentsMd(config.existingContent, content, pkg.name);
@@ -12329,6 +12441,74 @@ function toCodex(pkg, options = {}) {
     };
   }
 }
+function convertToSkillMd(pkg, warnings) {
+  var _a;
+  const lines = [];
+  const metadataSection = pkg.content.sections.find((s) => s.type === "metadata");
+  const toolsSection = pkg.content.sections.find((s) => s.type === "tools");
+  const title = ((_a = pkg.metadata) == null ? void 0 : _a.title) || pkg.name;
+  const description = pkg.description || "";
+  const frontmatter = {
+    name: slugify(title),
+    description: truncateDescription(description, 1024)
+  };
+  if (pkg.license) {
+    frontmatter.license = pkg.license;
+  }
+  if ((metadataSection == null ? void 0 : metadataSection.type) === "metadata" && metadataSection.data.agentSkills) {
+    const skillsData = metadataSection.data.agentSkills;
+    if (skillsData.name) {
+      frontmatter.name = skillsData.name;
+    }
+    if (skillsData.license) {
+      frontmatter.license = skillsData.license;
+    }
+    if (skillsData.compatibility) {
+      frontmatter.compatibility = skillsData.compatibility;
+    }
+    if (skillsData.allowedTools) {
+      frontmatter["allowed-tools"] = skillsData.allowedTools;
+    }
+    if (skillsData.metadata && Object.keys(skillsData.metadata).length > 0) {
+      frontmatter.metadata = skillsData.metadata;
+    }
+  }
+  if ((toolsSection == null ? void 0 : toolsSection.type) === "tools" && toolsSection.tools.length > 0 && !frontmatter["allowed-tools"]) {
+    frontmatter["allowed-tools"] = toolsSection.tools.join(" ");
+  }
+  lines.push("---");
+  lines.push(jsYaml.dump(frontmatter, { indent: 2, lineWidth: -1 }).trim());
+  lines.push("---");
+  lines.push("");
+  for (const section of pkg.content.sections) {
+    if (section.type === "metadata")
+      continue;
+    if (section.type === "tools")
+      continue;
+    if (section.type === "persona") {
+      warnings.push("Persona section skipped (not supported by Agent Skills format)");
+      continue;
+    }
+    const sectionContent = convertSection13(section, warnings);
+    if (sectionContent) {
+      lines.push(sectionContent);
+      lines.push("");
+    }
+  }
+  return lines.join("\n").trim() + "\n";
+}
+function truncateDescription(desc, maxLength) {
+  if (desc.length <= maxLength)
+    return desc;
+  return desc.substring(0, maxLength - 3) + "...";
+}
+function slugify(name) {
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  if (!slug) {
+    return "unnamed-skill";
+  }
+  return slug.slice(0, 64);
+}
 function convertSlashCommandToSection(pkg, warnings) {
   const lines = [];
   const commandName = pkg.name.replace(/^\//, "");
@@ -12419,10 +12599,15 @@ function convertToAgentsMd(pkg, warnings) {
   }
   return lines.join("\n").trim();
 }
+function escapeRegex(str2) {
+  return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function appendToExistingAgentsMd(existingContent, newSection, commandName) {
-  const sectionHeader = `## ${commandName.replace(/^\//, "")}`;
+  const cleanCommandName = commandName.replace(/^\//, "");
+  const escapedCommandName = escapeRegex(cleanCommandName);
+  const sectionHeader = `## ${cleanCommandName}`;
   if (existingContent.includes(sectionHeader)) {
-    const regex = new RegExp(`## ${commandName.replace(/^\//, "")}[\\s\\S]*?(?=## |$)`, "g");
+    const regex = new RegExp(`## ${escapedCommandName}[\\s\\S]*?(?=## |$)`, "g");
     return existingContent.replace(regex, newSection + "\n\n");
   }
   const trimmedExisting = existingContent.trim();
@@ -12536,13 +12721,25 @@ function parseArgumentHint2(hint) {
   }
   return hint.split(/\s+/).filter(Boolean);
 }
-function generateFilename2() {
+function generateFilename2(pkg) {
+  if ((pkg == null ? void 0 : pkg.subtype) === "skill") {
+    return "SKILL.md";
+  }
   return "AGENTS.md";
 }
+function isCodexSkillFormat(content) {
+  const normalizedContent = content.replace(/\r\n/g, "\n");
+  const match = normalizedContent.match(/^---\n([\s\S]*?)\n---/);
+  if (!match)
+    return false;
+  const frontmatterText = match[1];
+  return frontmatterText.includes("name:") && frontmatterText.includes("description:");
+}
 var init_to_codex = __esm({
   "../converters/dist/to-codex.js"() {
     "use strict";
     init_cjs_shims();
+    init_js_yaml();
   }
 });
 
@@ -12625,7 +12822,7 @@ var init_to_mcp_server = __esm({
 });
 
 // ../converters/dist/schema-files.js
-var import_module, import_path7, schemaRequire, convertersPackagePath, convertersDir, loadSchema2, formatRegistrySchema, agentsMdSchema, canonicalSchema, claudeSchema, continueSchema, copilotSchema, cursorSchema, droidSchema, geminiMdSchema, geminiSchema, kiroSteeringSchema, opencodeSchema, rulerSchema, windsurfSchema, traeSchema, aiderSchema, zencoderSchema, replitSchema, zedSchema, claudeAgentSchema, claudeHookSchema, claudeSkillSchema, claudeSlashCommandSchema, copilotSkillSchema, cursorCommandSchema, cursorHooksSchema, droidHookSchema, droidSkillSchema, droidSlashCommandSchema, kiroAgentSchema, kiroHookSchema, opencodeSlashCommandSchema;
+var import_module, import_path7, schemaRequire, convertersPackagePath, convertersDir, loadSchema2, formatRegistrySchema, agentsMdSchema, canonicalSchema, claudeSchema, continueSchema, copilotSchema, cursorSchema, droidSchema, geminiMdSchema, geminiSchema, kiroSteeringSchema, opencodeSchema, rulerSchema, windsurfSchema, traeSchema, aiderSchema, zencoderSchema, replitSchema, zedSchema, claudeAgentSchema, claudeHookSchema, claudeSkillSchema, claudeSlashCommandSchema, agentSkillsSchema, copilotSkillSchema, codexSkillSchema, cursorCommandSchema, cursorHooksSchema, droidHookSchema, droidSkillSchema, droidSlashCommandSchema, kiroAgentSchema, kiroHookSchema, opencodeSlashCommandSchema;
 var init_schema_files = __esm({
   "../converters/dist/schema-files.js"() {
     "use strict";
@@ -12659,7 +12856,9 @@ var init_schema_files = __esm({
     claudeHookSchema = loadSchema2("claude-hook.schema.json");
     claudeSkillSchema = loadSchema2("claude-skill.schema.json");
     claudeSlashCommandSchema = loadSchema2("claude-slash-command.schema.json");
-    copilotSkillSchema = loadSchema2("copilot-skill.schema.json");
+    agentSkillsSchema = loadSchema2("agent-skills.schema.json");
+    copilotSkillSchema = agentSkillsSchema;
+    codexSkillSchema = agentSkillsSchema;
     cursorCommandSchema = loadSchema2("cursor-command.schema.json");
     cursorHooksSchema = loadSchema2("cursor-hooks.schema.json");
     droidHookSchema = loadSchema2("droid-hook.schema.json");
@@ -12978,7 +13177,8 @@ var init_format_registry = __esm({
         },
         codex: {
           name: "OpenAI Codex CLI",
-          description: "OpenAI Codex CLI using AGENTS.md for project instructions",
+          description: "OpenAI Codex CLI skills and AGENTS.md project instructions",
+          documentationUrl: "https://developers.openai.com/codex/skills",
           subtypes: {
             rule: {
               directory: ".",
@@ -12991,7 +13191,7 @@ var init_format_registry = __esm({
               fileExtension: ".md"
             },
             skill: {
-              directory: ".openskills",
+              directory: ".codex/skills",
               filePatterns: ["SKILL.md"],
               nested: true,
               nestedIndicator: "SKILL.md",
@@ -13434,6 +13634,7 @@ __export(dist_exports, {
   SCRIPT_LANGUAGE_EXTENSIONS: () => SCRIPT_LANGUAGE_EXTENSIONS,
   VALID_CURSOR_HOOK_TYPES: () => VALID_CURSOR_HOOK_TYPES,
   VALID_HOOK_MAPPING_STRATEGIES: () => VALID_HOOK_MAPPING_STRATEGIES,
+  agentSkillsSchema: () => agentSkillsSchema,
   agentsMdSchema: () => agentsMdSchema,
   aiderSchema: () => aiderSchema,
   canonicalSchema: () => canonicalSchema,
@@ -13442,6 +13643,7 @@ __export(dist_exports, {
   claudeSchema: () => claudeSchema,
   claudeSkillSchema: () => claudeSkillSchema,
   claudeSlashCommandSchema: () => claudeSlashCommandSchema,
+  codexSkillSchema: () => codexSkillSchema,
   continueSchema: () => continueSchema,
   copilotSchema: () => copilotSchema,
   copilotSkillSchema: () => copilotSkillSchema,
@@ -13465,6 +13667,7 @@ __export(dist_exports, {
   fromAider: () => fromAider,
   fromClaude: () => fromClaude,
   fromClaudePlugin: () => fromClaudePlugin,
+  fromCodex: () => fromCodex,
   fromContinue: () => fromContinue,
   fromCopilot: () => fromCopilot,
   fromCursor: () => fromCursor,
@@ -13512,6 +13715,7 @@ __export(dist_exports, {
   isAgentsMdFormat: () => isAgentsMdFormat,
   isAiderFormat: () => isAiderFormat,
   isClaudeFormat: () => isClaudeFormat,
+  isCodexSkillFormat: () => isCodexSkillFormat,
   isContinueFormat: () => isContinueFormat,
   isCopilotFormat: () => isCopilotFormat,
   isCursorFormat: () => isCursorFormat,
@@ -13602,6 +13806,7 @@ var init_dist = __esm({
     init_from_zencoder();
     init_from_replit();
     init_from_zed();
+    init_from_codex();
     init_from_mcp_server();
     init_to_cursor();
     init_to_cursor_hooks();
@@ -24911,6 +25116,9 @@ function getDefaultPath(format, filename, subtype, customName) {
     case "droid":
       return (0, import_path23.join)(process.cwd(), ".factory", `${baseName}.md`);
     case "codex":
+      if (subtype === "skill") {
+        return (0, import_path23.join)(process.cwd(), ".codex", "skills", baseName, "SKILL.md");
+      }
       return (0, import_path23.join)(process.cwd(), "AGENTS.md");
     default:
       throw new CLIError(`Unknown format: ${format}`);
@@ -24954,6 +25162,9 @@ function detectFormat(content, filepath) {
   if (filepath.includes(".zed/extensions") || filepath.includes(".zed/slash_commands")) {
     return "zed";
   }
+  if (filepath.includes(".codex/skills") || (0, import_path23.basename)(filepath) === "SKILL.md") {
+    return "codex";
+  }
   if (isCursorHooksFormat(content)) return "cursor-hooks";
   if (isClaudeFormat(content)) {
     if (content.includes("type: skill")) return "claude-skill";
@@ -24969,6 +25180,7 @@ function detectFormat(content, filepath) {
   if (isAgentsMdFormat(content)) return "agents.md";
   if (isRulerFormat(content)) return "ruler";
   if (isZedFormat(content)) return "zed";
+  if (isCodexSkillFormat(content)) return "codex";
   return null;
 }
 async function confirmOverwrite(filepath) {
@@ -25090,6 +25302,9 @@ async function handleConvert(sourcePath, options) {
       case "droid":
         canonicalPkg = fromDroid(content, metadata);
         break;
+      case "codex":
+        canonicalPkg = fromCodex(content, metadata);
+        break;
       default:
         throw new CLIError(`Unsupported source format: ${sourceFormat}`);
     }

package/dist/schemas/agent-skills.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://registry.prpm.dev/api/v1/schemas/agent-skills.json",
+  "$comment": "https://agentskills.io/specification",
+  "title": "Agent Skills Format",
+  "description": "JSON Schema for Agent Skills - a shared standard implemented by Codex, GitHub Copilot, and other AI assistants. Skills are SKILL.md files with YAML frontmatter.",
+  "type": "object",
+  "required": ["frontmatter", "content"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "description"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Skill identifier: 1-64 chars, lowercase alphanumeric and hyphens only, cannot start/end with hyphens or contain consecutive hyphens. Must match parent directory name.",
+          "minLength": 1,
+          "maxLength": 64,
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "description": {
+          "type": "string",
+          "description": "Explains what the skill does and when to use it. Should include specific keywords for agent identification. (1-1024 chars)",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "license": {
+          "type": "string",
+          "description": "Specifies skill licensing terms. Keep brief (license name or bundled file reference)."
+        },
+        "compatibility": {
+          "type": "string",
+          "description": "Indicates environment requirements (products, system packages, network access). Example: 'Requires git, docker, jq, and internet access'",
+          "maxLength": 500
+        },
+        "allowed-tools": {
+          "type": "string",
+          "description": "Space-delimited list of pre-approved tools. Experimental; support varies by implementation. Example: 'Bash(git:*) Bash(jq:*) Read'"
+        },
+        "metadata": {
+          "type": "object",
+          "description": "Arbitrary string key-value pairs for additional properties not defined by the specification",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "content": {
+      "type": "string",
+      "description": "Skill instructions as markdown text. Recommended to keep under 5000 tokens for progressive disclosure."
+    }
+  },
+  "examples": [
+    {
+      "frontmatter": {
+        "name": "code-review",
+        "description": "Reviews code for best practices, security issues, and improvements. Use when analyzing pull requests, code changes, or conducting security audits.",
+        "license": "MIT",
+        "compatibility": "Requires git",
+        "metadata": {
+          "category": "development",
+          "version": "1.0.0"
+        }
+      },
+      "content": "You are an expert code reviewer.\n\n## Instructions\n\n- Check for code smells\n- Verify test coverage\n- Suggest improvements"
+    },
+    {
+      "frontmatter": {
+        "name": "pdf-processing",
+        "description": "Extracts and processes content from PDF documents. Use for document analysis, text extraction, and PDF manipulation tasks.",
+        "allowed-tools": "Bash(pdftotext:*) Read Write"
+      },
+      "content": "Process PDF documents using available command-line tools.\n\n## Capabilities\n\n- Extract text from PDFs\n- Convert PDF pages to images\n- Merge and split PDF files"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "2.1.16",
+  "version": "2.1.17",
   "description": "Prompt Package Manager CLI - Install and manage prompt-based files",
   "main": "dist/index.js",
   "bin": {
@@ -45,9 +45,9 @@
   "license": "MIT",
   "dependencies": {
     "@octokit/rest": "^22.0.0",
-    "@pr-pm/converters": "^2.1.17",
-    "@pr-pm/registry-client": "^2.3.16",
-    "@pr-pm/types": "^2.1.17",
+    "@pr-pm/converters": "^2.1.18",
+    "@pr-pm/registry-client": "^2.3.17",
+    "@pr-pm/types": "^2.1.18",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",

package/dist/schemas/copilot-skill.schema.json

@@ -1,50 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://registry.prpm.dev/api/v1/schemas/copilot/skill.json",
-  "$comment": "https://code.visualstudio.com/docs/copilot/customization/agent-skills",
-  "title": "GitHub Copilot Skill Format",
-  "description": "JSON Schema for GitHub Copilot agent skills (.github/skills/*/SKILL.md)",
-  "type": "object",
-  "required": ["frontmatter", "content"],
-  "properties": {
-    "frontmatter": {
-      "type": "object",
-      "description": "YAML frontmatter with skill metadata",
-      "required": ["name", "description"],
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Unique identifier for the skill. Must be lowercase, using hyphens for spaces.",
-          "maxLength": 64,
-          "pattern": "^[a-z0-9-]+$"
-        },
-        "description": {
-          "type": "string",
-          "description": "Description of what the skill does and when to use it. Be specific about both capabilities and use cases.",
-          "maxLength": 1024
-        }
-      },
-      "additionalProperties": false
-    },
-    "content": {
-      "type": "string",
-      "description": "Markdown body with detailed instructions, procedures, examples, and references to bundled resources."
-    }
-  },
-  "examples": [
-    {
-      "frontmatter": {
-        "name": "webapp-testing",
-        "description": "Guides testing of web applications using browser automation and testing frameworks"
-      },
-      "content": "# Web Application Testing\n\nThis skill helps you test web applications effectively.\n\n## Procedures\n\n1. Set up testing environment\n2. Write unit tests\n3. Run integration tests\n\n## Resources\n\n- [Test template](./test-template.ts)"
-    },
-    {
-      "frontmatter": {
-        "name": "api-documentation",
-        "description": "Generates and maintains API documentation following OpenAPI specifications"
-      },
-      "content": "# API Documentation\n\nThis skill assists with creating comprehensive API documentation.\n\n## Guidelines\n\n- Document all endpoints\n- Include request/response examples\n- Specify authentication requirements"
-    }
-  ]
-}