@stacksjs/skills 0.70.23

package/dist/index.js

@@ -0,0 +1,3 @@
+// @bun
+import{join as s,resolve as k}from"@stacksjs/path";import{existsSync as r,readFileSync as f,readdirSync as d,statSync as h}from"fs";var o=k(s(import.meta.dir,"..","..","..","..","..",".claude","skills"));function p(n){let t=n.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);if(!t)return{metadata:{name:"",description:""},body:n};let[,i,a]=t,l={};for(let e of(i??"").split(`
+`)){let c=e.indexOf(":");if(c===-1)continue;let u=e.slice(0,c).trim(),m=e.slice(c+1).trim();l[u]=m}return{metadata:l,body:a??""}}function y(){if(!r(o))return[];return d(o).filter((n)=>{let t=s(o,n);return h(t).isDirectory()&&r(s(t,"SKILL.md"))})}function S(n){let t=s(o,n,"SKILL.md");if(!r(t))return null;let i=f(t,"utf-8"),{metadata:a,body:l}=p(i),e=s(o,n),c=r(s(e,"scripts"))?d(s(e,"scripts")):[],u=r(s(e,"references"))?d(s(e,"references")):[],m=r(s(e,"assets"))?d(s(e,"assets")):[];return{metadata:a,instructions:l,path:t,scripts:c,references:u,assets:m}}function g(n){return S(n)?.metadata??null}function b(n){let t=[],i=s(o,n);if(!r(i))return t.push(`Skill directory not found: ${i}`),{valid:!1,errors:t};let a=s(i,"SKILL.md");if(!r(a))return t.push(`SKILL.md not found in ${i}`),{valid:!1,errors:t};let l=f(a,"utf-8"),{metadata:e}=p(l);if(!e.name)t.push("Missing required field: name");else{if(e.name.length>64)t.push("Name must be 1-64 characters");if(!/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(e.name))t.push("Name must be lowercase letters, numbers, and hyphens only");if(e.name!==n)t.push(`Name "${e.name}" must match directory name "${n}"`)}if(!e.description)t.push("Missing required field: description");else if(e.description.length>1024)t.push("Description must be 1-1024 characters");return{valid:t.length===0,errors:t}}export{b as validateSkill,g as loadSkillMetadata,y as listSkills,S as getSkill};

package/dist/src/index.d.ts

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

package/dist/src/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/src/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

@@ -0,0 +1,59 @@
+{
+  "name": "@stacksjs/skills",
+  "type": "module",
+  "version": "0.70.23",
+  "description": "Agent skills for the Stacks framework, following the agentskills.io standard.",
+  "author": "Chris Breuer",
+  "contributors": [
+    "Chris Breuer <chris@stacksjs.com>"
+  ],
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/storage/framework/core/skills#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./storage/framework/core/skills"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "skills",
+    "agent",
+    "ai",
+    "agentskills",
+    "stacks"
+  ],
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "bun": "./src/*",
+      "import": "./dist/*"
+    }
+  },
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "README.md",
+    "dist",
+    "skills"
+  ],
+  "scripts": {
+    "build": "bun build.ts",
+    "typecheck": "bun tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@stacksjs/path": "0.70.23",
+    "@stacksjs/storage": "0.70.23"
+  },
+  "devDependencies": {
+    "better-dx": "^0.2.12",
+    "@stacksjs/types": "0.70.23"
+  }
+}