@stacksjs/skills 0.70.88 → 0.70.90

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { Skill, SkillMetadata, SkillManifest } from './types';
+export { listSkills, getSkill, validateSkill, loadSkillMetadata } from './skills';

package/dist/index.js

@@ -0,0 +1 @@
+export { listSkills, getSkill, validateSkill, loadSkillMetadata } from "./skills";

package/dist/skills.d.ts

@@ -0,0 +1,5 @@
+import type { Skill, SkillMetadata } from './types';
+export declare function listSkills(): string[];
+export declare function getSkill(name: string): Skill | null;
+export declare function loadSkillMetadata(name: string): SkillMetadata | null;
+export declare function validateSkill(name: string): { valid: boolean, errors: string[] };

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/dist/types.d.ts

@@ -0,0 +1,28 @@
+export declare interface SkillMetadata {
+  name: string
+  description: string
+  license?: string
+  compatibility?: string
+  metadata?: Record<string, unknown>
+  'allowed-tools'?: string
+  'disable-model-invocation'?: boolean
+  'user-invocable'?: boolean
+  context?: 'fork'
+  agent?: 'Explore' | 'Plan' | 'general-purpose'
+  'argument-hint'?: string
+  model?: string
+  effort?: 'low' | 'medium' | 'high' | 'max'
+}
+export declare interface Skill {
+  metadata: SkillMetadata
+  instructions: string
+  path: string
+  scripts?: string[]
+  references?: string[]
+  assets?: string[]
+}
+export declare interface SkillManifest {
+  skills: Skill[]
+  version: string
+  framework: string
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/skills",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.88",
+  "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.88",
-    "@stacksjs/storage": "0.70.88"
+    "@stacksjs/path": "0.70.90",
+    "@stacksjs/storage": "0.70.90"
   },
   "devDependencies": {
     "better-dx": "^0.2.16",
-    "@stacksjs/types": "0.70.88"
+    "@stacksjs/types": "0.70.90"
   }
 }