@skillmarkdown/cli 0.2.2 → 0.3.0

package/README.md

@@ -106,7 +106,7 @@ By default, `login` uses the project’s built-in development config. You can ov
 - `SKILLMD_FIREBASE_PROJECT_ID`
 
 See `.env.example` for the expected keys.
-Maintainers: built-in defaults are defined in `src/lib/auth-defaults.ts`.
+Maintainers: built-in defaults are defined in `src/lib/auth/defaults.ts`.
 
 Example override file:
 

package/dist/cli.js

@@ -5,7 +5,7 @@ const init_1 = require("./commands/init");
 const login_1 = require("./commands/login");
 const logout_1 = require("./commands/logout");
 const validate_1 = require("./commands/validate");
-const cli_text_1 = require("./lib/cli-text");
+const cli_text_1 = require("./lib/shared/cli-text");
 const COMMAND_HANDLERS = {
     init: init_1.runInitCommand,
     validate: validate_1.runValidateCommand,

package/dist/commands/init.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runInitCommand = runInitCommand;
-const cli_text_1 = require("../lib/cli-text");
-const command_output_1 = require("../lib/command-output");
-const scaffold_1 = require("../lib/scaffold");
-const validator_1 = require("../lib/validator");
+const cli_text_1 = require("../lib/shared/cli-text");
+const command_output_1 = require("../lib/shared/command-output");
+const scaffold_1 = require("../lib/scaffold/scaffold");
+const validator_1 = require("../lib/validation/validator");
 function parseInitArgs(args) {
     let skipValidation = false;
     let template = "minimal";

package/dist/commands/login.js

@@ -1,64 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runLoginCommand = runLoginCommand;
-const cli_text_1 = require("../lib/cli-text");
-const command_output_1 = require("../lib/command-output");
-const auth_config_1 = require("../lib/auth-config");
-const auth_session_1 = require("../lib/auth-session");
-const github_device_flow_1 = require("../lib/github-device-flow");
-const firebase_auth_1 = require("../lib/firebase-auth");
-function parseFlags(args) {
-    let status = false;
-    let reauth = false;
-    for (const arg of args) {
-        if (arg === "--status") {
-            status = true;
-            continue;
-        }
-        if (arg === "--reauth") {
-            reauth = true;
-            continue;
-        }
-        return { status: false, reauth: false, valid: false };
-    }
-    if (status && reauth) {
-        return { status: false, reauth: false, valid: false };
-    }
-    return { status, reauth, valid: true };
-}
-function formatSessionProject(session, currentConfigProjectId) {
-    if (!session.projectId) {
-        if (currentConfigProjectId) {
-            return { label: `unknown (current config: ${currentConfigProjectId})`, mismatch: false };
-        }
-        return { label: "unknown", mismatch: false };
-    }
-    return {
-        label: session.projectId,
-        mismatch: Boolean(currentConfigProjectId && session.projectId !== currentConfigProjectId),
-    };
-}
-function printSessionStatus(session, currentConfigProjectId) {
-    if (!session) {
-        console.log("Not logged in.");
-        return 1;
-    }
-    const project = formatSessionProject(session, currentConfigProjectId);
-    if (session.email) {
-        console.log(`Logged in with GitHub as ${session.email} (project: ${project.label}).`);
-    }
-    else {
-        console.log(`Logged in with GitHub (uid: ${session.uid}, project: ${project.label}).`);
-    }
-    if (project.mismatch && currentConfigProjectId) {
-        console.log(`Current CLI config targets project '${currentConfigProjectId}'. ` +
-            "Run 'skillmd login --reauth' to switch projects.");
-    }
-    return 0;
-}
+const cli_text_1 = require("../lib/shared/cli-text");
+const command_output_1 = require("../lib/shared/command-output");
+const config_1 = require("../lib/auth/config");
+const session_1 = require("../lib/auth/session");
+const github_device_flow_1 = require("../lib/auth/github-device-flow");
+const firebase_auth_1 = require("../lib/auth/firebase-auth");
+const login_flow_1 = require("../lib/auth/login-flow");
+const login_flags_1 = require("../lib/auth/login-flags");
+const login_status_1 = require("../lib/auth/login-status");
 function requireConfig(env) {
     try {
-        return (0, auth_config_1.getLoginEnvConfig)(env);
+        return (0, config_1.getLoginEnvConfig)(env);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : "invalid login configuration";
@@ -68,72 +22,27 @@ function requireConfig(env) {
     }
 }
 async function runLoginCommand(args, options = {}) {
-    const { status, reauth, valid } = parseFlags(args);
+    const { status, reauth, valid } = (0, login_flags_1.parseLoginFlags)(args);
     if (!valid) {
         return (0, command_output_1.failWithUsage)("skillmd login: unsupported argument(s)", cli_text_1.LOGIN_USAGE);
     }
-    const readSessionFn = options.readSession ?? auth_session_1.readAuthSession;
-    const writeSessionFn = options.writeSession ?? auth_session_1.writeAuthSession;
-    const clearSessionFn = options.clearSession ?? auth_session_1.clearAuthSession;
+    const readSessionFn = options.readSession ?? session_1.readAuthSession;
+    const writeSessionFn = options.writeSession ?? session_1.writeAuthSession;
+    const clearSessionFn = options.clearSession ?? session_1.clearAuthSession;
     try {
         const config = requireConfig(options.env ?? process.env);
         if (status) {
-            return printSessionStatus(readSessionFn(), config.firebaseProjectId);
-        }
-        const existingSession = readSessionFn();
-        if (existingSession && !reauth) {
-            const verifyRefreshTokenFn = options.verifyRefreshToken ?? firebase_auth_1.verifyFirebaseRefreshToken;
-            try {
-                const validation = await verifyRefreshTokenFn(config.firebaseApiKey, existingSession.refreshToken);
-                if (validation.valid) {
-                    const project = formatSessionProject(existingSession, config.firebaseProjectId);
-                    if (existingSession.email) {
-                        console.log(`Already logged in as ${existingSession.email} (project: ${project.label}). ` +
-                            "Run 'skillmd logout' first.");
-                    }
-                    else {
-                        console.log(`Already logged in (uid: ${existingSession.uid}, project: ${project.label}). ` +
-                            "Run 'skillmd logout' first.");
-                    }
-                    if (project.mismatch) {
-                        console.log(`Current CLI config targets project '${config.firebaseProjectId}'. ` +
-                            "Run 'skillmd login --reauth' to switch projects.");
-                    }
-                    return 0;
-                }
-                clearSessionFn();
-                console.log("Existing session is no longer valid. Starting re-authentication.");
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : "Unknown error";
-                console.error(`skillmd login: unable to verify existing session (${message}). ` +
-                    "Keeping current session. Run 'skillmd login --reauth' to force reauthentication.");
-                return 1;
-            }
+            return (0, login_status_1.printSessionStatus)(readSessionFn(), config.firebaseProjectId);
         }
-        const requestDeviceCodeFn = options.requestDeviceCode ?? github_device_flow_1.requestDeviceCode;
-        const pollForAccessTokenFn = options.pollForAccessToken ?? github_device_flow_1.pollForAccessToken;
-        const signInFn = options.signInWithGitHubAccessToken ?? firebase_auth_1.signInWithGitHubAccessToken;
-        const deviceCode = await requestDeviceCodeFn(config.githubClientId);
-        console.log("Open this URL in your browser to authorize skillmd:");
-        console.log(deviceCode.verificationUriComplete ?? deviceCode.verificationUri);
-        console.log(`Then enter code: ${deviceCode.userCode}`);
-        const token = await pollForAccessTokenFn(config.githubClientId, deviceCode.deviceCode, deviceCode.interval, deviceCode.expiresIn);
-        const firebaseSession = await signInFn(config.firebaseApiKey, token.accessToken);
-        writeSessionFn({
-            provider: "github",
-            uid: firebaseSession.localId,
-            email: firebaseSession.email,
-            refreshToken: firebaseSession.refreshToken,
-            projectId: config.firebaseProjectId,
+        return await (0, login_flow_1.executeLoginFlow)(config, reauth, {
+            readSession: readSessionFn,
+            writeSession: writeSessionFn,
+            clearSession: clearSessionFn,
+            requestDeviceCode: options.requestDeviceCode ?? github_device_flow_1.requestDeviceCode,
+            pollForAccessToken: options.pollForAccessToken ?? github_device_flow_1.pollForAccessToken,
+            signInWithGitHubAccessToken: options.signInWithGitHubAccessToken ?? firebase_auth_1.signInWithGitHubAccessToken,
+            verifyRefreshToken: options.verifyRefreshToken ?? firebase_auth_1.verifyFirebaseRefreshToken,
         });
-        if (firebaseSession.email) {
-            console.log(`Login successful. Signed in as ${firebaseSession.email} (project: ${config.firebaseProjectId}).`);
-        }
-        else {
-            console.log(`Login successful (project: ${config.firebaseProjectId}).`);
-        }
-        return 0;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : "Unknown error";

package/dist/commands/logout.js

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runLogoutCommand = runLogoutCommand;
-const cli_text_1 = require("../lib/cli-text");
-const command_output_1 = require("../lib/command-output");
-const auth_session_1 = require("../lib/auth-session");
+const cli_text_1 = require("../lib/shared/cli-text");
+const command_output_1 = require("../lib/shared/command-output");
+const session_1 = require("../lib/auth/session");
 function runLogoutCommand(args, options = {}) {
     if (args.length > 0) {
         return (0, command_output_1.failWithUsage)("skillmd logout: unsupported argument(s)", cli_text_1.LOGOUT_USAGE);
     }
     try {
-        const clearSessionFn = options.clearSession ?? auth_session_1.clearAuthSession;
+        const clearSessionFn = options.clearSession ?? session_1.clearAuthSession;
         const removed = clearSessionFn();
         if (removed) {
             console.log("Logged out.");

package/dist/commands/validate.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runValidateCommand = runValidateCommand;
 const node_path_1 = require("node:path");
-const cli_text_1 = require("../lib/cli-text");
-const command_output_1 = require("../lib/command-output");
-const upstream_validator_1 = require("../lib/upstream-validator");
-const validator_1 = require("../lib/validator");
+const cli_text_1 = require("../lib/shared/cli-text");
+const command_output_1 = require("../lib/shared/command-output");
+const upstream_validator_1 = require("../lib/validation/upstream-validator");
+const validator_1 = require("../lib/validation/validator");
 function runValidateCommand(args, options = {}) {
     try {
         const cwd = options.cwd ?? process.cwd();

package/dist/lib/{auth-config.js → auth/config.js}

@@ -5,7 +5,7 @@ exports.getDefaultUserEnvPath = getDefaultUserEnvPath;
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
-const auth_defaults_1 = require("./auth-defaults");
+const defaults_1 = require("./defaults");
 const USER_ENV_RELATIVE_PATH = ".skillmd/.env";
 function parseDotEnv(content) {
     const values = {};
@@ -52,9 +52,9 @@ function pickValue(...candidates) {
 }
 function getLoginEnvConfig(env = process.env, options = {}) {
     const dotEnv = loadDotEnv(getDefaultUserEnvPath(options));
-    const githubClientId = pickValue(env.SKILLMD_GITHUB_CLIENT_ID, dotEnv.SKILLMD_GITHUB_CLIENT_ID, auth_defaults_1.DEFAULT_LOGIN_AUTH_CONFIG.githubClientId);
-    const firebaseApiKey = pickValue(env.SKILLMD_FIREBASE_API_KEY, dotEnv.SKILLMD_FIREBASE_API_KEY, auth_defaults_1.DEFAULT_LOGIN_AUTH_CONFIG.firebaseApiKey);
-    const firebaseProjectId = pickValue(env.SKILLMD_FIREBASE_PROJECT_ID, dotEnv.SKILLMD_FIREBASE_PROJECT_ID, auth_defaults_1.DEFAULT_LOGIN_AUTH_CONFIG.firebaseProjectId);
+    const githubClientId = pickValue(env.SKILLMD_GITHUB_CLIENT_ID, dotEnv.SKILLMD_GITHUB_CLIENT_ID, defaults_1.DEFAULT_LOGIN_AUTH_CONFIG.githubClientId);
+    const firebaseApiKey = pickValue(env.SKILLMD_FIREBASE_API_KEY, dotEnv.SKILLMD_FIREBASE_API_KEY, defaults_1.DEFAULT_LOGIN_AUTH_CONFIG.firebaseApiKey);
+    const firebaseProjectId = pickValue(env.SKILLMD_FIREBASE_PROJECT_ID, dotEnv.SKILLMD_FIREBASE_PROJECT_ID, defaults_1.DEFAULT_LOGIN_AUTH_CONFIG.firebaseProjectId);
     if (!githubClientId || !firebaseApiKey || !firebaseProjectId) {
         throw new Error("missing login configuration");
     }

package/dist/lib/{firebase-auth.js → auth/firebase-auth.js}

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.signInWithGitHubAccessToken = signInWithGitHubAccessToken;
 exports.verifyFirebaseRefreshToken = verifyFirebaseRefreshToken;
-const http_1 = require("./http");
+const http_1 = require("../shared/http");
 const FIREBASE_HTTP_TIMEOUT_MS = 10000;
 async function parseJsonApiResponse(response, apiLabel) {
     const text = await response.text();

package/dist/lib/{github-device-flow.js → auth/github-device-flow.js}

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.requestDeviceCode = requestDeviceCode;
 exports.pollForAccessToken = pollForAccessToken;
-const http_1 = require("./http");
+const http_1 = require("../shared/http");
 const GITHUB_DEVICE_CODE_URL = "https://github.com/login/device/code";
 const GITHUB_ACCESS_TOKEN_URL = "https://github.com/login/oauth/access_token";
 const GITHUB_HTTP_TIMEOUT_MS = 10000;

package/dist/lib/auth/login-flags.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseLoginFlags = parseLoginFlags;
+function parseLoginFlags(args) {
+    let status = false;
+    let reauth = false;
+    for (const arg of args) {
+        if (arg === "--status") {
+            status = true;
+            continue;
+        }
+        if (arg === "--reauth") {
+            reauth = true;
+            continue;
+        }
+        return { status: false, reauth: false, valid: false };
+    }
+    if (status && reauth) {
+        return { status: false, reauth: false, valid: false };
+    }
+    return { status, reauth, valid: true };
+}

package/dist/lib/auth/login-flow.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeLoginFlow = executeLoginFlow;
+const login_status_1 = require("./login-status");
+async function executeLoginFlow(config, reauth, dependencies) {
+    const existingSession = dependencies.readSession();
+    if (existingSession && !reauth) {
+        try {
+            const validation = await dependencies.verifyRefreshToken(config.firebaseApiKey, existingSession.refreshToken);
+            if (validation.valid) {
+                const project = (0, login_status_1.formatSessionProject)(existingSession, config.firebaseProjectId);
+                if (existingSession.email) {
+                    console.log(`Already logged in as ${existingSession.email} (project: ${project.label}). ` +
+                        "Run 'skillmd logout' first.");
+                }
+                else {
+                    console.log(`Already logged in (uid: ${existingSession.uid}, project: ${project.label}). ` +
+                        "Run 'skillmd logout' first.");
+                }
+                if (project.mismatch) {
+                    console.log(`Current CLI config targets project '${config.firebaseProjectId}'. ` +
+                        "Run 'skillmd login --reauth' to switch projects.");
+                }
+                return 0;
+            }
+            dependencies.clearSession();
+            console.log("Existing session is no longer valid. Starting re-authentication.");
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            console.error(`skillmd login: unable to verify existing session (${message}). ` +
+                "Keeping current session. Run 'skillmd login --reauth' to force reauthentication.");
+            return 1;
+        }
+    }
+    const deviceCode = await dependencies.requestDeviceCode(config.githubClientId);
+    console.log("Open this URL in your browser to authorize skillmd:");
+    console.log(deviceCode.verificationUriComplete ?? deviceCode.verificationUri);
+    console.log(`Then enter code: ${deviceCode.userCode}`);
+    const token = await dependencies.pollForAccessToken(config.githubClientId, deviceCode.deviceCode, deviceCode.interval, deviceCode.expiresIn);
+    const firebaseSession = await dependencies.signInWithGitHubAccessToken(config.firebaseApiKey, token.accessToken);
+    dependencies.writeSession({
+        provider: "github",
+        uid: firebaseSession.localId,
+        email: firebaseSession.email,
+        refreshToken: firebaseSession.refreshToken,
+        projectId: config.firebaseProjectId,
+    });
+    if (firebaseSession.email) {
+        console.log(`Login successful. Signed in as ${firebaseSession.email} (project: ${config.firebaseProjectId}).`);
+    }
+    else {
+        console.log(`Login successful (project: ${config.firebaseProjectId}).`);
+    }
+    return 0;
+}

package/dist/lib/auth/login-status.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSessionProject = formatSessionProject;
+exports.printSessionStatus = printSessionStatus;
+function formatSessionProject(session, currentConfigProjectId) {
+    if (!session.projectId) {
+        if (currentConfigProjectId) {
+            return { label: `unknown (current config: ${currentConfigProjectId})`, mismatch: false };
+        }
+        return { label: "unknown", mismatch: false };
+    }
+    return {
+        label: session.projectId,
+        mismatch: Boolean(currentConfigProjectId && session.projectId !== currentConfigProjectId),
+    };
+}
+function printSessionStatus(session, currentConfigProjectId) {
+    if (!session) {
+        console.log("Not logged in.");
+        return 1;
+    }
+    const project = formatSessionProject(session, currentConfigProjectId);
+    if (session.email) {
+        console.log(`Logged in with GitHub as ${session.email} (project: ${project.label}).`);
+    }
+    else {
+        console.log(`Logged in with GitHub (uid: ${session.uid}, project: ${project.label}).`);
+    }
+    if (project.mismatch && currentConfigProjectId) {
+        console.log(`Current CLI config targets project '${currentConfigProjectId}'. ` +
+            "Run 'skillmd login --reauth' to switch projects.");
+    }
+    return 0;
+}

package/dist/lib/scaffold/templates/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./skill-markdown"), exports);
+__exportStar(require("./resources"), exports);

package/dist/lib/{templates.js → scaffold/templates/resources.js}

@@ -1,8 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildSkillMarkdown = buildSkillMarkdown;
-exports.buildMinimalSkillMarkdown = buildMinimalSkillMarkdown;
-exports.buildVerboseSkillMarkdown = buildVerboseSkillMarkdown;
 exports.buildGitignore = buildGitignore;
 exports.buildScriptsReadme = buildScriptsReadme;
 exports.buildExtractScriptPython = buildExtractScriptPython;
@@ -11,39 +8,6 @@ exports.buildFormsReference = buildFormsReference;
 exports.buildAssetsReadme = buildAssetsReadme;
 exports.buildReportTemplate = buildReportTemplate;
 exports.buildLookupTableCsv = buildLookupTableCsv;
-const skill_spec_1 = require("./skill-spec");
-const SECTION_PLACEHOLDERS = {
-    Scope: "Define the boundaries of this skill: what it should and should not handle.",
-    "When to use": "Describe the signals or request patterns that should trigger this skill. Keep SKILL.md focused and move deep details into references/ files.",
-    Inputs: "List required and optional inputs, expected formats, and assumptions. Add structured templates to references/FORMS.md when helpful.",
-    Outputs: "Describe expected outputs, side effects, and completion criteria. Use assets/report-template.md when a fixed output structure is useful.",
-    "Steps / Procedure": "Provide ordered steps the agent should follow, including key decision points. See [the reference guide](references/REFERENCE.md) for detailed rules. Run helper scripts such as scripts/extract.py when needed.",
-    Examples: "Add one or two realistic examples of inputs and expected outputs.",
-    "Limitations / Failure modes": "Document known limitations, failure cases, and recommended recovery actions.",
-    "Security / Tool access": "State required tools/permissions and any security constraints. If needed, set frontmatter allowed-tools to pre-approve tool usage.",
-};
-function buildSkillMarkdown(name) {
-    const sections = skill_spec_1.STRICT_SECTION_TITLES.map((title) => `## ${title}\n\n${SECTION_PLACEHOLDERS[title]}`).join("\n\n");
-    return `---
-name: ${name}
-description: Explain what this skill does and when an agent should use it.
-# compatibility: "Optional: environment requirements (products, packages, network access)."
-# metadata:
-#   author: "your-org"
-#   version: "1.0.0"
-# allowed-tools: "Optional: space-delimited pre-approved tools."
-license: Optional. Add a license name or reference to a bundled license file.
----
-
-${sections}
-`;
-}
-function buildMinimalSkillMarkdown(name) {
-    return buildSkillMarkdown(name);
-}
-function buildVerboseSkillMarkdown(name) {
-    return buildSkillMarkdown(name);
-}
 function buildGitignore() {
     return `node_modules/
 dist/

package/dist/lib/scaffold/templates/skill-markdown.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSkillMarkdown = buildSkillMarkdown;
+exports.buildMinimalSkillMarkdown = buildMinimalSkillMarkdown;
+exports.buildVerboseSkillMarkdown = buildVerboseSkillMarkdown;
+const skill_spec_1 = require("../skill-spec");
+const SECTION_PLACEHOLDERS = {
+    Scope: "Define the boundaries of this skill: what it should and should not handle.",
+    "When to use": "Describe the signals or request patterns that should trigger this skill. Keep SKILL.md focused and move deep details into references/ files.",
+    Inputs: "List required and optional inputs, expected formats, and assumptions. Add structured templates to references/FORMS.md when helpful.",
+    Outputs: "Describe expected outputs, side effects, and completion criteria. Use assets/report-template.md when a fixed output structure is useful.",
+    "Steps / Procedure": "Provide ordered steps the agent should follow, including key decision points. See [the reference guide](references/REFERENCE.md) for detailed rules. Run helper scripts such as scripts/extract.py when needed.",
+    Examples: "Add one or two realistic examples of inputs and expected outputs.",
+    "Limitations / Failure modes": "Document known limitations, failure cases, and recommended recovery actions.",
+    "Security / Tool access": "State required tools/permissions and any security constraints. If needed, set frontmatter allowed-tools to pre-approve tool usage.",
+};
+function buildSkillMarkdown(name) {
+    const sections = skill_spec_1.STRICT_SECTION_TITLES.map((title) => `## ${title}\n\n${SECTION_PLACEHOLDERS[title]}`).join("\n\n");
+    return `---
+name: ${name}
+description: Explain what this skill does and when an agent should use it.
+# compatibility: "Optional: environment requirements (products, packages, network access)."
+# metadata:
+#   author: "your-org"
+#   version: "1.0.0"
+# allowed-tools: "Optional: space-delimited pre-approved tools."
+license: Optional. Add a license name or reference to a bundled license file.
+---
+
+${sections}
+`;
+}
+function buildMinimalSkillMarkdown(name) {
+    return buildSkillMarkdown(name);
+}
+function buildVerboseSkillMarkdown(name) {
+    return buildSkillMarkdown(name);
+}

package/dist/lib/{validator.js → validation/validator.js}

@@ -4,7 +4,7 @@ exports.validateSkill = validateSkill;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const yaml_1 = require("yaml");
-const skill_spec_1 = require("./skill-spec");
+const skill_spec_1 = require("../scaffold/skill-spec");
 const SKILL_FILE = "SKILL.md";
 function stripUtf8Bom(content) {
     return content.replace(/^\uFEFF/, "");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillmarkdown/cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "CLI for scaffolding SKILL.md-based AI skills",
   "license": "MIT",
   "type": "commonjs",
@@ -25,7 +25,7 @@
     "prepublishOnly": "npm run clean && npm run build",
     "smoke:link": "bash ./scripts/smoke-link.sh",
     "smoke:pack": "bash ./scripts/smoke-pack.sh",
-    "test": "npm run build && node --test tests/*.test.js"
+    "test": "npm run build && node --test \"tests/**/*.test.js\""
   },
   "engines": {
     "node": ">=18"