@stacksjs/skills 0.75.515 → 0.75.519

package/dist/skills.js

@@ -1,2 +1,2 @@
-import{existsSync,readdirSync,readFileSync,statSync}from"node:fs";import{appPath,frameworkPath,join}from"@stacksjs/path";function skillSources(){return[appPath("Skills"),frameworkPath("defaults/ai/skills")]}function resolveSkillDir(name){for(const source of skillSources()){const dir=join(source,name);if(existsSync(join(dir,"SKILL.md")))return dir}return null}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(){const names=new Set;for(const source of skillSources()){if(!existsSync(source))continue;for(const entry of readdirSync(source)){const entryPath=join(source,entry);if(statSync(entryPath).isDirectory()&&existsSync(join(entryPath,"SKILL.md")))names.add(entry)}}return[...names].sort()}export function getSkill(name){const skillDir=resolveSkillDir(name);if(!skillDir)return null;const skillPath=join(skillDir,"SKILL.md"),content=readFileSync(skillPath,"utf-8"),{metadata,body}=parseFrontmatter(content),listDir=(dir)=>existsSync(join(skillDir,dir))?readdirSync(join(skillDir,dir)):[];return{metadata,instructions:body,path:skillPath,scripts:listDir("scripts"),references:listDir("references"),assets:listDir("assets")}}export function loadSkillMetadata(name){return getSkill(name)?.metadata??null}export function validateSkill(name){const errors=[],skillDir=resolveSkillDir(name);if(!skillDir){errors.push(`Skill not found in any source: ${skillSources().map((source)=>join(source,name)).join(", ")}`);return{valid:!1,errors}}const content=readFileSync(join(skillDir,"SKILL.md"),"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}}export function bundledSkillsPath(){return frameworkPath("defaults/ai/skills")}export function projectSkillsPath(){return appPath("Skills")}export function resolveSkillPath(name){return resolveSkillDir(name)}
+import{existsSync,readdirSync,readFileSync,statSync}from"node:fs";import{appPath,frameworkPath,join}from"@stacksjs/path";function skillSources(){return[appPath("Skills"),frameworkPath("defaults/ai/skills")]}function resolveSkillDir(name){for(const source of skillSources()){const dir=join(source,name);if(existsSync(join(dir,"SKILL.md")))return dir}return null}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;const metadata={};for(const line of(frontmatterStr??"").split(`
+`)){const colonIndex=line.indexOf(":");if(colonIndex===-1)continue;const key=line.slice(0,colonIndex).trim();const value=line.slice(colonIndex+1).trim();metadata[key]=value}return{metadata,body:body??""}}export function listSkills(){const names=new Set;for(const source of skillSources()){if(!existsSync(source))continue;for(const entry of readdirSync(source)){const entryPath=join(source,entry);if(statSync(entryPath).isDirectory()&&existsSync(join(entryPath,"SKILL.md")))names.add(entry)}}return[...names].sort()}export function getSkill(name){const skillDir=resolveSkillDir(name);if(!skillDir)return null;const skillPath=join(skillDir,"SKILL.md");const content=readFileSync(skillPath,"utf-8");const{metadata,body}=parseFrontmatter(content);const listDir=(dir)=>existsSync(join(skillDir,dir))?readdirSync(join(skillDir,dir)):[];return{metadata,instructions:body,path:skillPath,scripts:listDir("scripts"),references:listDir("references"),assets:listDir("assets")}}export function loadSkillMetadata(name){const skill=getSkill(name);return skill?.metadata??null}export function validateSkill(name){const errors=[];const skillDir=resolveSkillDir(name);if(!skillDir){errors.push(`Skill not found in any source: ${skillSources().map((source)=>join(source,name)).join(", ")}`);return{valid:false,errors}}const content=readFileSync(join(skillDir,"SKILL.md"),"utf-8");const{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}}export function bundledSkillsPath(){return frameworkPath("defaults/ai/skills")}export function projectSkillsPath(){return appPath("Skills")}export function resolveSkillPath(name){return resolveSkillDir(name)}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/skills",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.515",
+  "version": "0.75.519",
   "description": "Reads the Stacks framework's agent skills, following the agentskills.io standard. The skills themselves ship in storage/framework/defaults/ai/skills.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,11 +58,11 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/path": "0.75.515",
-    "@stacksjs/storage": "0.75.515"
+    "@stacksjs/path": "0.75.519",
+    "@stacksjs/storage": "0.75.519"
   },
   "devDependencies": {
     "better-dx": "^0.2.24",
-    "@stacksjs/types": "0.75.515"
+    "@stacksjs/types": "0.75.519"
   }
 }