prpm 2.1.15 → 2.1.16

package/dist/format-capabilities.json

@@ -5,7 +5,7 @@
   "lastVerified": "2025-12-06",
   "verificationSources": {
     "claude": "https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview",
-    "copilot": "https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/",
+    "copilot": "https://code.visualstudio.com/docs/copilot/customization/agent-skills",
     "cursor": "https://docs.cursor.com/context/rules",
     "continue": "https://docs.continue.dev/reference",
     "windsurf": "https://docs.codeium.com/windsurf/cascade",
@@ -58,13 +58,13 @@
     },
     "copilot": {
       "name": "GitHub Copilot",
-      "supportsSkills": false,
+      "supportsSkills": true,
       "supportsPlugins": false,
       "supportsExtensions": false,
       "supportsAgents": true,
       "supportsAgentsMd": true,
       "markdownFallback": "copilot-instructions.md",
-      "notes": "GitHub Copilot coding agent supports AGENTS.md, CLAUDE.md, GEMINI.md, and .instructions.md custom instructions (as of August 2025). Full agents.md support."
+      "notes": "GitHub Copilot supports skills in .github/skills/<name>/SKILL.md (VS Code Insiders with chat.useAgentSkills setting). Also supports AGENTS.md, CLAUDE.md, GEMINI.md, and .instructions.md custom instructions."
     },
     "kiro": {
       "name": "Kiro AI",

package/dist/index.js

@@ -8758,6 +8758,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",
       "cursor:slash-command": "cursor-command.schema.json",
       "cursor:hook": "cursor-hooks.schema.json",
       // cursor + hook subtype uses cursor-hooks schema
@@ -9830,7 +9831,11 @@ function toCopilot(pkg, options = {}) {
   let qualityScore = 100;
   try {
     const config = options.copilotConfig || {};
-    const isPathSpecific = !!config.applyTo;
+    const isSkill = config.isSkill || pkg.subtype === "skill";
+    const isPathSpecific = !!config.applyTo && !isSkill;
+    if (isSkill) {
+      return convertToSkill(pkg, config, warnings);
+    }
     if (isPathSpecific && !config.applyTo) {
       warnings.push("Path-specific instruction requires applyTo pattern");
       qualityScore -= 20;
@@ -9838,7 +9843,7 @@ function toCopilot(pkg, options = {}) {
     const content = convertContent3(pkg, warnings, config);
     let fullContent;
     if (isPathSpecific && config.applyTo) {
-      const frontmatter = generateFrontmatter(config);
+      const frontmatter = generateInstructionFrontmatter(config);
       fullContent = `${frontmatter}
 
 ${content}`;
@@ -9867,7 +9872,81 @@ ${content}`;
     };
   }
 }
-function generateFrontmatter(config) {
+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 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");
+    qualityScore -= 10;
+  }
+  const frontmatter = generateSkillFrontmatter(skillName, skillDescription);
+  const content = convertSkillContent(pkg, warnings);
+  const fullContent = `${frontmatter}
+
+${content}`;
+  const lossyConversion = warnings.some((w) => w.includes("not supported") || w.includes("skipped"));
+  if (lossyConversion) {
+    qualityScore -= 10;
+  }
+  return {
+    content: fullContent,
+    format: "copilot",
+    warnings: warnings.length > 0 ? warnings : void 0,
+    lossyConversion,
+    qualityScore
+  };
+}
+function generateSkillFrontmatter(name, description) {
+  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}`);
+  lines.push("---");
+  return lines.join("\n");
+}
+function convertSkillContent(pkg, warnings) {
+  var _a, _b, _c, _d;
+  const lines = [];
+  const title = ((_a = pkg.metadata) == null ? void 0 : _a.title) || pkg.name || pkg.id;
+  lines.push(`# ${title}`);
+  lines.push("");
+  if (pkg.description || ((_b = pkg.metadata) == null ? void 0 : _b.description)) {
+    lines.push(pkg.description || ((_c = pkg.metadata) == null ? void 0 : _c.description) || "");
+    lines.push("");
+  }
+  for (const section of pkg.content.sections) {
+    if (section.type === "metadata") {
+      continue;
+    }
+    if (section.type === "tools") {
+      warnings.push("Tools section converted to reference list");
+      continue;
+    }
+    if (section.type === "persona") {
+      if ((_d = section.data) == null ? void 0 : _d.role) {
+        lines.push("## When to Use");
+        lines.push("");
+        lines.push(section.data.role);
+        lines.push("");
+      }
+      continue;
+    }
+    const sectionContent = convertSection4(section, warnings);
+    if (sectionContent) {
+      lines.push(sectionContent);
+      lines.push("");
+    }
+  }
+  return lines.join("\n").trim();
+}
+function generateInstructionFrontmatter(config) {
   const lines = ["---"];
   if (config.applyTo) {
     const patterns = Array.isArray(config.applyTo) ? config.applyTo : [config.applyTo];
@@ -10002,7 +10081,7 @@ function toKiro(pkg, options = {}) {
     if (config.inclusion === "fileMatch" && !config.fileMatchPattern) {
       throw new Error("fileMatch inclusion mode requires fileMatchPattern");
     }
-    const frontmatter = generateFrontmatter2(config);
+    const frontmatter = generateFrontmatter(config);
     const content = convertContent4(pkg, warnings, config);
     const fullContent = `${frontmatter}
 
@@ -10029,7 +10108,7 @@ ${content}`;
     };
   }
 }
-function generateFrontmatter2(config) {
+function generateFrontmatter(config) {
   const lines = ["---"];
   lines.push(`inclusion: ${config.inclusion || "always"}`);
   if (config.inclusion === "fileMatch" && config.fileMatchPattern) {
@@ -11711,7 +11790,7 @@ function toZencoder(pkg, options = {}) {
     const content = convertContent12(pkg, warnings, config);
     let fullContent;
     if (includeFrontmatter) {
-      const frontmatter = generateFrontmatter3(pkg, config);
+      const frontmatter = generateFrontmatter2(pkg, config);
       if (frontmatter) {
         fullContent = `${frontmatter}
 
@@ -11744,7 +11823,7 @@ ${content}`;
     };
   }
 }
-function generateFrontmatter3(pkg, config) {
+function generateFrontmatter2(pkg, config) {
   var _a, _b, _c;
   const lines = [];
   let hasContent = false;
@@ -12546,7 +12625,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, 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, copilotSkillSchema, cursorCommandSchema, cursorHooksSchema, droidHookSchema, droidSkillSchema, droidSlashCommandSchema, kiroAgentSchema, kiroHookSchema, opencodeSlashCommandSchema;
 var init_schema_files = __esm({
   "../converters/dist/schema-files.js"() {
     "use strict";
@@ -12580,6 +12659,7 @@ 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");
     cursorCommandSchema = loadSchema2("cursor-command.schema.json");
     cursorHooksSchema = loadSchema2("cursor-hooks.schema.json");
     droidHookSchema = loadSchema2("droid-hook.schema.json");
@@ -12717,7 +12797,7 @@ var init_format_registry = __esm({
         },
         copilot: {
           name: "GitHub Copilot",
-          description: "GitHub Copilot instructions and chat modes",
+          description: "GitHub Copilot instructions, chat modes, and skills",
           documentationUrl: "https://docs.github.com/en/copilot",
           subtypes: {
             rule: {
@@ -12729,6 +12809,14 @@ var init_format_registry = __esm({
               directory: ".github/chatmodes",
               filePatterns: ["*.chatmode.md"],
               fileExtension: ".chatmode.md"
+            },
+            skill: {
+              directory: ".github/skills",
+              filePatterns: ["SKILL.md"],
+              nested: true,
+              nestedIndicator: "SKILL.md",
+              usesPackageSubdirectory: true,
+              fileExtension: ".md"
             }
           }
         },
@@ -13356,6 +13444,7 @@ __export(dist_exports, {
   claudeSlashCommandSchema: () => claudeSlashCommandSchema,
   continueSchema: () => continueSchema,
   copilotSchema: () => copilotSchema,
+  copilotSkillSchema: () => copilotSkillSchema,
   createMinimalPluginJson: () => createMinimalPluginJson,
   cursorCommandSchema: () => cursorCommandSchema,
   cursorHooksSchema: () => cursorHooksSchema,
@@ -17204,6 +17293,8 @@ This could indicate:
         }
       } else if (effectiveFormat === "droid" && effectiveSubtype === "skill") {
         destPath = `${destDir}/SKILL.md`;
+      } else if (effectiveFormat === "copilot" && effectiveSubtype === "skill") {
+        destPath = `${destDir}/SKILL.md`;
       } else {
         const nativeSubtypes2 = import_types.FORMAT_NATIVE_SUBTYPES[effectiveFormat];
         const needsProgressiveDisclosureHere = nativeSubtypes2 && !nativeSubtypes2.includes(effectiveSubtype) && (effectiveSubtype === "skill" || effectiveSubtype === "agent" || effectiveSubtype === "slash-command");

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

@@ -0,0 +1,50 @@
+{
+  "$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"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "2.1.15",
+  "version": "2.1.16",
   "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.16",
-    "@pr-pm/registry-client": "^2.3.15",
-    "@pr-pm/types": "^2.1.16",
+    "@pr-pm/converters": "^2.1.17",
+    "@pr-pm/registry-client": "^2.3.16",
+    "@pr-pm/types": "^2.1.17",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",