skillex 0.3.1 → 0.4.1

package/dist/catalog.js

@@ -6,6 +6,7 @@ import { normalizeAdapterList } from "./adapters.js";
 import { assertSafeRelativePath } from "./fs.js";
 import { fetchJson, fetchOptionalJson, fetchText } from "./http.js";
 import { debug } from "./output.js";
+import { parseSkillFrontmatter } from "./skill.js";
 import { CatalogError } from "./types.js";
 const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
 /**
@@ -210,13 +211,14 @@ async function loadCatalogFromTree(source) {
         const skillPath = skillFile.path.slice(0, -"/SKILL.md".length);
         const skillId = skillPath.split("/").pop();
         const skillBody = await fetchJsonLikeText(buildRawGitHubUrl(source.repo, source.ref, skillFile.path));
-        const metadata = extractSkillMetadata(skillBody);
+        const metadata = parseSkillFrontmatter(skillBody);
         return normalizeSkill({
             id: skillId,
             path: skillPath,
             name: metadata.name || skillId,
             description: metadata.description || "",
             files: collectFilesUnderPath(files, skillPath),
+            ...(metadata.category ? { category: metadata.category } : {}),
         }, source);
     }));
     return {
@@ -229,34 +231,6 @@ async function loadCatalogFromTree(source) {
 async function fetchJsonLikeText(url) {
     return fetchText(url, { headers: { Accept: "text/plain" } });
 }
-function extractSkillMetadata(content) {
-    const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
-    if (!match) {
-        return {};
-    }
-    const frontmatter = match[1];
-    if (frontmatter === undefined) {
-        return {};
-    }
-    const name = extractFrontmatterValue(frontmatter, "name");
-    const description = extractFrontmatterValue(frontmatter, "description");
-    return {
-        ...(name !== null ? { name } : {}),
-        ...(description !== null ? { description } : {}),
-    };
-}
-function extractFrontmatterValue(frontmatter, key) {
-    const expression = new RegExp(`^${key}:\\s*(.+)$`, "m");
-    const match = frontmatter.match(expression);
-    if (!match) {
-        return null;
-    }
-    const value = match[1];
-    if (value === undefined) {
-        return null;
-    }
-    return value.trim().replace(/^["']|["']$/g, "");
-}
 function collectFilesUnderPath(treeFiles, skillPath) {
     return treeFiles
         .filter((item) => item.type === "blob" && item.path.startsWith(`${skillPath}/`))
@@ -303,6 +277,7 @@ function normalizeSkill(skill, source) {
     const skillPath = skill.path || `${source.skillsDir}/${id}`;
     const files = Array.isArray(skill.files) ? skill.files.map(assertSafeRelativePath) : ["SKILL.md"];
     const uniqueFiles = [...new Set(files)];
+    const category = typeof skill.category === "string" && skill.category.trim() ? skill.category.trim() : undefined;
     return {
         id,
         name: skill.name || id,
@@ -314,6 +289,7 @@ function normalizeSkill(skill, source) {
         entry: skill.entry || "SKILL.md",
         path: stripLeadingSlash(skillPath),
         files: uniqueFiles,
+        ...(category !== undefined ? { category } : {}),
     };
 }
 /**

package/dist/cli.d.ts

@@ -1,3 +1,4 @@
+import type { ParsedArgs } from "./types.js";
 /**
  * Runs the Skillex CLI entrypoint.
  *
@@ -6,3 +7,15 @@
  */
 export declare function main(argv: string[]): Promise<void>;
 export declare function resolveCommandRoute(command: string | undefined): string;
+/**
+ * Parses argv into a typed `ParsedArgs` shape with strict validation:
+ *
+ * - Unknown flags raise `UNKNOWN_FLAG` with a "did you mean" suggestion.
+ * - Boolean flags (`BOOLEAN_FLAGS`) accept presence-only or `--flag=value` forms.
+ * - String flags (`STRING_FLAGS`) require a value via `--flag=value` or
+ *   `--flag value`. Missing values raise `MISSING_FLAG_VALUE`.
+ * - The literal `--` token marks end-of-options; remaining tokens become
+ *   `positionalAfter` and are forwarded to handlers (used by `run` to pass
+ *   arguments to the underlying script without flag interpretation).
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;