@stacksjs/skills 0.70.87 → 0.70.90

package/dist/index.js

@@ -1,2 +1 @@
-// @bun
-export{e as validateSkill,k as loadSkillMetadata,a as listSkills,i as getSkill};
+export { listSkills, getSkill, validateSkill, loadSkillMetadata } from "./skills";

package/dist/skills.js

@@ -0,0 +1,74 @@
+import { join, resolve } from "@stacksjs/path";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+const SKILLS_DIR = resolve(join(import.meta.dir, "..", "..", "..", "..", "..", ".claude", "skills"));
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match)
+    return {
+      metadata: { name: "", description: "" },
+      body: content
+    };
+  const [, frontmatterStr, body] = match, metadata = {};
+  for (const line of (frontmatterStr ?? "").split(`
+`)) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1)
+      continue;
+    const key = line.slice(0, colonIndex).trim(), value = line.slice(colonIndex + 1).trim();
+    metadata[key] = value;
+  }
+  return { metadata, body: body ?? "" };
+}
+export function listSkills() {
+  if (!existsSync(SKILLS_DIR))
+    return [];
+  return readdirSync(SKILLS_DIR).filter((entry) => {
+    const entryPath = join(SKILLS_DIR, entry);
+    return statSync(entryPath).isDirectory() && existsSync(join(entryPath, "SKILL.md"));
+  });
+}
+export function getSkill(name) {
+  const skillPath = join(SKILLS_DIR, name, "SKILL.md");
+  if (!existsSync(skillPath))
+    return null;
+  const content = readFileSync(skillPath, "utf-8"), { metadata, body } = parseFrontmatter(content), skillDir = join(SKILLS_DIR, name), scripts = existsSync(join(skillDir, "scripts")) ? readdirSync(join(skillDir, "scripts")) : [], references = existsSync(join(skillDir, "references")) ? readdirSync(join(skillDir, "references")) : [], assets = existsSync(join(skillDir, "assets")) ? readdirSync(join(skillDir, "assets")) : [];
+  return {
+    metadata,
+    instructions: body,
+    path: skillPath,
+    scripts,
+    references,
+    assets
+  };
+}
+export function loadSkillMetadata(name) {
+  return getSkill(name)?.metadata ?? null;
+}
+export function validateSkill(name) {
+  const errors = [], skillDir = join(SKILLS_DIR, name);
+  if (!existsSync(skillDir)) {
+    errors.push(`Skill directory not found: ${skillDir}`);
+    return { valid: !1, errors };
+  }
+  const skillPath = join(skillDir, "SKILL.md");
+  if (!existsSync(skillPath)) {
+    errors.push(`SKILL.md not found in ${skillDir}`);
+    return { valid: !1, errors };
+  }
+  const content = readFileSync(skillPath, "utf-8"), { metadata } = parseFrontmatter(content);
+  if (!metadata.name)
+    errors.push("Missing required field: name");
+  else {
+    if (metadata.name.length > 64)
+      errors.push("Name must be 1-64 characters");
+    if (!/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(metadata.name))
+      errors.push("Name must be lowercase letters, numbers, and hyphens only");
+    if (metadata.name !== name)
+      errors.push(`Name "${metadata.name}" must match directory name "${name}"`);
+  }
+  if (!metadata.description)
+    errors.push("Missing required field: description");
+  else if (metadata.description.length > 1024)
+    errors.push("Description must be 1-1024 characters");
+  return { valid: errors.length === 0, errors };
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/skills",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.90",
   "description": "Agent skills for the Stacks framework, following the agentskills.io standard.",
   "author": "Chris Breuer",
   "contributors": [
@@ -54,11 +54,11 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/path": "0.70.87",
-    "@stacksjs/storage": "0.70.87"
+    "@stacksjs/path": "0.70.90",
+    "@stacksjs/storage": "0.70.90"
   },
   "devDependencies": {
     "better-dx": "^0.2.16",
-    "@stacksjs/types": "0.70.87"
+    "@stacksjs/types": "0.70.90"
   }
 }