@lousy-agents/cli 1.0.5 → 1.1.0

package/dist/commands/new.d.ts

@@ -1,6 +1,16 @@
+/**
+ * The `skill` subcommand for creating Agent Skills
+ */
+export declare const skillCommand: import("citty").CommandDef<{
+    name: {
+        type: "positional";
+        description: string;
+        required: boolean;
+    };
+}>;
 /**
  * The `new` command for scaffolding new resources.
- * Currently supports creating Copilot custom agents.
+ * Supports creating Copilot custom agents and Agent Skills.
  */
 export declare const newCommand: import("citty").CommandDef<{
     "copilot-agent": {

package/dist/commands/new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;EAkCrB,CAAC"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AA6BA;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;EAmCvB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;EAmDrB,CAAC"}

package/dist/commands/new.js

@@ -1,31 +1,84 @@
 import { defineCommand } from "citty";
 import { consola } from "consola";
 import { createAgentFileGateway } from "../gateways/agent-file-gateway.js";
+import { createSkillFileGateway } from "../gateways/skill-file-gateway.js";
 import { CreateCopilotAgentUseCase } from "../use-cases/create-copilot-agent.js";
-const newArgs = {
+import { CreateSkillUseCase } from "../use-cases/create-skill.js";
+const copilotAgentArgs = {
     "copilot-agent": {
         type: "string",
         description: "Create a new GitHub Copilot custom agent with the specified name. Example: lousy-agents new --copilot-agent security",
     },
 };
+const skillArgs = {
+    name: {
+        type: "positional",
+        description: "The name of the skill to create. Example: lousy-agents new skill github-actions-debug",
+        required: true,
+    },
+};
+/**
+ * The `skill` subcommand for creating Agent Skills
+ */
+export const skillCommand = defineCommand({
+    meta: {
+        name: "skill",
+        description: "Create a new GitHub Copilot Agent Skill. Example: lousy-agents new skill github-actions-debug",
+    },
+    args: skillArgs,
+    run: async (context) => {
+        // Support dependency injection for testing via context.data
+        const targetDir = typeof context.data?.targetDir === "string"
+            ? context.data.targetDir
+            : process.cwd();
+        const skillName = context.args.name;
+        if (!skillName) {
+            throw new Error("Missing required argument: <name>. Example: lousy-agents new skill github-actions-debug");
+        }
+        // Create the use case with the file system gateway
+        const gateway = createSkillFileGateway();
+        const useCase = new CreateSkillUseCase(gateway);
+        // Execute the use case
+        const result = await useCase.execute(targetDir, skillName);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        consola.success(`Created Agent Skill: ${result.skillFilePath}`);
+    },
+});
 /**
  * The `new` command for scaffolding new resources.
- * Currently supports creating Copilot custom agents.
+ * Supports creating Copilot custom agents and Agent Skills.
  */
 export const newCommand = defineCommand({
     meta: {
         name: "new",
-        description: "Create new resources (e.g., Copilot agents)",
+        description: "Create new resources (e.g., Copilot agents, skills). Use 'new skill <name>' to create an Agent Skill.",
+    },
+    args: copilotAgentArgs,
+    subCommands: {
+        skill: skillCommand,
     },
-    args: newArgs,
     run: async (context) => {
+        // citty runs both the subcommand's run function and the parent's run function.
+        // We need to detect when a subcommand was invoked and exit early to avoid
+        // throwing an error for missing --copilot-agent option.
+        const subCommand = context.rawArgs[0];
+        if (subCommand === "skill") {
+            return; // Subcommand was handled by skillCommand.run
+        }
         // Support dependency injection for testing via context.data
         const targetDir = typeof context.data?.targetDir === "string"
             ? context.data.targetDir
             : process.cwd();
         const copilotAgentName = context.args["copilot-agent"];
         if (!copilotAgentName) {
-            throw new Error("Missing required option: --copilot-agent <name>. Example: lousy-agents new --copilot-agent security");
+            throw new Error("Missing required option. Use one of:\n" +
+                "  --copilot-agent <name>  Create a Copilot custom agent\n" +
+                "  skill <name>            Create an Agent Skill\n\n" +
+                "Examples:\n" +
+                "  lousy-agents new --copilot-agent security\n" +
+                "  lousy-agents new skill github-actions-debug");
         }
         // Create the use case with the file system gateway
         const gateway = createAgentFileGateway();

package/dist/commands/new.js.map

@@ -1 +1 @@
-{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,MAAM,OAAO,GAAG;IACZ,eAAe,EAAE;QACb,IAAI,EAAE,QAAiB;QACvB,WAAW,EACP,sHAAsH;KAC7H;CACJ,CAAC;AAIF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACpC,IAAI,EAAE;QACF,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,6CAA6C;KAC7D;IACD,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,KAAK,EAAE,OAAgC,EAAE,EAAE;QAC5C,4DAA4D;QAC5D,MAAM,SAAS,GACX,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ;YACvC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS;YACxB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAExB,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAEvD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACX,qGAAqG,CACxG,CAAC;QACN,CAAC;QAED,mDAAmD;QACnD,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAEvD,uBAAuB;QACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAElE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,0BAA0B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;CACJ,CAAC,CAAC"}
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"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"}

package/dist/entities/index.d.ts

@@ -3,4 +3,5 @@
  */
 export * from "./copilot-agent.js";
 export * from "./copilot-setup.js";
+export * from "./skill.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/entities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/dist/entities/index.js

@@ -3,4 +3,5 @@
  */
 export * from "./copilot-agent.js";
 export * from "./copilot-setup.js";
+export * from "./skill.js";
 //# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}

package/dist/entities/skill.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core domain entity for GitHub Copilot Agent Skills.
+ * Handles name normalization and SKILL.md content generation.
+ */
+/**
+ * Normalizes a skill name to lowercase with hyphens.
+ * Handles spaces, mixed case, multiple spaces, and leading/trailing spaces.
+ */
+export declare function normalizeSkillName(name: string): string;
+/**
+ * Generates the SKILL.md content for a Copilot Agent Skill.
+ * Includes YAML frontmatter, documentation link, and example structure.
+ */
+export declare function generateSkillContent(skillName: string): string;
+//# sourceMappingURL=skill.d.ts.map

package/dist/entities/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/entities/skill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA+C9D"}

package/dist/entities/skill.js

@@ -0,0 +1,63 @@
+/**
+ * Core domain entity for GitHub Copilot Agent Skills.
+ * Handles name normalization and SKILL.md content generation.
+ */
+/**
+ * Normalizes a skill name to lowercase with hyphens.
+ * Handles spaces, mixed case, multiple spaces, and leading/trailing spaces.
+ */
+export function normalizeSkillName(name) {
+    return name.trim().toLowerCase().replace(/\s+/g, "-");
+}
+/**
+ * Generates the SKILL.md content for a Copilot Agent Skill.
+ * Includes YAML frontmatter, documentation link, and example structure.
+ */
+export function generateSkillContent(skillName) {
+    const normalizedName = normalizeSkillName(skillName);
+    return `---
+name: ${normalizedName}
+description: Brief description of what this skill does and when Copilot should use it
+---
+
+<!-- 
+This is a GitHub Copilot Agent Skill for repository-level use.
+Learn more: https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
+-->
+
+# ${normalizedName}
+
+{Brief description of what this skill teaches Copilot to do}
+
+## When to Use This Skill
+
+Copilot should use this skill when:
+
+- {Trigger condition 1}
+- {Trigger condition 2}
+- {Trigger condition 3}
+
+## Instructions
+
+{Detailed step-by-step instructions for Copilot to follow}
+
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+
+## Guidelines
+
+- {Guideline or best practice}
+- {Guideline or best practice}
+- {Guideline or best practice}
+
+## Examples
+
+{Examples of inputs and expected outputs or behaviors}
+
+### Example 1: {Title}
+
+{Description of the example scenario and expected behavior}
+`;
+}
+//# sourceMappingURL=skill.js.map

package/dist/entities/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/entities/skill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IAClD,MAAM,cAAc,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAErD,OAAO;QACH,cAAc;;;;;;;;;IASlB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCjB,CAAC;AACF,CAAC"}

package/dist/gateways/index.d.ts

@@ -5,5 +5,6 @@ export * from "./action-version-gateway.js";
 export * from "./agent-file-gateway.js";
 export * from "./environment-gateway.js";
 export * from "./file-system-utils.js";
+export * from "./skill-file-gateway.js";
 export * from "./workflow-gateway.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/gateways/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gateways/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gateways/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/gateways/index.js

@@ -5,5 +5,6 @@ export * from "./action-version-gateway.js";
 export * from "./agent-file-gateway.js";
 export * from "./environment-gateway.js";
 export * from "./file-system-utils.js";
+export * from "./skill-file-gateway.js";
 export * from "./workflow-gateway.js";
 //# sourceMappingURL=index.js.map

package/dist/gateways/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gateways/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gateways/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/dist/gateways/skill-file-gateway.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Gateway for skill file system operations.
+ * This module abstracts file system access for Copilot Agent Skill files.
+ */
+/**
+ * Interface for skill file gateway
+ * Allows for different implementations (file system, mock, etc.)
+ */
+export interface SkillFileGateway {
+    /**
+     * Checks if a skill directory already exists
+     * @param targetDir The root directory of the repository
+     * @param skillName The normalized name of the skill
+     * @returns true if the skill directory exists
+     */
+    skillDirectoryExists(targetDir: string, skillName: string): Promise<boolean>;
+    /**
+     * Ensures the .github/skills/<name> directory exists
+     * @param targetDir The root directory of the repository
+     * @param skillName The normalized name of the skill
+     */
+    ensureSkillDirectory(targetDir: string, skillName: string): Promise<void>;
+    /**
+     * Writes content to a SKILL.md file
+     * @param targetDir The root directory of the repository
+     * @param skillName The normalized name of the skill
+     * @param content The content to write to the file
+     */
+    writeSkillFile(targetDir: string, skillName: string, content: string): Promise<void>;
+    /**
+     * Returns the full path to a skill directory
+     * @param targetDir The root directory of the repository
+     * @param skillName The normalized name of the skill
+     * @returns The full path to the skill directory
+     */
+    getSkillDirectoryPath(targetDir: string, skillName: string): string;
+    /**
+     * Returns the full path to a SKILL.md file
+     * @param targetDir The root directory of the repository
+     * @param skillName The normalized name of the skill
+     * @returns The full path to the SKILL.md file
+     */
+    getSkillFilePath(targetDir: string, skillName: string): string;
+}
+/**
+ * File system implementation of the skill file gateway
+ */
+export declare class FileSystemSkillFileGateway implements SkillFileGateway {
+    getSkillDirectoryPath(targetDir: string, skillName: string): string;
+    getSkillFilePath(targetDir: string, skillName: string): string;
+    skillDirectoryExists(targetDir: string, skillName: string): Promise<boolean>;
+    ensureSkillDirectory(targetDir: string, skillName: string): Promise<void>;
+    writeSkillFile(targetDir: string, skillName: string, content: string): Promise<void>;
+}
+/**
+ * Creates and returns the default skill file gateway
+ */
+export declare function createSkillFileGateway(): SkillFileGateway;
+//# sourceMappingURL=skill-file-gateway.d.ts.map

package/dist/gateways/skill-file-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-gateway.d.ts","sourceRoot":"","sources":["../../src/gateways/skill-file-gateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;OAKG;IACH,oBAAoB,CAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;OAIG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,cAAc,CACV,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpE;;;;;OAKG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAClE;AAED;;GAEG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IAC/D,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAInE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAOxD,oBAAoB,CACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;IAKb,oBAAoB,CACtB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAKV,cAAc,CAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;CAInB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}

package/dist/gateways/skill-file-gateway.js

@@ -0,0 +1,37 @@
+/**
+ * Gateway for skill file system operations.
+ * This module abstracts file system access for Copilot Agent Skill files.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileExists } from "./file-system-utils.js";
+/**
+ * File system implementation of the skill file gateway
+ */
+export class FileSystemSkillFileGateway {
+    getSkillDirectoryPath(targetDir, skillName) {
+        return join(targetDir, ".github", "skills", skillName);
+    }
+    getSkillFilePath(targetDir, skillName) {
+        return join(this.getSkillDirectoryPath(targetDir, skillName), "SKILL.md");
+    }
+    async skillDirectoryExists(targetDir, skillName) {
+        const dirPath = this.getSkillDirectoryPath(targetDir, skillName);
+        return fileExists(dirPath);
+    }
+    async ensureSkillDirectory(targetDir, skillName) {
+        const skillDir = this.getSkillDirectoryPath(targetDir, skillName);
+        await mkdir(skillDir, { recursive: true });
+    }
+    async writeSkillFile(targetDir, skillName, content) {
+        const filePath = this.getSkillFilePath(targetDir, skillName);
+        await writeFile(filePath, content, { encoding: "utf-8" });
+    }
+}
+/**
+ * Creates and returns the default skill file gateway
+ */
+export function createSkillFileGateway() {
+    return new FileSystemSkillFileGateway();
+}
+//# sourceMappingURL=skill-file-gateway.js.map

package/dist/gateways/skill-file-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-gateway.js","sourceRoot":"","sources":["../../src/gateways/skill-file-gateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAsDpD;;GAEG;AACH,MAAM,OAAO,0BAA0B;IACnC,qBAAqB,CAAC,SAAiB,EAAE,SAAiB;QACtD,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,gBAAgB,CAAC,SAAiB,EAAE,SAAiB;QACjD,OAAO,IAAI,CACP,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,EAChD,UAAU,CACb,CAAC;IACN,CAAC;IAED,KAAK,CAAC,oBAAoB,CACtB,SAAiB,EACjB,SAAiB;QAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACjE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,oBAAoB,CACtB,SAAiB,EACjB,SAAiB;QAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAClE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,cAAc,CAChB,SAAiB,EACjB,SAAiB,EACjB,OAAe;QAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IAClC,OAAO,IAAI,0BAA0B,EAAE,CAAC;AAC5C,CAAC"}

package/dist/use-cases/create-skill.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Use case for creating GitHub Copilot Agent Skills.
+ * Orchestrates entity logic with gateway operations.
+ */
+import type { SkillFileGateway } from "../gateways/skill-file-gateway.js";
+/**
+ * Result of the create skill operation
+ */
+export interface CreateSkillResult {
+    success: boolean;
+    normalizedName?: string;
+    skillDirectoryPath?: string;
+    skillFilePath?: string;
+    error?: string;
+}
+/**
+ * Use case for creating a new Agent Skill
+ */
+export declare class CreateSkillUseCase {
+    private readonly gateway;
+    constructor(gateway: SkillFileGateway);
+    /**
+     * Executes the create skill operation
+     * @param targetDir The root directory of the repository
+     * @param skillName The name of the skill to create
+     * @returns Result of the operation
+     */
+    execute(targetDir: string, skillName: string): Promise<CreateSkillResult>;
+}
+//# sourceMappingURL=create-skill.d.ts.map

package/dist/use-cases/create-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill.d.ts","sourceRoot":"","sources":["../../src/use-cases/create-skill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAe1E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,gBAAgB;IAEtD;;;;;OAKG;IACG,OAAO,CACT,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;CA6DhC"}

package/dist/use-cases/create-skill.js

@@ -0,0 +1,75 @@
+/**
+ * Use case for creating GitHub Copilot Agent Skills.
+ * Orchestrates entity logic with gateway operations.
+ */
+import { z } from "zod";
+import { generateSkillContent, normalizeSkillName } from "../entities/skill.js";
+/**
+ * Schema for validating skill name input
+ * Validates that the input is a non-empty string with reasonable constraints
+ */
+const SkillNameSchema = z
+    .string()
+    .min(1, "Skill name is required")
+    .max(100, "Skill name must be 100 characters or less")
+    .regex(/^[a-zA-Z0-9\s_-]+$/, "Skill name can only contain letters, numbers, spaces, hyphens, and underscores");
+/**
+ * Use case for creating a new Agent Skill
+ */
+export class CreateSkillUseCase {
+    gateway;
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    /**
+     * Executes the create skill operation
+     * @param targetDir The root directory of the repository
+     * @param skillName The name of the skill to create
+     * @returns Result of the operation
+     */
+    async execute(targetDir, skillName) {
+        // Validate the skill name using Zod schema
+        const validationResult = SkillNameSchema.safeParse(skillName);
+        if (!validationResult.success) {
+            const errorMessage = validationResult.error.issues[0]?.message ??
+                "Invalid skill name";
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+        // Normalize the skill name
+        const normalizedName = normalizeSkillName(validationResult.data);
+        // Validate that the normalized name is not empty (handles whitespace-only input)
+        if (!normalizedName) {
+            return {
+                success: false,
+                error: "Skill name is required",
+            };
+        }
+        // Get the paths
+        const skillDirectoryPath = this.gateway.getSkillDirectoryPath(targetDir, normalizedName);
+        const skillFilePath = this.gateway.getSkillFilePath(targetDir, normalizedName);
+        // Check if the skill directory already exists
+        if (await this.gateway.skillDirectoryExists(targetDir, normalizedName)) {
+            return {
+                success: false,
+                error: `Skill already exists: ${skillDirectoryPath}`,
+                skillDirectoryPath,
+            };
+        }
+        // Ensure the skill directory exists
+        await this.gateway.ensureSkillDirectory(targetDir, normalizedName);
+        // Generate the content
+        const content = generateSkillContent(normalizedName);
+        // Write the SKILL.md file
+        await this.gateway.writeSkillFile(targetDir, normalizedName, content);
+        return {
+            success: true,
+            normalizedName,
+            skillDirectoryPath,
+            skillFilePath,
+        };
+    }
+}
+//# sourceMappingURL=create-skill.js.map

package/dist/use-cases/create-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill.js","sourceRoot":"","sources":["../../src/use-cases/create-skill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGhF;;;GAGG;AACH,MAAM,eAAe,GAAG,CAAC;KACpB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;KAChC,GAAG,CAAC,GAAG,EAAE,2CAA2C,CAAC;KACrD,KAAK,CACF,oBAAoB,EACpB,gFAAgF,CACnF,CAAC;AAaN;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACE;IAA7B,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CACT,SAAiB,EACjB,SAAiB;QAEjB,2CAA2C;QAC3C,MAAM,gBAAgB,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,YAAY,GACd,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO;gBACzC,oBAAoB,CAAC;YACzB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY;aACtB,CAAC;QACN,CAAC;QAED,2BAA2B;QAC3B,MAAM,cAAc,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEjE,iFAAiF;QACjF,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,wBAAwB;aAClC,CAAC;QACN,CAAC;QAED,gBAAgB;QAChB,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CACzD,SAAS,EACT,cAAc,CACjB,CAAC;QACF,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAC/C,SAAS,EACT,cAAc,CACjB,CAAC;QAEF,8CAA8C;QAC9C,IACI,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS,EAAE,cAAc,CAAC,EACpE,CAAC;YACC,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,yBAAyB,kBAAkB,EAAE;gBACpD,kBAAkB;aACrB,CAAC;QACN,CAAC;QAED,oCAAoC;QACpC,MAAM,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAEnE,uBAAuB;QACvB,MAAM,OAAO,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAErD,0BAA0B;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QAEtE,OAAO;YACH,OAAO,EAAE,IAAI;YACb,cAAc;YACd,kBAAkB;YAClB,aAAa;SAChB,CAAC;IACN,CAAC;CACJ"}

package/dist/use-cases/index.d.ts

@@ -5,5 +5,6 @@ export * from "./action-resolution.js";
 export * from "./candidate-builder.js";
 export * from "./copilot-setup.js";
 export * from "./create-copilot-agent.js";
+export * from "./create-skill.js";
 export * from "./workflow-generator.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/use-cases/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}

package/dist/use-cases/index.js

@@ -5,5 +5,6 @@ export * from "./action-resolution.js";
 export * from "./candidate-builder.js";
 export * from "./copilot-setup.js";
 export * from "./create-copilot-agent.js";
+export * from "./create-skill.js";
 export * from "./workflow-generator.js";
 //# sourceMappingURL=index.js.map

package/dist/use-cases/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lousy-agents/cli",
-    "version": "1.0.5",
+    "version": "1.1.0",
     "description": "CLI scaffolding tool that sets up projects with structure, instructions, and feedback loops for AI coding assistants",
     "type": "module",
     "repository": {