@lousy-agents/cli 2.6.0 → 2.7.0

package/dist/index.js

@@ -14681,6 +14681,90 @@ async function watchConfig(options) {
 
 // EXTERNAL MODULE: ./node_modules/yaml/dist/index.js
 var dist = __webpack_require__(1198);
+;// CONCATENATED MODULE: ./src/gateways/skill-lint-gateway.ts
+/**
+ * Gateway for skill lint file system operations.
+ * Discovers skill files and parses YAML frontmatter.
+ */ 
+
+
+
+/**
+ * File system implementation of the skill lint gateway.
+ */ class FileSystemSkillLintGateway {
+    async discoverSkills(targetDir) {
+        const skillsDir = (0,external_node_path_.join)(targetDir, ".github", "skills");
+        if (!await file_system_utils_fileExists(skillsDir)) {
+            return [];
+        }
+        const entries = await (0,promises_.readdir)(skillsDir, {
+            withFileTypes: true
+        });
+        const skills = [];
+        for (const entry of entries){
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            if (entry.name.includes("..") || entry.name.includes("/") || entry.name.includes("\\")) {
+                continue;
+            }
+            const skillFilePath = (0,external_node_path_.join)(skillsDir, entry.name, "SKILL.md");
+            if (await file_system_utils_fileExists(skillFilePath)) {
+                skills.push({
+                    filePath: skillFilePath,
+                    skillName: entry.name
+                });
+            }
+        }
+        return skills;
+    }
+    async readSkillFileContent(filePath) {
+        return (0,promises_.readFile)(filePath, "utf-8");
+    }
+    parseFrontmatter(content) {
+        const lines = content.split("\n");
+        if (lines[0]?.trim() !== "---") {
+            return null;
+        }
+        let endIndex = -1;
+        for(let i = 1; i < lines.length; i++){
+            if (lines[i]?.trim() === "---") {
+                endIndex = i;
+                break;
+            }
+        }
+        if (endIndex === -1) {
+            return null;
+        }
+        const yamlContent = lines.slice(1, endIndex).join("\n");
+        let data;
+        try {
+            const parsed = (0,dist.parse)(yamlContent);
+            data = parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+        } catch  {
+            return null;
+        }
+        const fieldLines = new Map();
+        for(let i = 1; i < endIndex; i++){
+            // Match YAML top-level field names: non-whitespace start, any chars except colon, then colon+space
+            const match = lines[i]?.match(/^([^\s:][^:]*?):\s/);
+            if (match?.[1]) {
+                fieldLines.set(match[1], i + 1);
+            }
+        }
+        return {
+            data: data ?? {},
+            fieldLines,
+            frontmatterStartLine: 1
+        };
+    }
+}
+/**
+ * Creates and returns the default skill lint gateway.
+ */ function createSkillLintGateway() {
+    return new FileSystemSkillLintGateway();
+}
+
 ;// CONCATENATED MODULE: ./src/gateways/tool-discovery-gateway.ts
 /**
  * Gateway for discovering CLI tools and commands from GitHub Actions workflows
@@ -15137,6 +15221,7 @@ var dist = __webpack_require__(1198);
 
 
 
+
 ;// CONCATENATED MODULE: ./src/use-cases/candidate-builder.ts
 /**
  * Use case for building setup step candidates from environment detection.
@@ -29802,6 +29887,137 @@ const CLI_TEMPLATE_DIR = (0,external_node_path_.join)(PROJECT_ROOT, "cli", "copi
  */ function readCliTemplateFile(relativePath) {
     return readTemplateFile(relativePath, CLI_TEMPLATE_DIR);
 }
+/**
+ * Builds the common filesystem nodes shared across all project types.
+ * Each template has its own versions of these files, but the structure is identical.
+ */ function buildCommonNodes(reader) {
+    return [
+        {
+            type: "file",
+            path: "biome.json",
+            content: reader("biome.template.json")
+        },
+        {
+            type: "file",
+            path: ".gitignore",
+            content: reader("gitignore.template")
+        },
+        {
+            type: "file",
+            path: ".editorconfig",
+            content: reader(".editorconfig")
+        },
+        {
+            type: "file",
+            path: ".nvmrc",
+            content: reader(".nvmrc")
+        },
+        {
+            type: "file",
+            path: ".yamllint",
+            content: reader(".yamllint")
+        },
+        // GitHub copilot instructions
+        {
+            type: "directory",
+            path: ".github"
+        },
+        {
+            type: "directory",
+            path: ".github/instructions"
+        },
+        {
+            type: "file",
+            path: ".github/copilot-instructions.md",
+            content: reader(".github/copilot-instructions.md")
+        },
+        {
+            type: "file",
+            path: ".github/instructions/test.instructions.md",
+            content: reader(".github/instructions/test.instructions.md")
+        },
+        {
+            type: "file",
+            path: ".github/instructions/spec.instructions.md",
+            content: reader(".github/instructions/spec.instructions.md")
+        },
+        {
+            type: "file",
+            path: ".github/instructions/pipeline.instructions.md",
+            content: reader(".github/instructions/pipeline.instructions.md")
+        },
+        {
+            type: "file",
+            path: ".github/instructions/software-architecture.instructions.md",
+            content: reader(".github/instructions/software-architecture.instructions.md")
+        },
+        // GitHub Issue Templates
+        {
+            type: "directory",
+            path: ".github/ISSUE_TEMPLATE"
+        },
+        {
+            type: "file",
+            path: ".github/ISSUE_TEMPLATE/feature-to-spec.yml",
+            content: reader(".github/ISSUE_TEMPLATE/feature-to-spec.yml")
+        },
+        // GitHub Workflows
+        {
+            type: "directory",
+            path: ".github/workflows"
+        },
+        {
+            type: "file",
+            path: ".github/workflows/assign-copilot.yml",
+            content: reader(".github/workflows/assign-copilot.yml")
+        },
+        {
+            type: "file",
+            path: ".github/workflows/ci.yml",
+            content: reader(".github/workflows/ci.yml")
+        },
+        // Specs directory
+        {
+            type: "directory",
+            path: ".github/specs"
+        },
+        {
+            type: "file",
+            path: ".github/specs/README.md",
+            content: reader(".github/specs/README.md")
+        },
+        // VSCode configuration
+        {
+            type: "directory",
+            path: ".vscode"
+        },
+        {
+            type: "file",
+            path: ".vscode/extensions.json",
+            content: reader(".vscode/extensions.json")
+        },
+        {
+            type: "file",
+            path: ".vscode/launch.json",
+            content: reader(".vscode/launch.json")
+        },
+        {
+            type: "file",
+            path: ".vscode/mcp.json",
+            content: reader(".vscode/mcp.json")
+        },
+        // Devcontainer configuration
+        {
+            type: "directory",
+            path: ".devcontainer"
+        },
+        {
+            type: "file",
+            path: ".devcontainer/devcontainer.json",
+            content: reader(".devcontainer/devcontainer.json")
+        }
+    ];
+}
 /**
  * Cached CLI structure - lazy-loaded on first access
  */ let cachedCliStructure = null;
@@ -29835,120 +30051,7 @@ const CLI_TEMPLATE_DIR = (0,external_node_path_.join)(PROJECT_ROOT, "cli", "copi
                 path: "vitest.setup.ts",
                 content: readCliTemplateFile("vitest.setup.ts")
             },
-            {
-                type: "file",
-                path: "biome.json",
-                content: readCliTemplateFile("biome.template.json")
-            },
-            {
-                type: "file",
-                path: ".gitignore",
-                content: readCliTemplateFile("gitignore.template")
-            },
-            {
-                type: "file",
-                path: ".editorconfig",
-                content: readCliTemplateFile(".editorconfig")
-            },
-            {
-                type: "file",
-                path: ".nvmrc",
-                content: readCliTemplateFile(".nvmrc")
-            },
-            {
-                type: "file",
-                path: ".yamllint",
-                content: readCliTemplateFile(".yamllint")
-            },
-            // GitHub copilot instructions
-            {
-                type: "directory",
-                path: ".github"
-            },
-            {
-                type: "directory",
-                path: ".github/instructions"
-            },
-            {
-                type: "file",
-                path: ".github/copilot-instructions.md",
-                content: readCliTemplateFile(".github/copilot-instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/test.instructions.md",
-                content: readCliTemplateFile(".github/instructions/test.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/spec.instructions.md",
-                content: readCliTemplateFile(".github/instructions/spec.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/pipeline.instructions.md",
-                content: readCliTemplateFile(".github/instructions/pipeline.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/software-architecture.instructions.md",
-                content: readCliTemplateFile(".github/instructions/software-architecture.instructions.md")
-            },
-            // GitHub Issue Templates
-            {
-                type: "directory",
-                path: ".github/ISSUE_TEMPLATE"
-            },
-            {
-                type: "file",
-                path: ".github/ISSUE_TEMPLATE/feature-to-spec.yml",
-                content: readCliTemplateFile(".github/ISSUE_TEMPLATE/feature-to-spec.yml")
-            },
-            // GitHub Workflows
-            {
-                type: "directory",
-                path: ".github/workflows"
-            },
-            {
-                type: "file",
-                path: ".github/workflows/assign-copilot.yml",
-                content: readCliTemplateFile(".github/workflows/assign-copilot.yml")
-            },
-            {
-                type: "file",
-                path: ".github/workflows/ci.yml",
-                content: readCliTemplateFile(".github/workflows/ci.yml")
-            },
-            // Specs directory
-            {
-                type: "directory",
-                path: ".github/specs"
-            },
-            {
-                type: "file",
-                path: ".github/specs/README.md",
-                content: readCliTemplateFile(".github/specs/README.md")
-            },
-            // VSCode configuration
-            {
-                type: "directory",
-                path: ".vscode"
-            },
-            {
-                type: "file",
-                path: ".vscode/extensions.json",
-                content: readCliTemplateFile(".vscode/extensions.json")
-            },
-            {
-                type: "file",
-                path: ".vscode/launch.json",
-                content: readCliTemplateFile(".vscode/launch.json")
-            },
-            {
-                type: "file",
-                path: ".vscode/mcp.json",
-                content: readCliTemplateFile(".vscode/mcp.json")
-            },
+            ...buildCommonNodes(readCliTemplateFile),
             // Source code
             {
                 type: "directory",
@@ -29963,16 +30066,6 @@ const CLI_TEMPLATE_DIR = (0,external_node_path_.join)(PROJECT_ROOT, "cli", "copi
                 type: "file",
                 path: "src/index.test.ts",
                 content: readCliTemplateFile("src/index.test.ts")
-            },
-            // Devcontainer configuration
-            {
-                type: "directory",
-                path: ".devcontainer"
-            },
-            {
-                type: "file",
-                path: ".devcontainer/devcontainer.json",
-                content: readCliTemplateFile(".devcontainer/devcontainer.json")
             }
         ]
     };
@@ -29994,6 +30087,11 @@ const CLI_TEMPLATE_DIR = (0,external_node_path_.join)(PROJECT_ROOT, "cli", "copi
 /**
  * Cached webapp structure - lazy-loaded on first access
  */ let cachedWebappStructure = null;
+/**
+ * Helper function to read webapp template files
+ */ function readWebappTemplateFile(relativePath) {
+    return readTemplateFile(relativePath, WEBAPP_TEMPLATE_DIR);
+}
 /**
  * Builds the webapp project filesystem structure by reading template files
  * This is called lazily only when webapp scaffolding is needed
@@ -30007,137 +30105,29 @@ const CLI_TEMPLATE_DIR = (0,external_node_path_.join)(PROJECT_ROOT, "cli", "copi
             {
                 type: "file",
                 path: "package.json",
-                content: readTemplateFile("package.json")
+                content: readWebappTemplateFile("package.json")
             },
             {
                 type: "file",
                 path: "tsconfig.json",
-                content: readTemplateFile("tsconfig.json")
+                content: readWebappTemplateFile("tsconfig.json")
             },
             {
                 type: "file",
                 path: "next.config.ts",
-                content: readTemplateFile("next.config.ts")
+                content: readWebappTemplateFile("next.config.ts")
             },
             {
                 type: "file",
                 path: "vitest.config.ts",
-                content: readTemplateFile("vitest.config.ts")
+                content: readWebappTemplateFile("vitest.config.ts")
             },
             {
                 type: "file",
                 path: "vitest.setup.ts",
-                content: readTemplateFile("vitest.setup.ts")
-            },
-            {
-                type: "file",
-                path: "biome.json",
-                content: readTemplateFile("biome.json")
-            },
-            {
-                type: "file",
-                path: ".editorconfig",
-                content: readTemplateFile(".editorconfig")
-            },
-            {
-                type: "file",
-                path: ".nvmrc",
-                content: readTemplateFile(".nvmrc")
-            },
-            {
-                type: "file",
-                path: ".yamllint",
-                content: readTemplateFile(".yamllint")
-            },
-            // GitHub copilot instructions
-            {
-                type: "directory",
-                path: ".github"
-            },
-            {
-                type: "directory",
-                path: ".github/instructions"
-            },
-            {
-                type: "file",
-                path: ".github/copilot-instructions.md",
-                content: readTemplateFile(".github/copilot-instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/test.instructions.md",
-                content: readTemplateFile(".github/instructions/test.instructions.md")
+                content: readWebappTemplateFile("vitest.setup.ts")
             },
-            {
-                type: "file",
-                path: ".github/instructions/spec.instructions.md",
-                content: readTemplateFile(".github/instructions/spec.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/pipeline.instructions.md",
-                content: readTemplateFile(".github/instructions/pipeline.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/software-architecture.instructions.md",
-                content: readTemplateFile(".github/instructions/software-architecture.instructions.md")
-            },
-            // GitHub Issue Templates
-            {
-                type: "directory",
-                path: ".github/ISSUE_TEMPLATE"
-            },
-            {
-                type: "file",
-                path: ".github/ISSUE_TEMPLATE/feature-to-spec.yml",
-                content: readTemplateFile(".github/ISSUE_TEMPLATE/feature-to-spec.yml")
-            },
-            // GitHub Workflows
-            {
-                type: "directory",
-                path: ".github/workflows"
-            },
-            {
-                type: "file",
-                path: ".github/workflows/assign-copilot.yml",
-                content: readTemplateFile(".github/workflows/assign-copilot.yml")
-            },
-            // Specs directory
-            {
-                type: "directory",
-                path: ".github/specs"
-            },
-            {
-                type: "file",
-                path: ".github/specs/README.md",
-                content: readTemplateFile(".github/specs/README.md")
-            },
-            // VSCode configuration
-            {
-                type: "directory",
-                path: ".vscode"
-            },
-            {
-                type: "file",
-                path: ".vscode/extensions.json",
-                content: readTemplateFile(".vscode/extensions.json")
-            },
-            {
-                type: "file",
-                path: ".vscode/launch.json",
-                content: readTemplateFile(".vscode/launch.json")
-            },
-            // Devcontainer configuration
-            {
-                type: "directory",
-                path: ".devcontainer"
-            },
-            {
-                type: "file",
-                path: ".devcontainer/devcontainer.json",
-                content: readTemplateFile(".devcontainer/devcontainer.json")
-            }
+            ...buildCommonNodes(readWebappTemplateFile)
         ]
     };
     return cachedWebappStructure;
@@ -30185,130 +30175,7 @@ const CLI_TEMPLATE_DIR = (0,external_node_path_.join)(PROJECT_ROOT, "cli", "copi
                 path: "vitest.setup.ts",
                 content: readRestApiTemplateFile("vitest.setup.ts")
             },
-            {
-                type: "file",
-                path: "biome.json",
-                content: readRestApiTemplateFile("biome.template.json")
-            },
-            {
-                type: "file",
-                path: ".editorconfig",
-                content: readRestApiTemplateFile(".editorconfig")
-            },
-            {
-                type: "file",
-                path: ".nvmrc",
-                content: readRestApiTemplateFile(".nvmrc")
-            },
-            {
-                type: "file",
-                path: ".yamllint",
-                content: readRestApiTemplateFile(".yamllint")
-            },
-            {
-                type: "file",
-                path: ".gitignore",
-                content: readRestApiTemplateFile("gitignore.template")
-            },
-            // GitHub copilot instructions
-            {
-                type: "directory",
-                path: ".github"
-            },
-            {
-                type: "directory",
-                path: ".github/instructions"
-            },
-            {
-                type: "file",
-                path: ".github/copilot-instructions.md",
-                content: readRestApiTemplateFile(".github/copilot-instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/test.instructions.md",
-                content: readRestApiTemplateFile(".github/instructions/test.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/spec.instructions.md",
-                content: readRestApiTemplateFile(".github/instructions/spec.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/pipeline.instructions.md",
-                content: readRestApiTemplateFile(".github/instructions/pipeline.instructions.md")
-            },
-            {
-                type: "file",
-                path: ".github/instructions/software-architecture.instructions.md",
-                content: readRestApiTemplateFile(".github/instructions/software-architecture.instructions.md")
-            },
-            // GitHub Issue Templates
-            {
-                type: "directory",
-                path: ".github/ISSUE_TEMPLATE"
-            },
-            {
-                type: "file",
-                path: ".github/ISSUE_TEMPLATE/feature-to-spec.yml",
-                content: readRestApiTemplateFile(".github/ISSUE_TEMPLATE/feature-to-spec.yml")
-            },
-            // GitHub Workflows
-            {
-                type: "directory",
-                path: ".github/workflows"
-            },
-            {
-                type: "file",
-                path: ".github/workflows/assign-copilot.yml",
-                content: readRestApiTemplateFile(".github/workflows/assign-copilot.yml")
-            },
-            {
-                type: "file",
-                path: ".github/workflows/ci.yml",
-                content: readRestApiTemplateFile(".github/workflows/ci.yml")
-            },
-            // Specs directory
-            {
-                type: "directory",
-                path: ".github/specs"
-            },
-            {
-                type: "file",
-                path: ".github/specs/README.md",
-                content: readRestApiTemplateFile(".github/specs/README.md")
-            },
-            // VSCode configuration
-            {
-                type: "directory",
-                path: ".vscode"
-            },
-            {
-                type: "file",
-                path: ".vscode/extensions.json",
-                content: readRestApiTemplateFile(".vscode/extensions.json")
-            },
-            {
-                type: "file",
-                path: ".vscode/launch.json",
-                content: readRestApiTemplateFile(".vscode/launch.json")
-            },
-            {
-                type: "file",
-                path: ".vscode/mcp.json",
-                content: readRestApiTemplateFile(".vscode/mcp.json")
-            },
-            // Devcontainer configuration
-            {
-                type: "directory",
-                path: ".devcontainer"
-            },
-            {
-                type: "file",
-                path: ".devcontainer/devcontainer.json",
-                content: readRestApiTemplateFile(".devcontainer/devcontainer.json")
-            }
+            ...buildCommonNodes(readRestApiTemplateFile)
         ]
     };
     return cachedRestApiStructure;
@@ -31153,6 +31020,203 @@ const initCommand = defineCommand({
     }
 });
 
+;// CONCATENATED MODULE: ./src/use-cases/lint-skill-frontmatter.ts
+/**
+ * Use case for linting GitHub Copilot Agent Skill frontmatter.
+ * Validates required and recommended fields, name format, and directory naming.
+ */ 
+/**
+ * Zod schema for validating agent skill frontmatter.
+ * Based on the agentskills.io specification.
+ */ const AgentSkillFrontmatterSchema = schemas_object({
+    name: schemas_string().min(1, "Name is required").max(64, "Name must be 64 characters or fewer").regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "Name must contain only lowercase letters, numbers, and hyphens. It cannot start/end with a hyphen or contain consecutive hyphens."),
+    description: schemas_string().min(1, "Description is required").max(1024, "Description must be 1024 characters or fewer").refine((s)=>s.trim().length > 0, {
+        message: "Description cannot be empty or whitespace-only"
+    }),
+    license: schemas_string().optional(),
+    compatibility: schemas_string().max(500, "Compatibility must be 500 characters or fewer").optional(),
+    metadata: record(schemas_string(), schemas_string()).optional(),
+    "allowed-tools": schemas_string().optional()
+});
+/**
+ * Recommended (optional) fields that produce warnings when missing.
+ */ const RECOMMENDED_FIELDS = [
+    "allowed-tools"
+];
+/**
+ * Use case for linting skill frontmatter across a repository.
+ */ class LintSkillFrontmatterUseCase {
+    gateway;
+    constructor(gateway){
+        this.gateway = gateway;
+    }
+    async execute(input) {
+        if (!input.targetDir) {
+            throw new Error("Target directory is required");
+        }
+        const skills = await this.gateway.discoverSkills(input.targetDir);
+        const results = [];
+        for (const skill of skills){
+            const content = await this.gateway.readSkillFileContent(skill.filePath);
+            const result = this.lintSkill(skill, content);
+            results.push(result);
+        }
+        const totalErrors = results.reduce((sum, r)=>sum + r.diagnostics.filter((d)=>d.severity === "error").length, 0);
+        const totalWarnings = results.reduce((sum, r)=>sum + r.diagnostics.filter((d)=>d.severity === "warning").length, 0);
+        return {
+            results,
+            totalSkills: skills.length,
+            totalErrors,
+            totalWarnings
+        };
+    }
+    lintSkill(skill, content) {
+        let parsed = null;
+        let diagnostics = [];
+        try {
+            parsed = this.gateway.parseFrontmatter(content);
+        } catch (error) {
+            const messagePrefix = "Invalid YAML frontmatter";
+            const errorMessage = error instanceof Error && error.message ? `${messagePrefix}: ${error.message}` : `${messagePrefix}.`;
+            diagnostics.push({
+                line: 1,
+                severity: "error",
+                message: errorMessage
+            });
+        }
+        if (!parsed) {
+            if (diagnostics.length === 0) {
+                const message = hasFrontmatterDelimiters(content) ? "Invalid YAML frontmatter. The content between --- delimiters could not be parsed as valid YAML." : "Missing YAML frontmatter. Skill files must begin with --- delimited YAML frontmatter.";
+                diagnostics.push({
+                    line: 1,
+                    severity: "error",
+                    message
+                });
+            }
+            return {
+                filePath: skill.filePath,
+                skillName: skill.skillName,
+                diagnostics,
+                valid: false
+            };
+        }
+        const frontmatterDiagnostics = this.validateFrontmatter(parsed, skill.skillName);
+        diagnostics = diagnostics.concat(frontmatterDiagnostics);
+        return {
+            filePath: skill.filePath,
+            skillName: skill.skillName,
+            diagnostics,
+            valid: diagnostics.every((d)=>d.severity !== "error")
+        };
+    }
+    validateFrontmatter(parsed, parentDirName) {
+        const diagnostics = [];
+        // Validate against Zod schema
+        const result = AgentSkillFrontmatterSchema.safeParse(parsed.data);
+        if (!result.success) {
+            for (const issue of result.error.issues){
+                const fieldName = issue.path[0]?.toString();
+                const line = fieldName ? parsed.fieldLines.get(fieldName) ?? parsed.frontmatterStartLine : parsed.frontmatterStartLine;
+                diagnostics.push({
+                    line,
+                    severity: "error",
+                    message: issue.message,
+                    field: fieldName
+                });
+            }
+        }
+        // Check name matches parent directory
+        if (result.success && result.data.name !== parentDirName) {
+            const nameLine = parsed.fieldLines.get("name") ?? parsed.frontmatterStartLine;
+            diagnostics.push({
+                line: nameLine,
+                severity: "error",
+                message: `Frontmatter name '${result.data.name}' must match parent directory name '${parentDirName}'`,
+                field: "name"
+            });
+        }
+        // Check recommended fields
+        for (const field of RECOMMENDED_FIELDS){
+            if (parsed.data[field] === undefined) {
+                diagnostics.push({
+                    line: parsed.frontmatterStartLine,
+                    severity: "warning",
+                    message: `Recommended field '${field}' is missing`,
+                    field
+                });
+            }
+        }
+        return diagnostics;
+    }
+}
+/**
+ * Checks whether content has opening and closing --- frontmatter delimiters.
+ */ function hasFrontmatterDelimiters(content) {
+    const lines = content.split("\n");
+    if (lines[0]?.trim() !== "---") {
+        return false;
+    }
+    for(let i = 1; i < lines.length; i++){
+        if (lines[i]?.trim() === "---") {
+            return true;
+        }
+    }
+    return false;
+}
+
+;// CONCATENATED MODULE: ./src/commands/lint.ts
+/**
+ * CLI command for linting agent skill frontmatter.
+ * Discovers skills, validates frontmatter, and reports diagnostics.
+ */ 
+
+
+
+/**
+ * The `lint` command for validating agent skill files.
+ */ const lintCommand = defineCommand({
+    meta: {
+        name: "lint",
+        description: "Lint agent skill frontmatter. Validates required and recommended fields in SKILL.md files."
+    },
+    run: async (context)=>{
+        const targetDir = typeof context.data?.targetDir === "string" ? context.data.targetDir : process.cwd();
+        const gateway = createSkillLintGateway();
+        const useCase = new LintSkillFrontmatterUseCase(gateway);
+        const output = await useCase.execute({
+            targetDir
+        });
+        if (output.totalSkills === 0) {
+            consola.info("No skills found in .github/skills/");
+            return;
+        }
+        consola.info(`Discovered ${output.totalSkills} skill(s)`);
+        for (const result of output.results){
+            if (result.diagnostics.length === 0) {
+                consola.success(`${result.filePath}: OK`);
+                continue;
+            }
+            for (const diagnostic of result.diagnostics){
+                const prefix = `${result.filePath}:${diagnostic.line}`;
+                const fieldInfo = diagnostic.field ? ` [${diagnostic.field}]` : "";
+                if (diagnostic.severity === "error") {
+                    consola.error(`${prefix}${fieldInfo}: ${diagnostic.message}`);
+                } else {
+                    consola.warn(`${prefix}${fieldInfo}: ${diagnostic.message}`);
+                }
+            }
+        }
+        if (output.totalErrors > 0) {
+            throw new Error(`Skill lint failed: ${output.totalErrors} error(s), ${output.totalWarnings} warning(s)`);
+        }
+        if (output.totalWarnings > 0) {
+            consola.warn(`Skill lint passed with ${output.totalWarnings} warning(s)`);
+        } else {
+            consola.success("All skills passed lint checks");
+        }
+    }
+});
+
 ;// CONCATENATED MODULE: ./src/entities/copilot-agent.ts
 /**
  * Core domain entity for GitHub Copilot custom agent files.
@@ -31272,7 +31336,9 @@ You are a ${normalizedName} agent specialized in {domain/responsibility}.
 ;// CONCATENATED MODULE: ./src/entities/skill.ts
 /**
  * Core domain entity for GitHub Copilot Agent Skills.
- * Handles name normalization and SKILL.md content generation.
+ * Handles name normalization, SKILL.md content generation, and lint types.
+ */ /**
+ * Severity levels for skill lint diagnostics.
  */ /**
  * Normalizes a skill name to lowercase with hyphens.
  * Handles spaces, mixed case, multiple spaces, and leading/trailing spaces.
@@ -31486,6 +31552,7 @@ const skillArgs = {
 
 
 
+
 const src_main = defineCommand({
     meta: {
         name: "lousy-agents",
@@ -31494,6 +31561,7 @@ const src_main = defineCommand({
     },
     subCommands: {
         init: initCommand,
+        lint: lintCommand,
         new: newCommand,
         "copilot-setup": copilotSetupCommand
     }