@crustjs/skills 0.1.2 → 0.2.0

package/dist/index.js

@@ -1,16 +1,1435 @@
-// @bun
-import{accessSync as wX,constants as MX,statSync as TX}from"fs";import{homedir as JQ}from"os";import{delimiter as _X,join as J}from"path";var y=J(".agents","skills"),OX=J(".crust","skills");function NQ(Q){if(Q!==JQ())return J(Q,".config");let X=process.env.XDG_CONFIG_HOME?.trim();return X&&X.length>0?X:J(Q,".config")}function f(Q){return J(Q,".agents","skills")}function jX(Q){return J(Q,".crust","skills")}function u(Q){return Q==="project"&&process.cwd()===JQ()?"global":Q}var s={amp:{label:"Amp",class:"universal",projectSkillsDir:y,globalSkillsDir:f},adal:{label:"AdaL",class:"additional",projectSkillsDir:J(".adal","skills"),globalSkillsDir:(Q)=>J(Q,".adal","skills"),detectCommands:["adal"]},antigravity:{label:"Antigravity",class:"additional",projectSkillsDir:J(".agent","skills"),globalSkillsDir:(Q)=>J(Q,".gemini","antigravity","skills"),detectCommands:["antigravity"]},augment:{label:"Augment",class:"additional",projectSkillsDir:J(".augment","skills"),globalSkillsDir:(Q)=>J(Q,".augment","skills"),detectCommands:["augment"]},"claude-code":{label:"Claude Code",class:"additional",projectSkillsDir:J(".claude","skills"),globalSkillsDir:(Q)=>J(process.env.CLAUDE_CONFIG_DIR?.trim()||J(Q,".claude"),"skills"),detectCommands:["claude","claude-code"]},cline:{label:"Cline",class:"universal",projectSkillsDir:y,globalSkillsDir:f},codebuddy:{label:"CodeBuddy",class:"additional",projectSkillsDir:J(".codebuddy","skills"),globalSkillsDir:(Q)=>J(Q,".codebuddy","skills"),detectCommands:["codebuddy"]},codex:{label:"Codex",class:"universal",projectSkillsDir:y,globalSkillsDir:f},"command-code":{label:"Command Code",class:"additional",projectSkillsDir:J(".commandcode","skills"),globalSkillsDir:(Q)=>J(Q,".commandcode","skills"),detectCommands:["command-code","commandcode"]},continue:{label:"Continue",class:"additional",projectSkillsDir:J(".continue","skills"),globalSkillsDir:(Q)=>J(Q,".continue","skills"),detectCommands:["continue"]},cortex:{label:"Cortex Code",class:"additional",projectSkillsDir:J(".cortex","skills"),globalSkillsDir:(Q)=>J(Q,".snowflake","cortex","skills"),detectCommands:["cortex"]},crush:{label:"Crush",class:"additional",projectSkillsDir:J(".crush","skills"),globalSkillsDir:(Q)=>J(NQ(Q),"crush","skills"),detectCommands:["crush"]},cursor:{label:"Cursor",class:"universal",projectSkillsDir:y,globalSkillsDir:f},droid:{label:"Droid",class:"additional",projectSkillsDir:J(".factory","skills"),globalSkillsDir:(Q)=>J(Q,".factory","skills"),detectCommands:["droid"]},"gemini-cli":{label:"Gemini CLI",class:"universal",projectSkillsDir:y,globalSkillsDir:f},"github-copilot":{label:"GitHub Copilot",class:"universal",projectSkillsDir:y,globalSkillsDir:f},goose:{label:"Goose",class:"additional",projectSkillsDir:J(".goose","skills"),globalSkillsDir:(Q)=>J(NQ(Q),"goose","skills"),detectCommands:["goose"]},"iflow-cli":{label:"iFlow CLI",class:"additional",projectSkillsDir:J(".iflow","skills"),globalSkillsDir:(Q)=>J(Q,".iflow","skills"),detectCommands:["iflow","iflow-cli"]},junie:{label:"Junie",class:"additional",projectSkillsDir:J(".junie","skills"),globalSkillsDir:(Q)=>J(Q,".junie","skills"),detectCommands:["junie"]},kilo:{label:"Kilo Code",class:"additional",projectSkillsDir:J(".kilocode","skills"),globalSkillsDir:(Q)=>J(Q,".kilocode","skills"),detectCommands:["kilo","kilocode"]},"kimi-cli":{label:"Kimi Code CLI",class:"universal",projectSkillsDir:y,globalSkillsDir:f},"kiro-cli":{label:"Kiro CLI",class:"additional",projectSkillsDir:J(".kiro","skills"),globalSkillsDir:(Q)=>J(Q,".kiro","skills"),detectCommands:["kiro","kiro-cli"]},kode:{label:"Kode",class:"additional",projectSkillsDir:J(".kode","skills"),globalSkillsDir:(Q)=>J(Q,".kode","skills"),detectCommands:["kode"]},mcpjam:{label:"MCPJam",class:"additional",projectSkillsDir:J(".mcpjam","skills"),globalSkillsDir:(Q)=>J(Q,".mcpjam","skills"),detectCommands:["mcpjam"]},"mistral-vibe":{label:"Mistral Vibe",class:"additional",projectSkillsDir:J(".vibe","skills"),globalSkillsDir:(Q)=>J(Q,".vibe","skills"),detectCommands:["mistral-vibe","vibe"]},mux:{label:"Mux",class:"additional",projectSkillsDir:J(".mux","skills"),globalSkillsDir:(Q)=>J(Q,".mux","skills"),detectCommands:["mux"]},neovate:{label:"Neovate",class:"additional",projectSkillsDir:J(".neovate","skills"),globalSkillsDir:(Q)=>J(Q,".neovate","skills"),detectCommands:["neovate"]},opencode:{label:"OpenCode",class:"universal",projectSkillsDir:y,globalSkillsDir:f},openclaw:{label:"OpenClaw",class:"additional",projectSkillsDir:"skills",globalSkillsDir:(Q)=>J(Q,".openclaw","skills"),detectCommands:["openclaw"]},openhands:{label:"OpenHands",class:"additional",projectSkillsDir:J(".openhands","skills"),globalSkillsDir:(Q)=>J(Q,".openhands","skills"),detectCommands:["openhands"]},pi:{label:"Pi",class:"additional",projectSkillsDir:J(".pi","skills"),globalSkillsDir:(Q)=>J(Q,".pi","agent","skills"),detectCommands:["pi"]},pochi:{label:"Pochi",class:"additional",projectSkillsDir:J(".pochi","skills"),globalSkillsDir:(Q)=>J(Q,".pochi","skills"),detectCommands:["pochi"]},qoder:{label:"Qoder",class:"additional",projectSkillsDir:J(".qoder","skills"),globalSkillsDir:(Q)=>J(Q,".qoder","skills"),detectCommands:["qoder"]},"qwen-code":{label:"Qwen Code",class:"additional",projectSkillsDir:J(".qwen","skills"),globalSkillsDir:(Q)=>J(Q,".qwen","skills"),detectCommands:["qwen","qwen-code"]},replit:{label:"Replit",class:"universal",projectSkillsDir:y,globalSkillsDir:f},roo:{label:"Roo Code",class:"additional",projectSkillsDir:J(".roo","skills"),globalSkillsDir:(Q)=>J(Q,".roo","skills"),detectCommands:["roo","roo-code"]},trae:{label:"Trae",class:"additional",projectSkillsDir:J(".trae","skills"),globalSkillsDir:(Q)=>J(Q,".trae","skills"),detectCommands:["trae"]},"trae-cn":{label:"Trae CN",class:"additional",projectSkillsDir:J(".trae","skills"),globalSkillsDir:(Q)=>J(Q,".trae-cn","skills"),detectCommands:["trae-cn","trae"]},windsurf:{label:"Windsurf",class:"additional",projectSkillsDir:J(".windsurf","skills"),globalSkillsDir:(Q)=>J(Q,".codeium","windsurf","skills"),detectCommands:["windsurf"]},zencoder:{label:"Zencoder",class:"additional",projectSkillsDir:J(".zencoder","skills"),globalSkillsDir:(Q)=>J(Q,".zencoder","skills"),detectCommands:["zencoder"]}},a=Object.keys(s),A=Object.fromEntries(a.map((Q)=>[Q,s[Q].label]));function S(){return a.filter((Q)=>s[Q].class==="universal")}function m(){return a.filter((Q)=>s[Q].class==="additional")}function bX(Q){return s[Q].class==="universal"}async function n(Q){let X=typeof Q==="string"?{home:Q}:Q??{},Z=X.cwd??process.cwd(),H=X.commandChecker??((W)=>Promise.resolve(RX(W))),$=[];for(let W of m()){let Y=s[W].detectCommands??[],F=!1;for(let x of Y)if(await H(x,Z)){F=!0;break}if(F)$.push(W)}return $}function N(Q,X,Z){let H=u(X),$=s[Q];if(H==="project")return J(process.cwd(),$.projectSkillsDir,Z);return J($.globalSkillsDir(JQ()),Z)}function c(Q,X){if(u(Q)==="project")return J(process.cwd(),OX,X);return J(jX(JQ()),X)}function RX(Q){let Z=(process.env.PATH??"").split(_X).filter((W)=>W.length>0),H=process.platform==="win32",$=H?(process.env.PATHEXT??".EXE;.CMD;.BAT;.COM").split(";").filter((W)=>W.length>0):[];for(let W of Z){if(!H&&PQ(J(W,Q)))return!0;if(H){for(let Y of $)if(PQ(J(W,Q+Y)))return!0}}return!1}function PQ(Q){try{if(!TX(Q).isFile())return!1;return wX(Q,MX.X_OK),!0}catch{return!1}}import{Crust as EX}from"@crustjs/core";function BQ(Q){if(Q===void 0)return[];return(Array.isArray(Q)?Q:[Q]).flatMap((Z)=>Z.split(/\r?\n/)).map((Z)=>Z.trim()).filter((Z)=>Z.length>0)}function kQ(Q){let X=Q?.trim();if(!X)return[];return X.split(/\r?\n/)}function FQ(Q){return Q.length>0}var DQ=Symbol("crust.skill.commandAnnotations");function IX(Q){return Q instanceof EX?Q._node:Q}function CX(Q,X){let Z=IX(Q),H=BQ(typeof X==="string"||Array.isArray(X)?X:X.instructions??[]);if(H.length===0)return Q;let $=xQ(Z)?.instructions??[],W=[...new Set([...$,...H])];return Object.defineProperty(Z,DQ,{value:{instructions:W},enumerable:!0,configurable:!0}),Q}function xQ(Q){let X=Q[DQ];if(!X?.instructions||X.instructions.length===0)return;return{instructions:[...X.instructions]}}import{readdir as BZ,readFile as $X,realpath as YX,stat as qX}from"fs/promises";import{join as IQ,sep as WX}from"path";import{resolveSourceDir as zZ}from"@crustjs/utils";import{lstat as nX,mkdir as eQ,readlink as tX,realpath as eX,rm as qQ,symlink as QZ,writeFile as lQ}from"fs/promises";import{dirname as QX,join as sQ}from"path";class L extends Error{name="SkillConflictError";details;constructor(Q){super(LX(Q));this.details=Q}}function LX(Q){let X=`Skill conflict for agent "${Q.agent}": directory "${Q.outputDir}"`;if(Q.kindMismatch)return`${X} was installed as a "${Q.kindMismatch.existing}" skill but "${Q.kindMismatch.attempted}" was attempted. Use force: true to overwrite, or uninstall the existing skill first.`;if(Q.manifestMalformed){let{reason:Z,rawKind:H}=Q.manifestMalformed;switch(Z){case"unknown-kind":return`${X} was created by Crust but its crust.json declares an unrecognized kind "${H??"<unknown>"}" \u2014 likely a hand-edit typo or a `+"crust.json written by a newer Crust release. Fix the kind field, upgrade Crust, or pass force: true to overwrite.";case"parse-error":return`${X} contains a crust.json that is not valid JSON. Repair the file, or pass force: true to overwrite the directory.`;case"not-an-object":return`${X} contains a crust.json whose top-level value is not a JSON object. Repair the file, or pass force: true to overwrite the directory.`;case"missing-version":return`${X} contains a crust.json with no "version" string. Repair the file, or pass force: true to overwrite the directory.`}}return`${X} already exists but was not created by Crust (no crust.json found). Delete or rename the conflicting skill to resolve.`}function AQ(Q){return SQ(Q,[])}function SQ(Q,X){let Z=NX(Q.meta.name),H=[...X,Z],$=PX(Q.args),W=DX(Q.effectiveFlags),Y=SX(Q.subCommands,H),F=xQ(Q);return{name:Z,path:H,description:Q.meta.description,usage:Q.meta.usage,instructions:F?.instructions,runnable:typeof Q.run==="function",args:$,flags:W,children:Y}}function NX(Q){return Q.trim().toLowerCase()}function PX(Q){if(!Q||Q.length===0)return[];return Q.map(kX)}function kX(Q){let X={name:Q.name,type:vQ(Q.type),required:Q.required===!0,variadic:Q.variadic===!0};if(Q.description!==void 0)X.description=Q.description;if(Q.default!==void 0)X.default=hQ(Q.default);return X}function DX(Q){if(!Q)return[];return Object.keys(Q).sort().map((Z)=>{return AX(Z,Q[Z])})}function AX(Q,X){let Z={name:Q,type:vQ(X.type),required:X.required===!0,multiple:X.multiple===!0,short:X.short,aliases:X.aliases?[...X.aliases].sort():[]};if(X.description!==void 0)Z.description=X.description;if(X.default!==void 0)Z.default=hQ(X.default);return Z}function SX(Q,X){return Object.keys(Q).sort().map((H)=>{return SQ(Q[H],X)})}function vQ(Q){if(Q==="number"||Q==="boolean")return Q;return"string"}function hQ(Q){if(Array.isArray(Q))return JSON.stringify(Q);return String(Q)}function WQ(Q){if(/[:#[\]{}&*!|>'"`,@?\\]|^\s|\s$|^---|[\n\r]/.test(Q))return`"${Q.replace(/\\/g,"\\\\").replace(/"/g,"\\\"").replace(/\n/g,"\\n").replace(/\r/g,"\\r")}"`;return Q}function yQ(Q){return Q.replace(/(?<!\\)\|/g,"\\|")}function fQ(Q,X){let Z=[],H=gQ(Q);Z.push({path:"SKILL.md",content:vX(Q,X,H)});for(let $ of H){let W=i($),Y=$.children.length>0?gX($,Q):fX($,Q);Z.push({path:W,content:Y})}return Z}function gQ(Q){let X=[Q];for(let Z of Q.children)X.push(...gQ(Z));return X}function i(Q){if(Q.path.length<=1)return`commands/${Q.name}.md`;return`commands/${Q.path.slice(1).join("/")}.md`}function UQ(Q){return Q.path.join(" ")}function VQ(Q,X){let Z=Q.split("/").slice(0,-1),H=X.split("/"),$=0;while($<Z.length&&$<H.length&&Z[$]===H[$])$++;let W=Z.length-$,Y=H.slice($);if(W===0)return Y.join("/");return[...Array.from({length:W},()=>".."),...Y].join("/")}function vX(Q,X,Z){let H=[];if(H.push("---"),H.push(`name: ${WQ(X.name)}`),H.push(`description: ${WQ(X.description)}`),X.license)H.push(`license: ${WQ(X.license)}`);if(X.compatibility)H.push(`compatibility: ${WQ(X.compatibility)}`);if(X.disableModelInvocation)H.push("disable-model-invocation: true");if(X.allowedTools)H.push(`allowed-tools: ${WQ(X.allowedTools)}`);if(H.push("metadata:"),H.push(`  version: "${X.version}"`),H.push("---"),H.push(""),H.push(`# ${X.name}`),H.push(""),Q.description)H.push(Q.description),H.push("");H.push(`You should use this skill when you need accurate help with \`${X.name}\` commands, including command selection, syntax, arguments, flags, defaults, and subcommands.`),H.push("");let $=sX(X.instructions);if(H.push("## How to Use This Skill"),H.push(""),H.push("1. You must find the command that best matches the user's task from the Command Reference below."),H.push("2. You must check the `Type` column before suggesting execution: `runnable` and `runnable, group` commands can be executed, while `group` commands are organizational only."),H.push("3. You should read only the linked file or files you need from `commands/`."),H.push("4. You must read a command's file before answering a command-specific question or suggesting that command."),H.push("5. You must treat the command file as the source of truth for usage, arguments, flags, aliases, and defaults."),H.push("6. If a flag, argument, alias, or default is not documented there, you must say it is not documented instead of guessing."),H.push(""),FQ($))H.push("## General Guidance"),H.push(""),H.push(...$),H.push("");if(H.push("## Command Reference"),H.push(""),H.push("You should use this table to locate the command file you need."),H.push(""),H.push(...hX(Z)),H.push(""),Q.runnable){H.push("## Usage"),H.push("");let W=i(Q);H.push(`The root command is directly executable. You should see [${Q.name}](${W}) for usage details.`),H.push("")}return H.join(`
-`)}function hX(Q){let X=[];X.push("| Command | Type | Documentation |"),X.push("| ------- | ---- | ------------- |");for(let Z of Q){let H=UQ(Z),$=i(Z),W=yX(Z);X.push(`| \`${H}\` | ${W} | [${$}](${$}) |`)}return X}function yX(Q){if(Q.runnable&&Q.children.length>0)return"runnable, group";if(Q.runnable)return"runnable";return"group"}function fX(Q,X){let Z=[];return Z.push(...pQ(Q)),Z.push(...uQ(Q)),Z.push(...mQ(Q)),Z.push(...dQ(Q,X)),Z.join(`
-`)}function gX(Q,X){let Z=[],H=i(Q);if(Z.push(...pQ(Q)),Z.push(...uQ(Q)),Q.runnable)Z.push(...mQ(Q));return Z.push(...uX(Q,H)),Z.push(...dQ(Q,X)),Z.join(`
-`)}function pX(Q){let X=[...Q.path];for(let Z of Q.args)if(Z.variadic)X.push(Z.required?`<${Z.name}...>`:`[${Z.name}...]`);else X.push(Z.required?`<${Z.name}>`:`[${Z.name}]`);if(Q.flags.length>0)X.push("[options]");return X.join(" ")}function pQ(Q){let X=[`# \`${UQ(Q)}\``,""];if(Q.description)X.push(Q.description,"");return X}function uQ(Q){let X=Q.instructions??[];if(!FQ(X))return[];return["## Command Instructions","",...cQ(X),""]}function mQ(Q){let X=["## Usage","","```",Q.usage??pX(Q),"```",""];if(Q.args.length>0)X.push("## Arguments","",...mX(Q.args),"");if(Q.flags.length>0)X.push("## Flags","",...dX(Q.flags),"");return X.push("## Command Documentation Authority","","You must treat only the arguments, flags, options, aliases, and defaults documented in this file as supported for this command.","You must not infer or invent additional command-line options.",""),X}function uX(Q,X){let Z=["## Subcommands",""];for(let H of Q.children){let $=i(H),W=VQ(X,$),Y=H.description?` - ${H.description}`:"";Z.push(`- [\`${H.name}\`](${W})${Y}`)}return Z.push(""),Z}function mX(Q){let X=[];X.push("| Argument | Type | Required | Description |"),X.push("| -------- | ---- | -------- | ----------- |");for(let Z of Q){let H=Z.variadic?`${Z.name}...`:Z.name,$=Z.required?"Yes":"No",W=yQ(cX(Z));X.push(`| \`${H}\` | ${Z.type} | ${$} | ${W} |`)}return X}function cX(Q){let X=[];if(Q.description)X.push(Q.description);if(Q.default!==void 0)X.push(`Default: \`${Q.default}\``);return X.join(". ")||"-"}function dX(Q){let X=[];X.push("| Flag | Type | Required | Description |"),X.push("| ---- | ---- | -------- | ----------- |");for(let Z of Q){let H=rX(Z),$=Z.required?"Yes":"No",W=yQ(lX(Z));X.push(`| ${H} | ${Z.type} | ${$} | ${W} |`)}return X}function rX(Q){let X=[`\`--${Q.name}\``];if(Q.short)X.push(`\`-${Q.short}\``);for(let Z of Q.aliases)X.push(`\`--${Z}\``);return X.join(", ")}function lX(Q){let X=[];if(Q.description)X.push(Q.description);if(Q.multiple)X.push("Can be specified multiple times");if(Q.default!==void 0)X.push(`Default: \`${Q.default}\``);return X.join(". ")||"-"}function cQ(Q){return Q.map((X)=>`- ${X}`)}function sX(Q){if(typeof Q==="string")return kQ(Q);return cQ(BQ(Q))}function dQ(Q,X){let Z=[],H=i(Q);if(Z.push("---"),Z.push(""),Q.path.length>1){let W=Q.path.slice(0,-1),Y=rQ(X,W);if(Y){let F=i(Y),x=VQ(H,F),q=UQ(Y);Z.push(`Parent: [\`${q}\`](${x})`),Z.push("")}}let $=VQ(H,"SKILL.md");return Z.push(`[Skill Overview](${$})`),Z.push(""),Z}function rQ(Q,X){if(iX(Q.path,X))return Q;for(let Z of Q.children){let H=rQ(Z,X);if(H)return H}return}function iX(Q,X){if(Q.length!==X.length)return!1;for(let Z=0;Z<Q.length;Z++)if(Q[Z]!==X[Z])return!1;return!0}import{readFile as oX}from"fs/promises";import{join as aX}from"path";var t="crust.json";async function zQ(Q){let X;try{X=await oX(aX(Q,t),"utf-8")}catch{return{status:"absent"}}let Z;try{Z=JSON.parse(X)}catch{return{status:"malformed",reason:"parse-error"}}if(typeof Z!=="object"||Z===null)return{status:"malformed",reason:"not-an-object"};let H=Z;if(typeof H.version!=="string")return{status:"malformed",reason:"missing-version"};let{version:$,kind:W}=H;if(W===void 0)return{status:"ok",manifest:{version:$,kind:"generated"}};if(W==="bundle"||W==="generated")return{status:"ok",manifest:{version:$,kind:W}};return{status:"malformed",reason:"unknown-kind",rawKind:typeof W==="string"?W:JSON.stringify(W)}}async function wQ(Q){let X=await zQ(Q);return X.status==="ok"?X.manifest:null}async function YQ(Q){return(await wQ(Q))?.version??null}var XZ="auto";async function ZZ(Q){if(Q!==void 0)return Q;return[...S(),...await n()]}function XX(Q){if(Q!==void 0)return Q;return[...a]}var ZX=/^[a-z0-9]+(-[a-z0-9]+)*$/;function e(Q){return Q.length>=1&&Q.length<=64&&ZX.test(Q)}function QQ(Q){return Q}function _Q(Q){return Q.startsWith("use-")?Q:`use-${Q}`}async function XQ(Q){let{command:X,meta:Z,scope:H="global",clean:$=!0,force:W=!1,installMode:Y=XZ}=Q,F=await ZZ(Q.agents),x=QQ(Z.name),q=_Q(Z.name);if(!e(x))throw Error(`Invalid skill name "${x}": must be 1\u201364 lowercase `+`alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens. Pattern: ${ZX.source}`);if(F.length===0)return{agents:[]};let G={...Z,name:x},K=AQ(X),V=fQ(K,G);return OQ({files:V,meta:G,agents:F,scope:H,clean:$,force:W,installMode:Y,kind:"generated",legacyResolvedName:q})}async function OQ(Q){let{files:X,meta:Z,agents:H,scope:$,clean:W,force:Y,installMode:F,kind:x,legacyResolvedName:q}=Q,G=H[0];if(!G)return{agents:[]};let K=JZ(Z,x),V=[...X,...K].sort((B,w)=>B.path<w.path?-1:B.path>w.path?1:0),U=V.map((B)=>B.path),M=new Map;for(let B of H){let w=N(B,$,Z.name),_=M.get(w);if(_)_.push(B);else M.set(w,[B])}let O=c($,Z.name),T=c($,q),b=new Map;for(let[B,w]of M){let _=w[0];if(!_)continue;b.set(B,await bQ({outputDir:B,legacyOutputDir:N(_,$,q),canonicalOutputDir:O,legacyCanonicalOutputDir:T}))}let v=await zQ(O),R=v.status==="ok"?v.manifest:null,P=R?.version??null;if((await jQ(O,O)).exists&&R===null&&!Y)throw new L({agent:G,outputDir:O,manifestMalformed:iQ(v)});if(R!==null&&R.kind!==x&&!Y)throw new L({agent:G,outputDir:O,kindMismatch:{existing:R.kind,attempted:x}});let D=R!==null&&R.kind!==x,g=Y||P!==Z.version||D;if(g){if(W)await RQ(O);await HX(O,V)}let p=[];for(let[B,w]of M){let _=w[0];if(!_)continue;let z=b.get(B);if(!z)continue;if(z.current.inspection.exists&&!z.current.isCrustManaged&&!Y){let $Q=await zQ(B);throw new L({agent:_,outputDir:B,manifestMalformed:iQ($Q)})}if(z.current.manifest!==null&&z.current.manifest.kind!==x&&!Y)throw new L({agent:_,outputDir:B,kindMismatch:{existing:z.current.manifest.kind,attempted:x}});let j=await $Z({outputDir:B,canonicalOutputDir:O,allFiles:V,clean:W,installMode:F,inspection:z.current.inspection,installedVersion:z.preferredVersion,currentVersion:Z.version,force:Y,installedKind:z.current.manifest?.kind??null,currentKind:x}),E=await YZ(z),C=HZ({installedVersion:z.preferredVersion,currentVersion:Z.version,canonicalChanged:g,pathChanged:j||E||z.preferredOutputDir!==B});for(let $Q of w)p.push({agent:$Q,outputDir:B,files:C==="up-to-date"?[]:U,status:C,previousVersion:C==="updated"?z.preferredVersion??void 0:void 0})}if(q!==Z.name){let B=await YQ(T);if(T!==O&&B!==null&&!await TQ(q,$))await qQ(T,{recursive:!0,force:!0})}return{agents:p}}async function KQ(Q){let{name:X,scope:Z="global"}=Q,H=XX(Q.agents),$=QQ(X),W=_Q(X),Y=c(Z,$),F=c(Z,W),x=[],q=new Map;for(let G of H){let K=N(G,Z,$),V=q.get(K);if(V)V.push(G);else q.set(K,[G])}for(let[G,K]of q){let V=K[0];if(!V)continue;let U=N(V,Z,W),M=await bQ({outputDir:G,legacyOutputDir:U,canonicalOutputDir:Y,legacyCanonicalOutputDir:F}),O=await MQ(M.current),T=M.legacy.outputDir!==M.current.outputDir?await MQ(M.legacy):!1,b=O||T,v=O?G:T?U:G;for(let R of K)x.push({agent:R,outputDir:v,status:b?"removed":"not-found"})}if(await YQ(Y)!==null&&!await TQ($,Z))await qQ(Y,{recursive:!0,force:!0});{let G=await YQ(F);if(F!==Y&&G!==null&&!await TQ(W,Z))await qQ(F,{recursive:!0,force:!0})}return{agents:x}}async function d(Q){let{name:X,scope:Z="global"}=Q,H=XX(Q.agents),$=QQ(X),W=_Q(X),Y=[],F=new Map;for(let x of H){let q=N(x,Z,$),G=F.get(q);if(G)G.push(x);else F.set(q,[x])}for(let[x,q]of F){let G=q[0];if(!G)continue;let K=N(G,Z,W),V=c(Z,$),U=c(Z,W),M=await bQ({outputDir:x,legacyOutputDir:K,canonicalOutputDir:V,legacyCanonicalOutputDir:U}),O=M.preferredOutputDir??x,T=M.preferredVersion;for(let b of q)Y.push({agent:b,outputDir:O,installed:T!==null,version:T??void 0})}return{agents:Y}}function iQ(Q){if(Q.status!=="malformed")return;return Q.rawKind!==void 0?{reason:Q.reason,rawKind:Q.rawKind}:{reason:Q.reason}}function HZ(Q){let{installedVersion:X,currentVersion:Z,canonicalChanged:H,pathChanged:$}=Q;if(X===null)return"installed";if(X===Z&&!H&&!$)return"up-to-date";return"updated"}async function $Z(Q){let{outputDir:X,canonicalOutputDir:Z,allFiles:H,clean:$,installMode:W,inspection:Y,installedVersion:F,currentVersion:x,force:q,installedKind:G,currentKind:K}=Q;if(W==="copy")return oQ({outputDir:X,allFiles:H,clean:$,inspection:Y,installedVersion:F,currentVersion:x,force:q,installedKind:G,currentKind:K});try{return await WZ({outputDir:X,canonicalOutputDir:Z,inspection:Y})}catch(V){if(W==="symlink")throw Error(`Failed to create symlink at "${X}" (installMode: symlink).`,{cause:V});let U=await jQ(X,Z);return oQ({outputDir:X,allFiles:H,clean:$,inspection:U,installedVersion:F,currentVersion:x,force:q,installedKind:G,currentKind:K})}}async function oQ(Q){let{outputDir:X,allFiles:Z,clean:H,inspection:$,installedVersion:W,currentVersion:Y,force:F,installedKind:x,currentKind:q}=Q,G=x!==null&&x!==q;if(!(F||!$.exists||$.isSymlink||W!==Y||G))return!1;if($.isSymlink||H)await RQ(X);return await HX(X,Z),!0}async function WZ(Q){let{outputDir:X,canonicalOutputDir:Z,inspection:H}=Q;if(H.exists&&H.isSymlink&&H.pointsToCanonical)return!1;if(H.exists)await RQ(X);return await qZ(Z,X),!0}async function jQ(Q,X){let Z;try{Z=await nX(Q)}catch{return{exists:!1,isSymlink:!1,pointsToCanonical:!1}}let H=process.platform==="win32"&&Z.isDirectory()&&await tQ(Q)!==null;if(!(Z.isSymbolicLink()||H))return{exists:!0,isSymlink:!1,pointsToCanonical:!1};let[W,Y,F]=await Promise.all([nQ(Q),nQ(X),tQ(Q)]);return{exists:!0,isSymlink:!0,pointsToCanonical:W!==null&&Y!==null&&W===Y||F===X}}async function aQ(Q,X){let[Z,H]=await Promise.all([wQ(Q),jQ(Q,X)]),$=Z?.version??null,W=$!==null||H.exists&&H.isSymlink&&H.pointsToCanonical;return{outputDir:Q,version:$,manifest:Z,inspection:H,isCrustManaged:W}}async function bQ(Q){let{outputDir:X,legacyOutputDir:Z,canonicalOutputDir:H,legacyCanonicalOutputDir:$}=Q,W=await aQ(X,H),Y=Z===X?W:await aQ(Z,$);if(W.isCrustManaged)return{current:W,legacy:Y,preferredVersion:W.version,preferredOutputDir:W.outputDir};if(Y.isCrustManaged)return{current:W,legacy:Y,preferredVersion:Y.version,preferredOutputDir:Y.outputDir};return{current:W,legacy:Y,preferredVersion:null,preferredOutputDir:null}}async function MQ(Q){if(!Q.isCrustManaged||!Q.inspection.exists)return!1;return await qQ(Q.outputDir,{recursive:!0,force:!0}),!0}async function YZ(Q){if(Q.legacy.outputDir===Q.current.outputDir)return!1;return MQ(Q.legacy)}async function nQ(Q){try{return await eX(Q)}catch{return null}}async function tQ(Q){try{return await tX(Q)}catch{return null}}async function qZ(Q,X){await eQ(QX(X),{recursive:!0});let Z=process.platform==="win32"?"junction":"dir";await QZ(Q,X,Z)}async function TQ(Q,X){let Z=new Set;for(let H of a)Z.add(N(H,X,Q));for(let H of Z)if(await YQ(H)!==null)return!0;return!1}function JZ(Q,X){let Z={name:Q.name,description:Q.description,version:Q.version,kind:X};return[{path:t,content:`${JSON.stringify(Z,null,"\t")}
-`}]}async function RQ(Q){await qQ(Q,{recursive:!0,force:!0})}async function HX(Q,X){let Z=new Set;for(let $ of X){let W=sQ(Q,$.path),Y=QX(W);Z.add(Y)}let H=[...Z].sort();for(let $ of H)await eQ($,{recursive:!0});for(let $ of X){let W=sQ(Q,$.path);if(typeof $.content==="string")await lQ(W,$.content,"utf-8");else await lQ(W,$.content)}}var EQ="SKILL.md";function KZ(Q){let X={name:null,description:null},H=(Q.startsWith("\uFEFF")?Q.slice(1):Q).split(/\r?\n/,51),$=0;while($<H.length&&H[$]?.trim()==="")$++;if($>=H.length||H[$]!=="---")return X;$++;let W=Math.min(50,H.length);for(let Y=$;Y<W;Y++){let F=H[Y];if(F===void 0)break;if(/^---\s*$/.test(F))break;let x=F.match(/^([A-Za-z0-9_-]+)\s*:\s*(.*?)\s*$/);if(!x)continue;let q=x[1];if(q!=="name"&&q!=="description")continue;if(X[q]!==null)continue;X[q]=GZ(x[2]??"")}return X}function GZ(Q){let X=Q[0];if(X==='"'||X==="'"){let H=Q.indexOf(X,1);if(H!==-1)return Q.slice(1,H)}let Z=Q.search(/(^|\s)#/);return Z===-1?Q:Q.slice(0,Z).trimEnd()}function FZ(Q,X,Z){let H=X.endsWith(WX)?X:X+WX;if(Q!==X&&!Q.startsWith(H))throw Error(`Bundle path traversal rejected: "${Z}" resolves to "${Q}", which is outside the bundle root "${X}".`)}async function JX(Q,X,Z,H){let $=await BZ(Q,{withFileTypes:!0}),W=[];for(let Y of $){let F=Y.name,x=IQ(Q,F),q=Z===""?F:`${Z}/${F}`,G=await YX(x);FZ(G,X,x);let K=await qX(G);if(K.isDirectory()){if(H.has(G))continue;H.add(G),W.push(...await JX(x,X,q,H))}else if(K.isFile())W.push({relPath:q,absPath:x})}return W}async function xZ(Q){let X=zZ(Q),Z;try{Z=await YX(X)}catch(G){throw Error(`Bundle source directory "${X}" does not exist or is not accessible.`,{cause:G})}if(!(await qX(Z)).isDirectory())throw Error(`Bundle source path "${Z}" is not a directory.`);let W=await JX(Z,Z,"",new Set([Z])),Y=W.find((G)=>G.relPath===EQ);if(!Y)throw Error(`Bundle is missing SKILL.md at the bundle root "${Z}". Every skill bundle must contain a top-level SKILL.md file.`);if(W.some((G)=>G.relPath===t))throw Error(`Bundle source at "${Z}" contains a reserved file "${t}" at the root. Crust regenerates this file during installation; remove it from your bundle source.`);let F=await Promise.all(W.map(async(G)=>({path:G.relPath,content:await $X(G.absPath)}))),x=await $X(Y.absPath,"utf-8"),q=KZ(x);if(q.name===null||q.name==="")throw Error(`Bundle SKILL.md is missing a top-level \`name:\` field in its YAML frontmatter (at "${IQ(Z,EQ)}"). Add \`name: <skill-name>\` to the frontmatter block.`);if(q.description===null||q.description==="")throw Error(`Bundle SKILL.md is missing a top-level \`description:\` field in its YAML frontmatter (at "${IQ(Z,EQ)}"). Add \`description: <one-line summary>\` to the frontmatter block.`);return{files:F,frontmatter:{name:q.name,description:q.description}}}async function ZQ(Q){let{sourceDir:X,agents:Z,version:H,scope:$="global",clean:W=!0,force:Y=!1,installMode:F="auto",expectedName:x}=Q,{files:q,frontmatter:G}=await xZ(X),K=QQ(G.name);if(!e(K))throw Error(`Invalid skill name "${K}" in SKILL.md frontmatter: must be 1\u201364 lowercase `+"alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens.");if(x!==void 0&&K!==x)throw Error(`Bundle SKILL.md frontmatter name "${K}" does not match the expected name "${x}". Update the bundle's SKILL.md frontmatter \`name:\` field, or change the configured \`name\` to match.`);if(Z.length===0)return{agents:[]};let V={name:K,description:G.description,version:H};return OQ({files:[...q],meta:V,agents:Z,scope:$,clean:W,force:Y,installMode:F,kind:"bundle",legacyResolvedName:K})}import{Crust as zX,VALIDATION_MODE_ENV as VZ}from"@crustjs/core";import{spinner as h}from"@crustjs/progress";import{confirm as KX,multiselect as GX,select as UZ}from"@crustjs/prompts";import{bold as l,dim as k,yellow as o}from"@crustjs/style";var wZ="skill",FX="global",r="__universal__";function xX(Q){return Q==="global"||Q==="project"}function MZ(Q){return Q==="auto"||Q==="symlink"||Q==="copy"}function VX(Q){if(Q===void 0)return;if(!xX(Q))throw Error(`Invalid --scope value: ${String(Q)}. Expected "project" or "global".`);return Q}async function UX(Q,X){let Z=VX(Q);if(Z!==void 0)return Z;if(X.defaultScope)return X.defaultScope;return UZ({message:"Select scope",choices:[{label:"Project",value:"project"},{label:"Global",value:"global"}],default:FX})}function HQ(Q){let X=new Set(S()),Z=[];if(Q.some((H)=>X.has(H)))Z.push("Universal");for(let H of Q){if(X.has(H))continue;Z.push(A[H])}return Z}function GQ(Q){let X=new Set(S()),Z=[],H=Q.find(($)=>X.has($.agent));if(H)Z.push({label:"Universal",outputDir:H.outputDir});for(let $ of Q){if(X.has($.agent))continue;Z.push({label:A[$.agent],outputDir:$.outputDir})}return Z}function CQ(Q,X){return{name:Q.meta.name,description:Q.meta.description??"",version:X.version,instructions:X.instructions,license:X.license,allowedTools:X.allowedTools,compatibility:X.compatibility,disableModelInvocation:X.disableModelInvocation}}function TZ(Q,X){if(X===void 0)return[];if(!Array.isArray(X))throw Error(`skillPlugin: customSkills must be an array, got ${X===null?"null":typeof X}.`);if(X.length===0)return[];let Z=new Set;for(let H=0;H<X.length;H++){let $=X[H];if(!$||typeof $!=="object")throw Error(`skillPlugin: customSkills[${H}] must be an object, got ${$===null?"null":typeof $}.`);if(typeof $.name!=="string"||$.name.length===0)throw Error(`skillPlugin: customSkills[${H}].name must be a non-empty string.`);if(!e($.name))throw Error(`skillPlugin: customSkills[${H}].name "${$.name}" is not a valid skill name. `+"Must be 1\u201364 lowercase alphanumeric characters and hyphens, "+"no leading/trailing/consecutive hyphens.");if($.name===Q)throw Error(`skillPlugin: customSkills[${H}].name "${$.name}" collides with the main skill name. Custom skill bundle names must differ from the root command name.`);if(Z.has($.name))throw Error(`skillPlugin: customSkills contains duplicate name "${$.name}". Each entry must declare a unique name.`);if(Z.add($.name),$.version!==void 0&&(typeof $.version!=="string"||$.version.length===0))throw Error(`skillPlugin: customSkills[${H}].version (for "${$.name}") must be a non-empty string when set, or omitted to inherit the plugin's \`version\`.`);if(typeof $.sourceDir!=="string"&&!($.sourceDir instanceof URL))throw Error(`skillPlugin: customSkills[${H}].sourceDir (for "${$.name}") must be a string or URL, got ${typeof $.sourceDir}.`);if($.scope!==void 0&&!xX($.scope))throw Error(`skillPlugin: customSkills[${H}].scope (for "${$.name}") must be "project" or "global", got ${JSON.stringify($.scope)}.`);if($.installMode!==void 0&&!MZ($.installMode))throw Error(`skillPlugin: customSkills[${H}].installMode (for "${$.name}") must be "auto", "symlink", or "copy", got ${JSON.stringify($.installMode)}.`)}return X}function _Z(Q,X){let Z=Q.scope??X.defaultScope;if(Z!==void 0)return[u(Z)];return[...new Set(["project","global"].map((H)=>u(H)))]}async function OZ(Q,X){let Z=[...S(),...m()];if(Z.length===0)return;let H=_Z(Q,X),$=Q.installMode??X.installMode,W=Q.version??X.version;for(let Y of H){let x=(await d({name:Q.name,agents:Z,scope:Y})).agents.filter((q)=>{if(!q.installed)return!1;let G=N(q.agent,Y,Q.name);return q.version!==W||q.outputDir!==G});if(x.length===0)continue;try{await h({message:`Updating ${Y} skills [${Q.name}]...`,task:async({updateMessage:q})=>{let G=await ZQ({sourceDir:Q.sourceDir,agents:x.map((U)=>U.agent),version:W,scope:Y,installMode:$,expectedName:Q.name}),K=G.agents.filter((U)=>U.status==="updated").map((U)=>U.agent),V=HQ(K);if(V.length>0)q(`Updated bundle "${Q.name}" to v${W} for ${V.join(", ")} (${Y})`);return G}})}catch(q){if(q instanceof L){let G=q.details.kindMismatch?` (existing skill is "${q.details.kindMismatch.existing}", attempted "${q.details.kindMismatch.attempted}")`:"";console.warn(o(`Skill conflict [${Q.name}]: "${q.details.outputDir}" already exists but conflicts with the requested install${G}. Skipping auto-update for ${Y}. Delete or rename the conflicting skill to resolve.`))}else throw q}}}function LQ(Q,X,Z,H){if(!H.installed)return!1;let $=N(Q,X,Z.name);return H.version!==Z.version||H.outputDir!==$}async function jZ(Q,X,Z){let H=[...S(),...m()];if(H.length===0){await BX(Z,X);return}let $=CQ(Q,X),W=[...new Set(["project","global"].map((Y)=>u(Y)))];for(let Y of W){let x=(await d({name:$.name,agents:H,scope:Y})).agents.filter((q)=>LQ(q.agent,Y,$,q));if(x.length===0)continue;try{await h({message:`Updating ${Y} skills...`,task:async({updateMessage:q})=>{let G=await XQ({command:Q,meta:$,agents:x.map((U)=>U.agent),scope:Y,installMode:X.installMode}),K=G.agents.filter((U)=>U.status==="updated").map((U)=>U.agent),V=HQ(K);if(V.length>0)q(`Updated skill "${$.name}" to v${$.version} for ${V.join(", ")} (${Y})`);return G}})}catch(q){if(q instanceof L)console.warn(o(`Skill conflict: "${q.details.outputDir}" already exists but was not created by ${$.name}. Skipping auto-update for ${Y}. Delete or rename the conflicting skill to resolve.`));else throw q}}await BX(Z,X)}async function BX(Q,X){for(let Z of Q)try{await OZ(Z,X)}catch(H){let $=H instanceof Error?H.message:String(H);console.warn(o(`Skill auto-update failed [${Z.name}]: ${$}. Continuing with remaining skills.`))}}function bZ(Q){let X;return{name:"skills",async setup(Z,H){X=Z.rootCommand;let $=Q.command??wZ,W=TZ(X.meta.name,Q.customSkills);if(H.addSubCommand(X,$,EZ(X,Q,W,$)),process.env[VZ]==="1")return;if(Z.argv[0]===$)return;if(Q.autoUpdate!==!1)await jZ(X,Q,W)}}}async function RZ(Q){let{entry:X,options:Z,scope:H,installAll:$,isInteractive:W}=Q,Y=X.installMode??Z.installMode,F=X.version??Z.version,x=await n(),q=S(),G=m(),K=await d({name:X.name,agents:[...q,...G],scope:H}),V=new Set(K.agents.filter((B)=>B.installed).map((B)=>B.agent)),U=new Set(x),M=new Map(K.agents.map((B)=>[B.agent,B])),O=G.filter((B)=>{if(U.has(B))return!0;return M.get(B)?.installed===!0}),T=O.filter((B)=>V.has(B)),b=[];if(q.length>0){let B=q[0];if(!B)throw Error("Expected at least one universal agent");let _=M.get(B)?.outputDir??"path unavailable";b.push({label:"Universal",value:r,hint:_});let z=q.map((j)=>A[j]).join(", ");if(W&&!$)console.log(k(`Agents supporting universal skills: ${z}`))}for(let B of O){let _=M.get(B)?.outputDir??"path unavailable";b.push({label:A[B],value:B,hint:_})}let v=q.length>0&&q.every((B)=>V.has(B)),R=[...T.filter((B)=>!q.includes(B))];if(v)R.unshift(r);let P;if($)P=[...q,...O];else{let B=b.length===0?[]:await GX({message:`Select agents to install skills for [${X.name}]`,choices:b,default:R,required:!1}),w=new Set(B.filter((_)=>_!==r));if(B.includes(r))for(let _ of q)w.add(_);P=[...w]}let I=P.filter((B)=>!V.has(B)),D=P.filter((B)=>{let w=M.get(B);if(!w?.installed)return!1;let _=N(B,H,X.name);return w.version!==F||w.outputDir!==_}),g=[...V].filter((B)=>!P.includes(B)),p=[...I,...D];if(p.length>0)try{let B=await h({message:`Installing skills [${X.name}]...`,task:async()=>ZQ({sourceDir:X.sourceDir,agents:p,version:F,scope:H,installMode:Y,expectedName:X.name})});console.log(`
-${l(`Installed bundle "${X.name}" v${F}`)}`);for(let w of GQ(B.agents))console.log(k(`  ${w.label} \u2192 ${w.outputDir}`))}catch(B){if(B instanceof L){let w=B.details.kindMismatch?` (existing is a "${B.details.kindMismatch.existing}" skill, attempted "${B.details.kindMismatch.attempted}")`:" but was not created by Crust";if($?!0:await KX({message:`"${B.details.outputDir}" already exists${w}. Overwrite?`,default:!1})){let z=await h({message:`Overwriting bundle [${X.name}]...`,task:async()=>ZQ({sourceDir:X.sourceDir,agents:[B.details.agent],version:F,scope:H,force:!0,installMode:Y,expectedName:X.name})});console.log(`
-${l(`Installed bundle "${X.name}" v${F}`)}`);for(let j of GQ(z.agents))console.log(k(`  ${j.label} \u2192 ${j.outputDir}`))}else console.log(k(`
-Skipped ${A[B.details.agent]} [${X.name}]`))}else throw B}if(g.length>0){let w=(await h({message:`Removing skills [${X.name}]...`,task:async()=>KQ({name:X.name,agents:g,scope:H})})).agents.filter((z)=>z.status==="removed").map((z)=>z.agent),_=HQ(w);if(_.length>0)console.log(`
-${l(`Removed bundle "${X.name}" from ${_.join(", ")}`)}`)}if(p.length===0&&g.length===0)console.log(k(`No changes [${X.name}].`))}function EZ(Q,X,Z,H){let $=IZ(Q,X,Z);return new zX(H).meta({description:"Manage agent skill installations"}).flags({scope:{type:"string",description:"Install scope (project or global)"},all:{type:"boolean",description:"Install for all detected agents non-interactively (universal + detected)"}}).run(async(W)=>{let Y=CQ(Q,X),F=W.flags.all===!0,x=!!process.stdin.isTTY,q=F?VX(W.flags.scope)??X.defaultScope??FX:await UX(W.flags.scope,X),G=await n(),K=S(),V=m(),U=await d({name:Y.name,agents:[...K,...V],scope:q}),M=new Set(U.agents.filter((z)=>z.installed).map((z)=>z.agent)),O=new Set(G),T=new Map(U.agents.map((z)=>[z.agent,z])),b=V.filter((z)=>{if(O.has(z))return!0;return T.get(z)?.installed===!0}),v=b.filter((z)=>M.has(z)),R=[];if(K.length>0){let z=K[0];if(!z)throw Error("Expected at least one universal agent");let E=T.get(z)?.outputDir??"path unavailable";R.push({label:"Universal",value:r,hint:E});let C=K.map(($Q)=>A[$Q]).join(", ");if(x&&!F)console.log(k(`Agents supporting universal skills: ${C}`))}for(let z of b){let E=T.get(z)?.outputDir??"path unavailable";R.push({label:A[z],value:z,hint:E})}let P=K.length>0&&K.every((z)=>M.has(z)),I=[...v.filter((z)=>!K.includes(z))];if(P)I.unshift(r);let D;if(F)D=[...K,...b];else{let z=R.length===0?[]:await GX({message:"Select agents to install skills for",choices:R,default:I,required:!1}),j=new Set(z.filter((E)=>E!==r));if(z.includes(r))for(let E of K)j.add(E);D=[...j]}let g=D.filter((z)=>!M.has(z)),p=D.filter((z)=>{let j=T.get(z);return j!==void 0&&LQ(z,q,Y,j)}),B=[...M].filter((z)=>!D.includes(z)),w=[...g,...p];if(w.length>0)try{let z=await h({message:"Installing skills...",task:async()=>XQ({command:Q,meta:Y,agents:w,scope:q,installMode:X.installMode})});console.log(`
-${l(`Installed "${Y.name}" v${Y.version}`)}`);for(let j of GQ(z.agents))console.log(k(`  ${j.label} \u2192 ${j.outputDir}`))}catch(z){if(z instanceof L)if(F?!0:await KX({message:`"${z.details.outputDir}" already exists but was not created by Crust. Overwrite?`,default:!1})){let E=await h({message:"Overwriting skill...",task:async()=>XQ({command:Q,meta:Y,agents:[z.details.agent],scope:q,force:!0,installMode:X.installMode})});console.log(`
-${l(`Installed "${Y.name}" v${Y.version}`)}`);for(let C of GQ(E.agents))console.log(k(`  ${C.label} \u2192 ${C.outputDir}`))}else console.log(k(`
-Skipped ${A[z.details.agent]}`));else throw z}if(B.length>0){let j=(await h({message:"Removing skills...",task:async()=>KQ({name:Y.name,agents:B,scope:q})})).agents.filter((C)=>C.status==="removed").map((C)=>C.agent),E=HQ(j);if(E.length>0)console.log(`
-${l(`Removed from ${E.join(", ")}`)}`)}if(w.length===0&&B.length===0)console.log(k("No changes."));let _=[];for(let z of Z){let j=z.scope??q;try{await RZ({entry:z,options:X,scope:j,installAll:F,isInteractive:x})}catch(E){let C=E instanceof Error?E.message:String(E);console.warn(o(`Skill reconciliation failed [${z.name}]: ${C}. Continuing with remaining skills.`)),_.push(z.name)}}if(_.length>0)process.exitCode=1}).command($)._node}function IZ(Q,X,Z){return new zX("update").meta({description:"Update installed skills to latest version"}).flags({scope:{type:"string",description:"Update scope (project or global)"}}).run(async(H)=>{let $=await UX(H.flags.scope,X),W=u($),Y=[...S(),...m()],F=CQ(Q,X),q=(await d({name:F.name,agents:Y,scope:$})).agents.filter((K)=>LQ(K.agent,$,F,K));if(q.length===0)console.log(k(`No updates needed (${W}).`));else try{let V=(await h({message:`Updating ${W} skills...`,task:async()=>XQ({command:Q,meta:F,agents:q.map((M)=>M.agent),scope:$,installMode:X.installMode})})).agents.filter((M)=>M.status==="updated").map((M)=>M.agent),U=HQ(V);if(U.length>0)console.log(`
-${l(`Updated "${F.name}" to v${F.version} for ${U.join(", ")} (${W})`)}`)}catch(K){if(K instanceof L)console.warn(o(`Skipped ${A[K.details.agent]}: "${K.details.outputDir}" already exists but was not created by ${F.name}. Delete or rename the conflicting directory to resolve.`));else throw K}let G=[];for(let K of Z){let V=K.scope??$,U=u(V),M=K.installMode??X.installMode,O=K.version??X.version;try{let b=(await d({name:K.name,agents:Y,scope:V})).agents.filter((I)=>{if(!I.installed)return!1;let D=N(I.agent,V,K.name);return I.version!==O||I.outputDir!==D});if(b.length===0){console.log(k(`No updates needed [${K.name}] (${U}).`));continue}let R=(await h({message:`Updating ${U} skills [${K.name}]...`,task:async()=>ZQ({sourceDir:K.sourceDir,agents:b.map((I)=>I.agent),version:O,scope:V,installMode:M,expectedName:K.name})})).agents.filter((I)=>I.status==="updated").map((I)=>I.agent),P=HQ(R);if(P.length>0)console.log(`
-${l(`Updated bundle "${K.name}" to v${O} for ${P.join(", ")} (${U})`)}`)}catch(T){if(T instanceof L){let b=T.details.kindMismatch?` (existing is a "${T.details.kindMismatch.existing}" skill, attempted "${T.details.kindMismatch.attempted}")`:"";console.warn(o(`Skipped ${A[T.details.agent]} [${K.name}]: "${T.details.outputDir}" already exists${b}. Delete or rename the conflicting directory to resolve.`))}else{let b=T instanceof Error?T.message:String(T);console.warn(o(`Skill update failed [${K.name}]: ${b}. Continuing with remaining skills.`)),G.push(K.name)}}}if(G.length>0)process.exitCode=1})}export{KQ as uninstallSkill,d as skillStatus,bZ as skillPlugin,QQ as resolveSkillName,c as resolveCanonicalSkillPath,e as isValidSkillName,bX as isUniversalAgent,ZQ as installSkillBundle,S as getUniversalAgents,m as getAdditionalAgents,XQ as generateSkill,n as detectInstalledAgents,CX as annotate,L as SkillConflictError};
+import { lstat, mkdir, readFile, readdir, readlink, realpath, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
+import { basename, delimiter, dirname, extname, isAbsolute, join, posix, relative, resolve, sep } from "node:path";
+import { accessSync, constants, existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { buildCommandDocumentation, formatDefault, sectionsFor } from "@crustjs/core/tooling";
+import { defineCommand, defineExtension, defineExtensionId } from "@crustjs/core";
+import { spinner } from "@crustjs/progress";
+import { confirm, multiselect, select } from "@crustjs/prompts";
+import { bold, dim, yellow } from "@crustjs/style";
+import { homedir } from "node:os";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region ../utils/src/path.ts
+/** Returns whether child is parent itself or lies below it. */
+function isWithin(parent, child) {
+	const path = relative(parent, child);
+	return path === "" || !isAbsolute(path) && path !== ".." && !path.startsWith(`..${sep}`);
+}
+//#endregion
+//#region ../utils/src/source.ts
+/**
+* Find the nearest directory containing `package.json` by walking up the
+* filesystem from `startPath`.
+*
+* If `startPath` points at an existing file, its parent directory is used as
+* the starting point. The directory walk uses `path.resolve()` (lexical), not
+* `fs.realpath()`, so a symlink's parent chain is walked rather than the
+* symlink target's parent chain.
+*
+* @param startPath - Directory or file path to start walking from.
+* @returns The absolute path of the nearest enclosing directory containing
+*   `package.json`, or `null` if the filesystem root is reached first.
+*
+* @internal Used only by {@link resolveSourceDir}.
+*/
+function findNearestPackageRoot(startPath) {
+	let current = resolve(startPath);
+	if (existsSync(current) && !statSync(current).isDirectory()) current = dirname(current);
+	while (true) {
+		if (existsSync(join(current, "package.json"))) return current;
+		const parent = dirname(current);
+		if (parent === current) return null;
+		current = parent;
+	}
+}
+/**
+* Resolves an absolute filesystem path from a caller-supplied source
+* directory descriptor. Designed for tools that ship reference assets
+* (templates, skill bundles, etc.) alongside their published package and
+* need a uniform way to locate them at runtime regardless of how the
+* consumer expressed the path.
+*
+* Three input modes are supported:
+* - **`URL`** — must use the `file:` protocol. Resolved via
+*   `url.fileURLToPath()`. The intended idiom is
+*   `new URL("./relative/path", import.meta.url)`.
+* - **Absolute string path** — returned as `path.resolve(input)`.
+* - **Relative string path** — resolved against the nearest `package.json`
+*   directory walking up from `process.argv[1]`. This makes
+*   `"templates/base"` resolve to `<consumer-package-root>/templates/base`
+*   regardless of cwd.
+*
+* Three failure modes throw descriptive `Error`s:
+* - URL with non-`file:` protocol — message names the offending protocol.
+* - Relative string path with `process.argv[1]` unset — message suggests
+*   switching to an absolute path or a `file:` URL.
+* - Relative string path but no `package.json` found walking up — message
+*   names the entrypoint and the relative input, and suggests switching to
+*   an absolute path or a `file:` URL.
+*
+* @param input - File URL, absolute path, or package-relative path.
+* @returns Absolute filesystem path.
+* @throws {Error} For any of the three failure modes above.
+*
+* @example
+* ```ts
+* import { resolveSourceDir } from "@crustjs/utils/source";
+*
+* // 1. file: URL — relative to the calling module
+* const a = resolveSourceDir(new URL("../templates/base", import.meta.url));
+*
+* // 2. Absolute path
+* const b = resolveSourceDir("/abs/path/to/templates/base");
+*
+* // 3. Relative path — resolved from the consuming package's root
+* const c = resolveSourceDir("templates/base");
+* ```
+*/
+function resolveSourceDir(input) {
+	if (input instanceof URL) {
+		if (input.protocol !== "file:") throw new Error(`sourceDir URL must use file: protocol, got "${input.protocol}".`);
+		return fileURLToPath(input);
+	}
+	if (isAbsolute(input)) return resolve(input);
+	const entrypoint = process.argv[1];
+	if (!entrypoint) throw new Error(`Could not resolve relative sourceDir "${input}" because process.argv[1] is not set. Pass an absolute path or a file: URL.`);
+	const packageRoot = findNearestPackageRoot(resolve(entrypoint));
+	if (!packageRoot) throw new Error(`Could not resolve relative sourceDir "${input}" from entrypoint "${entrypoint}" because no package.json was found in its parent directories. Pass an absolute path or a file: URL.`);
+	return resolve(packageRoot, input);
+}
+//#endregion
+//#region src/bundle.ts
+/** Filename of the entrypoint markdown file required at the bundle root. */
+const SKILL_MD = "SKILL.md";
+/**
+* Parses one single-line YAML scalar: double-quoted, single-quoted, or plain
+* (trailing ` # comment` stripped per YAML's whitespace-then-hash rule).
+*
+* Known ceiling: double-quote escapes are unwrapped literally (`\\n` becomes
+* `n`, not a newline) and multi-line scalars are not supported — name and
+* description are one-line fields in practice. Grow a real YAML dep if that
+* ever stops holding.
+*/
+function parseScalar(raw) {
+	const doubleQuoted = /^"((?:[^"\\]|\\.)*)"/.exec(raw)?.[1];
+	if (doubleQuoted !== void 0) return doubleQuoted.replace(/\\(.)/g, "$1");
+	const singleQuoted = /^'((?:[^']|'')*)'/.exec(raw)?.[1];
+	if (singleQuoted !== void 0) return singleQuoted.replaceAll("''", "'");
+	return raw.replace(/(^|\s)#.*$/, "").trim();
+}
+/** Reads top-level `name` and `description` from leading YAML frontmatter. */
+function probeFrontmatter(content) {
+	const result = {
+		name: null,
+		description: null
+	};
+	const lines = (content.startsWith("") ? content.slice(1) : content).split(/\r?\n/);
+	let opening = 0;
+	while (lines[opening]?.trim() === "") opening++;
+	if (lines[opening] !== "---") return result;
+	const closing = lines.findIndex((line, index) => index > opening && /^---\s*$/.test(line));
+	if (closing === -1) return result;
+	for (const line of lines.slice(opening + 1, closing)) {
+		const match = /^(name|description):\s*(.*)$/.exec(line);
+		const key = match?.[1];
+		const value = match?.[2];
+		if ((key === "name" || key === "description") && value !== void 0) result[key] = parseScalar(value);
+	}
+	return result;
+}
+/** Requires non-empty Agent Skills frontmatter fields. */
+function requireSkillFrontmatter(frontmatter, subject) {
+	if (frontmatter.name === null || frontmatter.name.trim() === "") throw new Error(`${subject} requires a name (\`name:\`) field in SKILL.md frontmatter.`);
+	if (frontmatter.description === null || frontmatter.description.trim() === "") throw new Error(`${subject} requires a description (\`description:\`) field in SKILL.md frontmatter.`);
+	return {
+		name: frontmatter.name,
+		description: frontmatter.description
+	};
+}
+/**
+* Asserts that `realPath` lies inside (or equals) `canonicalRoot`.
+*
+* The check is performed on canonicalized paths (after `realpath`) so
+* symlinks pointing outside the skill directory root are reliably rejected.
+*/
+function assertInsideRoot(realPath, canonicalRoot, originalPath) {
+	if (!isWithin(canonicalRoot, realPath)) throw new Error(`Extra skill path traversal rejected: "${originalPath}" resolves to "${realPath}", which is outside the skill directory root "${canonicalRoot}".`);
+}
+/**
+* Recursively collects file paths under `dir`, rejecting any entry that
+* escapes `canonicalRoot` via symlink.
+*
+* Bundle contents are copied as authored — no implicit name-based filtering.
+* Bundle authors are responsible for keeping `sourceDir` clean (no
+* `node_modules/`, `.git/`, editor cruft, etc.).
+*
+* Cycle protection: directories are tracked by their canonical realpath in
+* `visitedDirs` so symlinks like `loop -> .` or `a/back -> ..` (which all
+* pass the inside-root guard) cannot drive unbounded recursion. The first
+* occurrence is walked; further occurrences are silently skipped.
+*/
+async function collectBundleEntries(dir, canonicalRoot, relPrefix, visitedDirs) {
+	const entries = (await readdir(dir, { withFileTypes: true })).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+	const collected = [];
+	for (const entry of entries) {
+		const name = entry.name;
+		const absPath = join(dir, name);
+		const relPath = relPrefix === "" ? name : `${relPrefix}/${name}`;
+		const realPath = await realpath(absPath);
+		assertInsideRoot(realPath, canonicalRoot, absPath);
+		const realStat = await stat(realPath);
+		if (realStat.isDirectory()) {
+			if (visitedDirs.has(realPath)) continue;
+			visitedDirs.add(realPath);
+			collected.push(...await collectBundleEntries(absPath, canonicalRoot, relPath, visitedDirs));
+		} else if (realStat.isFile()) collected.push({
+			relPath,
+			absPath
+		});
+	}
+	return collected;
+}
+/**
+* Loads the contents of a hand-authored skill bundle and extracts the
+* `name`/`description` it declares in its `SKILL.md` frontmatter.
+*
+* Steps:
+* 1. Resolve `sourceDir` (URL / absolute / relative-from-package-root).
+* 2. `realpath` the resolved path; reject if not a directory.
+* 3. Recursively walk, applying a per-entry path-traversal guard against the
+*    canonical root and a directory-cycle guard.
+* 4. Verify `SKILL.md` exists at the bundle root.
+* 5. Probe the frontmatter for `name:` and `description:` — both are required.
+*
+* The returned `frontmatter` becomes the source of truth for the build
+* pipeline and output paths. Crust does not rewrite `SKILL.md`; the bundle
+* author owns it.
+*
+* @internal Exported for unit testing.
+*/
+async function loadBundleFiles(sourceDir) {
+	const resolved = resolveSourceDir(sourceDir);
+	let canonicalRoot;
+	try {
+		canonicalRoot = await realpath(resolved);
+	} catch (err) {
+		throw new Error(`Extra skill directory "${resolved}" does not exist or is not accessible.`, { cause: err });
+	}
+	if (!(await stat(canonicalRoot)).isDirectory()) throw new Error(`Extra skill path "${canonicalRoot}" is not a directory.`);
+	const collected = await collectBundleEntries(canonicalRoot, canonicalRoot, "", /* @__PURE__ */ new Set([canonicalRoot]));
+	const skillMd = collected.find((f) => f.relPath === SKILL_MD);
+	if (!skillMd) throw new Error(`Extra skill directory is missing SKILL.md at its root "${canonicalRoot}". Every extra skill directory must contain a top-level SKILL.md file.`);
+	return {
+		files: await Promise.all(collected.map(async (entry) => ({
+			path: entry.relPath,
+			content: await readFile(entry.absPath)
+		}))),
+		frontmatter: requireSkillFrontmatter(probeFrontmatter(await readFile(skillMd.absPath, "utf-8")), `Extra skill SKILL.md at "${join(canonicalRoot, SKILL_MD)}"`)
+	};
+}
+//#endregion
+//#region src/errors.ts
+var SkillSourceConflictError = class extends Error {
+	name = "SkillSourceConflictError";
+	skillName;
+	constructor(skillName) {
+		super(`Skill source name conflict: "${skillName}" is declared more than once.`);
+		this.skillName = skillName;
+	}
+};
+/** Refuses to overwrite an agent entry that is not owned by the requested skill. */
+var SkillConflictError = class extends Error {
+	name = "SkillConflictError";
+	details;
+	constructor(details) {
+		super(`Skill conflict for agent "${details.agent}": entry "${details.outputDir}" is not owned by the requested skill.`);
+		this.details = details;
+	}
+};
+//#endregion
+//#region ../utils/src/process.ts
+/** Resolve a bare executable name from PATH (and PATHEXT on Windows). */
+function which(command) {
+	if (command.includes(sep) || command.includes("/")) {
+		try {
+			accessSync(command, constants.X_OK);
+			if (statSync(command).isFile()) return command;
+		} catch {}
+		return null;
+	}
+	const extensions = process.platform === "win32" && !extname(command) ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM").split(";") : [""];
+	for (const directory of process.env.PATH?.split(delimiter) ?? []) for (const extension of extensions) {
+		const candidate = resolve(join(directory, command + extension));
+		try {
+			accessSync(candidate, constants.X_OK);
+			if (statSync(candidate).isFile()) return candidate;
+		} catch {}
+	}
+	return null;
+}
+//#endregion
+//#region src/agents.ts
+const PROJECT_UNIVERSAL_SKILLS_DIR = join(".agents", "skills");
+function configHome(home) {
+	if (home !== homedir()) return join(home, ".config");
+	const xdg = process.env.XDG_CONFIG_HOME?.trim();
+	return xdg && xdg.length > 0 ? xdg : join(home, ".config");
+}
+function universalGlobalSkillsDir(home) {
+	return join(home, ".agents", "skills");
+}
+const universal = (label) => ({
+	label,
+	class: "universal",
+	projectSkillsDir: PROJECT_UNIVERSAL_SKILLS_DIR,
+	globalSkillsDir: universalGlobalSkillsDir
+});
+/** @internal */
+function resolveEffectiveScope(scope) {
+	return scope === "project" && process.cwd() === homedir() ? "global" : scope;
+}
+const AGENTS = {
+	amp: universal("Amp"),
+	adal: {
+		label: "AdaL",
+		class: "additional",
+		projectSkillsDir: join(".adal", "skills"),
+		globalSkillsDir: (home) => join(home, ".adal", "skills"),
+		detectCommands: ["adal"]
+	},
+	antigravity: {
+		label: "Antigravity",
+		class: "additional",
+		projectSkillsDir: PROJECT_UNIVERSAL_SKILLS_DIR,
+		globalSkillsDir: (home) => join(home, ".gemini", "config", "skills"),
+		detectCommands: ["antigravity"]
+	},
+	augment: {
+		label: "Augment",
+		class: "additional",
+		projectSkillsDir: join(".augment", "skills"),
+		globalSkillsDir: (home) => join(home, ".augment", "skills"),
+		detectCommands: ["augment"]
+	},
+	"claude-code": {
+		label: "Claude Code",
+		class: "additional",
+		projectSkillsDir: join(".claude", "skills"),
+		globalSkillsDir: (home) => join(process.env.CLAUDE_CONFIG_DIR?.trim() || join(home, ".claude"), "skills"),
+		detectCommands: ["claude", "claude-code"]
+	},
+	cline: universal("Cline"),
+	codebuddy: {
+		label: "CodeBuddy",
+		class: "additional",
+		projectSkillsDir: join(".codebuddy", "skills"),
+		globalSkillsDir: (home) => join(home, ".codebuddy", "skills"),
+		detectCommands: ["codebuddy"]
+	},
+	codex: universal("Codex"),
+	"command-code": {
+		label: "Command Code",
+		class: "additional",
+		projectSkillsDir: join(".commandcode", "skills"),
+		globalSkillsDir: (home) => join(home, ".commandcode", "skills"),
+		detectCommands: ["command-code", "commandcode"]
+	},
+	continue: {
+		label: "Continue",
+		class: "additional",
+		projectSkillsDir: join(".continue", "skills"),
+		globalSkillsDir: (home) => join(home, ".continue", "skills"),
+		detectCommands: ["continue"]
+	},
+	cortex: {
+		label: "Cortex Code",
+		class: "additional",
+		projectSkillsDir: join(".cortex", "skills"),
+		globalSkillsDir: (home) => join(home, ".snowflake", "cortex", "skills"),
+		detectCommands: ["cortex"]
+	},
+	crush: {
+		label: "Crush",
+		class: "additional",
+		projectSkillsDir: join(".crush", "skills"),
+		globalSkillsDir: (home) => join(configHome(home), "crush", "skills"),
+		detectCommands: ["crush"]
+	},
+	cursor: universal("Cursor"),
+	droid: {
+		label: "Droid",
+		class: "additional",
+		projectSkillsDir: join(".factory", "skills"),
+		globalSkillsDir: (home) => join(home, ".factory", "skills"),
+		detectCommands: ["droid"]
+	},
+	"gemini-cli": universal("Gemini CLI"),
+	"github-copilot": universal("GitHub Copilot"),
+	goose: {
+		label: "Goose",
+		class: "additional",
+		projectSkillsDir: join(".goose", "skills"),
+		globalSkillsDir: (home) => join(configHome(home), "goose", "skills"),
+		detectCommands: ["goose"]
+	},
+	"iflow-cli": {
+		label: "iFlow CLI",
+		class: "additional",
+		projectSkillsDir: join(".iflow", "skills"),
+		globalSkillsDir: (home) => join(home, ".iflow", "skills"),
+		detectCommands: ["iflow", "iflow-cli"]
+	},
+	junie: {
+		label: "Junie",
+		class: "additional",
+		projectSkillsDir: join(".junie", "skills"),
+		globalSkillsDir: (home) => join(home, ".junie", "skills"),
+		detectCommands: ["junie"]
+	},
+	kilo: {
+		label: "Kilo Code",
+		class: "additional",
+		projectSkillsDir: join(".kilocode", "skills"),
+		globalSkillsDir: (home) => join(home, ".kilocode", "skills"),
+		detectCommands: ["kilo", "kilocode"]
+	},
+	"kimi-cli": universal("Kimi Code CLI"),
+	"kiro-cli": {
+		label: "Kiro CLI",
+		class: "additional",
+		projectSkillsDir: join(".kiro", "skills"),
+		globalSkillsDir: (home) => join(home, ".kiro", "skills"),
+		detectCommands: ["kiro", "kiro-cli"]
+	},
+	kode: {
+		label: "Kode",
+		class: "additional",
+		projectSkillsDir: join(".kode", "skills"),
+		globalSkillsDir: (home) => join(home, ".kode", "skills"),
+		detectCommands: ["kode"]
+	},
+	mcpjam: {
+		label: "MCPJam",
+		class: "additional",
+		projectSkillsDir: join(".mcpjam", "skills"),
+		globalSkillsDir: (home) => join(home, ".mcpjam", "skills"),
+		detectCommands: ["mcpjam"]
+	},
+	"mistral-vibe": {
+		label: "Mistral Vibe",
+		class: "additional",
+		projectSkillsDir: join(".vibe", "skills"),
+		globalSkillsDir: (home) => join(process.env.VIBE_HOME || join(home, ".vibe"), "skills"),
+		detectCommands: ["mistral-vibe", "vibe"]
+	},
+	mux: {
+		label: "Mux",
+		class: "additional",
+		projectSkillsDir: join(".mux", "skills"),
+		globalSkillsDir: (home) => join(home, ".mux", "skills"),
+		detectCommands: ["mux"]
+	},
+	neovate: {
+		label: "Neovate",
+		class: "additional",
+		projectSkillsDir: join(".neovate", "skills"),
+		globalSkillsDir: (home) => join(home, ".neovate", "skills"),
+		detectCommands: ["neovate"]
+	},
+	opencode: universal("OpenCode"),
+	openclaw: {
+		label: "OpenClaw",
+		class: "additional",
+		projectSkillsDir: "skills",
+		globalSkillsDir: (home) => join(home, ".openclaw", "skills"),
+		detectCommands: ["openclaw"]
+	},
+	openhands: {
+		label: "OpenHands",
+		class: "additional",
+		projectSkillsDir: join(".openhands", "skills"),
+		globalSkillsDir: (home) => join(home, ".openhands", "skills"),
+		detectCommands: ["openhands"]
+	},
+	pi: universal("Pi"),
+	pochi: {
+		label: "Pochi",
+		class: "additional",
+		projectSkillsDir: join(".pochi", "skills"),
+		globalSkillsDir: (home) => join(home, ".pochi", "skills"),
+		detectCommands: ["pochi"]
+	},
+	qoder: {
+		label: "Qoder",
+		class: "additional",
+		projectSkillsDir: join(".qoder", "skills"),
+		globalSkillsDir: (home) => join(home, ".qoder", "skills"),
+		detectCommands: ["qoder"]
+	},
+	"qwen-code": {
+		label: "Qwen Code",
+		class: "additional",
+		projectSkillsDir: join(".qwen", "skills"),
+		globalSkillsDir: (home) => join(home, ".qwen", "skills"),
+		detectCommands: ["qwen", "qwen-code"]
+	},
+	replit: universal("Replit"),
+	roo: {
+		label: "Roo Code",
+		class: "additional",
+		projectSkillsDir: join(".roo", "skills"),
+		globalSkillsDir: (home) => join(home, ".roo", "skills"),
+		detectCommands: ["roo", "roo-code"]
+	},
+	trae: {
+		label: "Trae",
+		class: "additional",
+		projectSkillsDir: join(".trae", "skills"),
+		globalSkillsDir: (home) => join(home, ".trae", "skills"),
+		detectCommands: ["trae"]
+	},
+	"trae-cn": {
+		label: "Trae CN",
+		class: "additional",
+		projectSkillsDir: join(".trae", "skills"),
+		globalSkillsDir: (home) => join(home, ".trae-cn", "skills"),
+		detectCommands: ["trae-cn", "trae"]
+	},
+	warp: universal("Warp"),
+	windsurf: {
+		label: "Windsurf",
+		class: "additional",
+		projectSkillsDir: join(".windsurf", "skills"),
+		globalSkillsDir: (home) => join(home, ".codeium", "windsurf", "skills"),
+		detectCommands: ["windsurf"]
+	},
+	zed: universal("Zed"),
+	zencoder: {
+		label: "Zencoder",
+		class: "additional",
+		projectSkillsDir: join(".zencoder", "skills"),
+		globalSkillsDir: (home) => join(home, ".zencoder", "skills"),
+		detectCommands: ["zencoder"]
+	}
+};
+/**
+* All agent targets supported by `@crustjs/skills`.
+*
+* @internal
+*/
+const ALL_AGENTS = Object.keys(AGENTS);
+/**
+* Human-readable labels for each agent target.
+*
+* @internal
+*/
+const AGENT_LABELS = Object.fromEntries(ALL_AGENTS.map((agent) => [agent, AGENTS[agent].label]));
+/** Returns agents that use the canonical `.agents/skills` layout. */
+function getUniversalAgents() {
+	return ALL_AGENTS.filter((agent) => AGENTS[agent].class === "universal");
+}
+/** Returns agents that do not use the canonical layout at both scopes. */
+function getAdditionalAgents() {
+	return ALL_AGENTS.filter((agent) => AGENTS[agent].class === "additional");
+}
+/** Returns true if the agent uses the canonical layout at both scopes. */
+function isUniversalAgent(agent) {
+	return AGENTS[agent].class === "universal";
+}
+/**
+* Detects installed non-universal agents by checking PATH for their CLI binaries.
+*
+* Universal agents are intentionally not detected here so callers can always
+* present them as a single optional "Universal" install target.
+*/
+async function detectInstalledAgents() {
+	return getAdditionalAgents().filter((agent) => (AGENTS[agent].detectCommands ?? []).some((command) => which(command) !== null));
+}
+/**
+* Resolves the filesystem path for a skill installation.
+*
+* @internal
+*/
+function resolveAgentPath(agent, scope, name) {
+	const cfg = AGENTS[agent];
+	if (scope === "project") return join(process.cwd(), cfg.projectSkillsDir, name);
+	return join(cfg.globalSkillsDir(homedir()), name);
+}
+//#endregion
+//#region src/link.ts
+/** Returns whether a symlink target carries Crust's skill ownership signature. */
+function isOwnedSkillLink(target, name) {
+	const segments = target.replaceAll("\\", "/").split("/").filter(Boolean);
+	return segments.at(-2) === "skills" && segments.at(-1) === name;
+}
+function skillLinkTarget(sourceDir, outputDir, scope) {
+	return scope === "project" ? relative(dirname(outputDir), sourceDir) : sourceDir;
+}
+//#endregion
+//#region src/skill-name.ts
+/**
+* Agent Skills spec name pattern: 1–64 lowercase alphanumeric characters and
+* hyphens. Must not start or end with `-`, and must not contain consecutive `--`.
+*/
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/**
+* Validates a resolved skill name against the Agent Skills specification.
+*
+* @param name - The resolved skill name to validate
+* @returns `true` if valid, `false` otherwise
+*/
+function isValidSkillName(name) {
+	return name.length >= 1 && name.length <= 64 && SKILL_NAME_PATTERN.test(name);
+}
+//#endregion
+//#region ../utils/src/error.ts
+/** Narrows a caught Node.js system error to its stable errno contract. */
+function isErrnoException(error) {
+	return error instanceof Error && "code" in error && typeof error.code === "string";
+}
+//#endregion
+//#region src/source.ts
+var SkillSourceUnavailableError = class extends Error {
+	name = "SkillSourceUnavailableError";
+};
+function directoryPath(path) {
+	try {
+		return statSync(path).isDirectory() ? path : null;
+	} catch {
+		return null;
+	}
+}
+function fallbackName(source) {
+	if (source instanceof URL) return basename(fileURLToPath(source));
+	return isAbsolute(source) ? basename(source) : source;
+}
+/**
+* Resolves a logical packaged skill-source root. When the package path is
+* unavailable, falls back to the executable directory: absolute and URL
+* sources by their basename, relative sources by the same relative path.
+*/
+function resolveSkillSource(source) {
+	if (source instanceof URL && source.protocol !== "file:") throw new Error(`Skill source URL must use file: protocol, got "${source.protocol}".`);
+	let primary;
+	try {
+		primary = resolveSourceDir(source);
+	} catch {}
+	if (primary) {
+		const resolved = directoryPath(primary);
+		if (resolved) return resolved;
+	}
+	const fallback = join(dirname(process.execPath), fallbackName(source));
+	const resolvedFallback = directoryPath(fallback);
+	if (resolvedFallback) return resolvedFallback;
+	throw new SkillSourceUnavailableError(`Could not resolve skill source${primary ? ` at "${primary}"` : ""} or executable-relative fallback "${fallback}".`);
+}
+function readSkillFrontmatter(sourceDir) {
+	let content;
+	try {
+		content = readFileSync(join(sourceDir, "SKILL.md"), "utf8");
+	} catch (error) {
+		if (!isErrnoException(error) || error.code !== "ENOENT") throw error;
+		throw new Error(`Skill source directory "${sourceDir}" is missing SKILL.md.`, { cause: error });
+	}
+	return requireSkillFrontmatter(probeFrontmatter(content), `Skill source directory "${sourceDir}"`);
+}
+/** Reads every self-describing skill directory in a packaged skill source. */
+function loadPackagedSkills(source) {
+	const root = resolveSkillSource(source);
+	const skills = [];
+	for (const entry of readdirSync(root, { withFileTypes: true })) {
+		if (!entry.isDirectory()) continue;
+		const sourceDir = join(root, entry.name);
+		if (!existsSync(join(sourceDir, "SKILL.md"))) continue;
+		const frontmatter = readSkillFrontmatter(sourceDir);
+		if (frontmatter.name !== entry.name) throw new Error(`Skill source directory "${sourceDir}" declares name "${frontmatter.name}" in SKILL.md.`);
+		skills.push({
+			sourceDir,
+			name: frontmatter.name,
+			description: frontmatter.description
+		});
+	}
+	if (skills.length === 0) throw new SkillSourceUnavailableError(`Skill source "${root}" does not contain any skill directories.`);
+	return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
+//#endregion
+//#region src/generate.ts
+/** @internal */
+function groupAgentsByOutputDir(agents, scope, name) {
+	const groups = /* @__PURE__ */ new Map();
+	for (const agent of agents) {
+		const outputDir = resolveAgentPath(agent, scope, name);
+		const existing = groups.get(outputDir);
+		if (existing) existing.push(agent);
+		else groups.set(outputDir, [agent]);
+	}
+	return groups;
+}
+async function pathExists(path) {
+	try {
+		await stat(path);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function inspectLink(outputDir, name, expectedSourceDir) {
+	let entry;
+	try {
+		entry = await lstat(outputDir);
+	} catch {
+		return { status: "absent" };
+	}
+	if (!entry.isSymbolicLink()) return { status: "conflict" };
+	const target = await readlink(outputDir);
+	if (!isOwnedSkillLink(target, name)) return { status: "conflict" };
+	const resolvedTarget = resolve(dirname(outputDir), target);
+	return {
+		status: "owned",
+		resolves: await pathExists(resolvedTarget),
+		correct: expectedSourceDir === void 0 || resolvedTarget === resolve(expectedSourceDir)
+	};
+}
+async function createSkillLink(target, outputDir) {
+	await mkdir(dirname(outputDir), { recursive: true });
+	try {
+		await symlink(target, outputDir, "dir");
+	} catch (error) {
+		const detail = error instanceof Error ? ` ${error.message}` : "";
+		throw new Error(`Could not create skill symlink "${outputDir}" -> "${target}".${detail} If permission was denied, enable symlink permission for this environment and try again.`, { cause: error });
+	}
+}
+/** Links one packaged skill source into the requested agent directories. */
+async function installSkill(options) {
+	const sourceDir = resolveSourceDir(options.sourceDir);
+	const source = readSkillFrontmatter(sourceDir);
+	if (!isValidSkillName(source.name)) throw new Error(`Skill source "${sourceDir}" declares invalid name "${source.name}".`);
+	if (!isOwnedSkillLink(sourceDir, source.name)) throw new Error(`Skill source directory "${sourceDir}" must be named "skills/${source.name}" to support ownership-safe links.`);
+	const agents = options.agents ?? [...getUniversalAgents(), ...await detectInstalledAgents()];
+	const scope = resolveEffectiveScope(options.scope ?? "global");
+	const results = [];
+	for (const [outputDir, groupedAgents] of groupAgentsByOutputDir(agents, scope, source.name)) {
+		const inspection = await inspectLink(outputDir, source.name, sourceDir);
+		if (inspection.status === "conflict" && options.force !== true) throw new SkillConflictError({
+			agent: groupedAgents[0],
+			outputDir
+		});
+		const upToDate = inspection.status === "owned" && inspection.resolves && inspection.correct && options.force !== true;
+		const status = upToDate ? "up-to-date" : inspection.status === "absent" ? "installed" : "repaired";
+		if (!upToDate) {
+			if (inspection.status !== "absent") await rm(outputDir, {
+				recursive: true,
+				force: true
+			});
+			await createSkillLink(skillLinkTarget(sourceDir, outputDir, scope), outputDir);
+		}
+		for (const agent of groupedAgents) results.push({
+			agent,
+			outputDir,
+			scope,
+			status
+		});
+	}
+	return { agents: results };
+}
+/** Unlinks only agent-directory entries carrying the requested skill's ownership signature. */
+async function uninstallSkill(options) {
+	const agents = options.agents ?? [...ALL_AGENTS];
+	const scope = resolveEffectiveScope(options.scope ?? "global");
+	const results = [];
+	for (const [outputDir, groupedAgents] of groupAgentsByOutputDir(agents, scope, options.name)) {
+		const removed = (await inspectLink(outputDir, options.name)).status === "owned";
+		if (removed) await unlink(outputDir);
+		for (const agent of groupedAgents) results.push({
+			agent,
+			outputDir,
+			scope,
+			status: removed ? "removed" : "not-found"
+		});
+	}
+	return { agents: results };
+}
+/** Reports the ownership and health of each requested agent-directory entry. */
+async function getSkillStatus(options) {
+	const agents = options.agents ?? [...ALL_AGENTS];
+	const scope = resolveEffectiveScope(options.scope ?? "global");
+	const expectedSourceDir = resolveSourceDir(options.sourceDir);
+	const results = [];
+	for (const [outputDir, groupedAgents] of groupAgentsByOutputDir(agents, scope, options.name)) {
+		const inspection = await inspectLink(outputDir, options.name, expectedSourceDir);
+		const status = inspection.status === "owned" ? inspection.resolves && inspection.correct ? "linked" : "dangling" : inspection.status;
+		for (const agent of groupedAgents) results.push({
+			agent,
+			outputDir,
+			scope,
+			status
+		});
+	}
+	return { agents: results };
+}
+//#endregion
+//#region src/reconcile.ts
+const UNIVERSAL_GROUP = "__universal__";
+/** @internal Plans link changes without performing prompt or filesystem I/O. */
+function planReconcile(options) {
+	const { statusMap, choices, selected, universal } = options;
+	const installed = [...statusMap.values()].flatMap((entry) => entry.status === "linked" || entry.status === "dangling" ? [entry.agent] : []);
+	const toInstall = selected.filter((agent) => statusMap.get(agent)?.status !== "linked");
+	const keptDirs = new Set(selected.map((agent) => statusMap.get(agent)?.outputDir));
+	return {
+		toInstall,
+		toUninstall: installed.filter((agent) => !selected.includes(agent) && !keptDirs.has(statusMap.get(agent)?.outputDir)),
+		sharedDirWarnings: choices.flatMap((choice) => {
+			const agent = choice.value === "__universal__" ? universal[0] : choice.value;
+			const entry = statusMap.get(agent);
+			return !selected.includes(agent) && entry && keptDirs.has(entry.outputDir) ? [{
+				label: choice.label,
+				outputDir: entry.outputDir
+			}] : [];
+		})
+	};
+}
+//#endregion
+//#region src/extension.ts
+const SKILLS = defineExtensionId("crust:skills");
+const DEFAULT_SKILL_COMMAND_NAME = "skill";
+const SKILLS_SECTION_TITLE = "Agent skills";
+const DEFAULT_SKILL_SCOPE = "global";
+async function resolveScope(rawScope, options) {
+	if (rawScope) return rawScope;
+	if (options.defaultScope) return options.defaultScope;
+	return select({
+		message: "Select scope",
+		choices: [{
+			label: "Project",
+			value: "project"
+		}, {
+			label: "Global",
+			value: "global"
+		}],
+		default: DEFAULT_SKILL_SCOPE
+	});
+}
+function formatAgentLabels(agents) {
+	const universal = new Set(getUniversalAgents());
+	const labels = agents.some((agent) => universal.has(agent)) ? ["Universal"] : [];
+	for (const agent of agents) if (!universal.has(agent)) labels.push(AGENT_LABELS[agent]);
+	return labels;
+}
+async function repairInstalledSkill(packagedSkill, scope, io, report = false) {
+	const status = await getSkillStatus({
+		name: packagedSkill.name,
+		sourceDir: packagedSkill.sourceDir,
+		scope
+	});
+	const effectiveScope = status.agents[0]?.scope ?? scope;
+	for (const outputDir of new Set(status.agents.filter((entry) => entry.status === "conflict").map((entry) => entry.outputDir))) io.stderr(yellow(`Skill conflict [${packagedSkill.name}]: "${outputDir}" is not owned by this skill. Skipping link repair.`));
+	const stale = status.agents.filter((entry) => entry.status === "dangling");
+	if (stale.length === 0) {
+		if (report) io.stdout(dim(`No repairs needed [${packagedSkill.name}] (${effectiveScope}).`));
+		return;
+	}
+	try {
+		const labels = formatAgentLabels((await installSkill({
+			sourceDir: packagedSkill.sourceDir,
+			agents: stale.map((entry) => entry.agent),
+			scope
+		})).agents.map((entry) => entry.agent));
+		if (report && labels.length > 0) io.stdout(`\n${bold(`Repaired "${packagedSkill.name}" for ${labels.join(", ")} (${effectiveScope})`)}`);
+	} catch (error) {
+		if (!(error instanceof SkillConflictError)) throw error;
+		io.stderr(yellow(`Skill conflict [${packagedSkill.name}]: "${error.details.outputDir}" is not owned by this skill. Skipping link repair.`));
+	}
+}
+async function autoRepairSkills(options, io) {
+	let skills;
+	try {
+		skills = loadPackagedSkills(options.distDir);
+	} catch (error) {
+		if (!(error instanceof SkillSourceUnavailableError)) io.stderr(yellow(`Skipping skill link repair: ${error instanceof Error ? error.message : String(error)}`));
+		return;
+	}
+	const configuredScopes = options.defaultScope ? [options.defaultScope] : ["project", "global"];
+	const scopes = [...new Set(configuredScopes.map(resolveEffectiveScope))];
+	for (const packagedSkill of skills) for (const scope of scopes) try {
+		await repairInstalledSkill(packagedSkill, scope, io);
+	} catch (error) {
+		io.stderr(yellow(`Skipping skill link repair [${packagedSkill.name}]: ${error instanceof Error ? error.message : String(error)}`));
+	}
+}
+function formatSkillDocumentation(source, commandName, appName) {
+	try {
+		return loadPackagedSkills(source).map((packagedSkill) => {
+			const sourcePath = isWithin(process.cwd(), packagedSkill.sourceDir) ? relative(process.cwd(), packagedSkill.sourceDir) || "." : packagedSkill.sourceDir;
+			return `${packagedSkill.name} — ${packagedSkill.description}\n  Source: ${sourcePath}`;
+		}).join("\n\n");
+	} catch (error) {
+		if (error instanceof SkillSourceUnavailableError) return `The packaged skills directory is unavailable. Run \`${appName} ${commandName}\` to link packaged skills into an agent directory.`;
+		return `Packaged skills could not be read. Run \`${appName} ${commandName}\` for details.`;
+	}
+}
+async function buildSkills(options, context) {
+	const { writeSkills, writeSkillsFromSnapshot } = await Promise.resolve().then(() => build_exports);
+	const writeOptions = {
+		outDir: join(context.outDir, "skills"),
+		version: context.snapshot.meta.version,
+		name: options.name,
+		description: options.description,
+		extras: options.extras
+	};
+	return (options.generated === false ? await writeSkills(writeOptions) : await writeSkillsFromSnapshot(context.snapshot, writeOptions)).map((file) => join("skills", file));
+}
+const skill = defineExtension(SKILLS, (options) => {
+	const commandName = options.command ?? DEFAULT_SKILL_COMMAND_NAME;
+	return {
+		commands: [buildSkillCommand(commandName, options)],
+		sections: (snapshot) => [{
+			command: [],
+			title: SKILLS_SECTION_TITLE,
+			body: formatSkillDocumentation(options.distDir, commandName, snapshot.meta.name),
+			except: [SKILLS]
+		}],
+		build: (context) => buildSkills(options, context),
+		hooks: { async preRun(context) {
+			if (context.commandPath[1] === commandName || options.autoUpdate === false) return;
+			await autoRepairSkills(options, context);
+		} }
+	};
+});
+async function reconcileSkill(opts) {
+	const { packagedSkill, scope, installAll, io } = opts;
+	const effectiveScope = resolveEffectiveScope(scope);
+	const detected = new Set(await detectInstalledAgents());
+	const universal = getUniversalAgents();
+	const status = await getSkillStatus({
+		name: packagedSkill.name,
+		sourceDir: packagedSkill.sourceDir,
+		scope: effectiveScope
+	});
+	const statusMap = new Map(status.agents.map((entry) => [entry.agent, entry]));
+	const installed = new Set(status.agents.filter((entry) => entry.status === "linked" || entry.status === "dangling").map((entry) => entry.agent));
+	const additional = getAdditionalAgents().filter((agent) => detected.has(agent) || installed.has(agent));
+	const choices = [];
+	if (universal.length > 0) choices.push({
+		label: "Universal",
+		value: UNIVERSAL_GROUP,
+		hint: statusMap.get(universal[0])?.outputDir ?? "path unavailable"
+	});
+	for (const agent of additional) choices.push({
+		label: AGENT_LABELS[agent],
+		value: agent,
+		hint: statusMap.get(agent)?.outputDir ?? "path unavailable"
+	});
+	let selected;
+	if (installAll) selected = [...universal, ...additional];
+	else {
+		const defaults = additional.filter((agent) => installed.has(agent));
+		if (universal.length > 0 && universal.every((agent) => installed.has(agent))) defaults.unshift(UNIVERSAL_GROUP);
+		const values = await multiselect({
+			message: `Select agents to install "${packagedSkill.name}" for`,
+			choices,
+			default: defaults,
+			required: false
+		});
+		selected = values.filter((value) => value !== UNIVERSAL_GROUP);
+		if (values.includes("__universal__")) selected.push(...universal);
+	}
+	const { toInstall, toUninstall, sharedDirWarnings } = planReconcile({
+		statusMap,
+		choices,
+		selected,
+		universal
+	});
+	for (const warning of sharedDirWarnings) io.stderr(yellow(`${warning.label} [${packagedSkill.name}]: "${warning.outputDir}" is shared with a selected agent, so the skill stays available to it.`));
+	if (toInstall.length > 0) {
+		const groups = groupAgentsByOutputDir(toInstall, effectiveScope, packagedSkill.name);
+		const installedAgents = [];
+		for (const agents of groups.values()) {
+			const runInstall = (force) => installSkill({
+				sourceDir: packagedSkill.sourceDir,
+				agents,
+				scope: effectiveScope,
+				force
+			});
+			try {
+				const result = await spinner({
+					message: `Installing skill [${packagedSkill.name}]...`,
+					task: () => runInstall()
+				});
+				installedAgents.push(...result.agents);
+			} catch (error) {
+				if (!(error instanceof SkillConflictError)) throw error;
+				const skipped = `Skipped ${formatAgentLabels(agents).join(", ")} [${packagedSkill.name}]: directory is not owned by this skill.`;
+				if (installAll) {
+					io.stderr(yellow(skipped));
+					continue;
+				}
+				if (!await confirm({
+					message: `"${error.details.outputDir}" is not owned by "${packagedSkill.name}". Overwrite?`,
+					default: false
+				})) {
+					io.stdout(dim(skipped));
+					continue;
+				}
+				const result = await runInstall(true);
+				installedAgents.push(...result.agents);
+			}
+		}
+		if (installedAgents.length > 0) {
+			io.stdout(`\n${bold(`Installed "${packagedSkill.name}"`)}`);
+			for (const line of new Map(installedAgents.map((entry) => [formatAgentLabels([entry.agent])[0], entry.outputDir]))) io.stdout(dim(`  ${line[0]} → ${line[1]}`));
+		}
+	}
+	if (toUninstall.length > 0) await spinner({
+		message: `Removing skill [${packagedSkill.name}]...`,
+		task: () => uninstallSkill({
+			name: packagedSkill.name,
+			agents: toUninstall,
+			scope: effectiveScope
+		})
+	});
+	if (toInstall.length === 0 && toUninstall.length === 0) io.stdout(dim(`No changes [${packagedSkill.name}].`));
+}
+function buildSkillCommand(commandName, options) {
+	return defineCommand(commandName, { description: "Manage agent skill installations" }, (command) => command.flags({
+		name: "scope",
+		type: "string",
+		choices: ["project", "global"],
+		description: "Install scope (project or global)"
+	}, {
+		name: "all",
+		type: "boolean",
+		description: "Install for all detected agents non-interactively"
+	}).add(defineCommand("update", { description: "Repair installed skill links" }, (update) => update.flags({
+		name: "scope",
+		type: "string",
+		choices: ["project", "global"],
+		description: "Update scope (project or global)"
+	}).action(async (context) => {
+		const scope = await resolveScope(context.flags.scope, options);
+		for (const packagedSkill of loadPackagedSkills(options.distDir)) await repairInstalledSkill(packagedSkill, scope, context, true);
+	}))).action(async (context) => {
+		const installAll = context.flags.all === true;
+		const scope = installAll ? context.flags.scope ?? options.defaultScope ?? DEFAULT_SKILL_SCOPE : await resolveScope(context.flags.scope, options);
+		for (const packagedSkill of loadPackagedSkills(options.distDir)) await reconcileSkill({
+			packagedSkill,
+			scope,
+			installAll,
+			io: context
+		});
+	}));
+}
+//#endregion
+//#region src/manifest.ts
+function buildManifest(command) {
+	const model = buildCommandDocumentation(command);
+	const rootName = normalizeName(model.name);
+	if (model.children.some((child) => normalizeName(child.name) === rootName)) throw new Error(`Cannot generate skills when a direct subcommand has the root command name "${rootName}".`);
+	return buildNode(model);
+}
+function buildNode(model) {
+	return {
+		name: normalizeName(model.name),
+		path: model.path.map(normalizeName),
+		description: model.description,
+		usage: model.usage,
+		sections: sectionsFor(model.sections, SKILLS).map(({ title, body }) => ({
+			title,
+			body
+		})),
+		runnable: model.hasAction,
+		args: model.args.map(normalizeArg),
+		flags: [...model.flags].sort((a, b) => a.name.localeCompare(b.name)).map(normalizeFlag),
+		children: [...model.children].sort((a, b) => a.name.localeCompare(b.name)).map(buildNode)
+	};
+}
+function normalizeName(raw) {
+	return raw.trim().toLowerCase();
+}
+function normalizeArg(arg) {
+	const result = {
+		name: arg.name,
+		type: manifestType(arg.type),
+		required: arg.required,
+		variadic: arg.variadic
+	};
+	if (arg.description !== void 0) result.description = arg.description;
+	if (arg.default !== void 0) result.default = serializeDefault(arg.default);
+	return result;
+}
+function normalizeFlag(flag) {
+	const result = {
+		name: flag.name,
+		spellings: flag.spellings,
+		type: manifestType(flag.type),
+		required: flag.required,
+		multiple: flag.multiple
+	};
+	if (flag.description !== void 0) result.description = flag.description;
+	if (flag.default !== void 0) result.default = serializeDefault(flag.default);
+	return result;
+}
+function manifestType(type) {
+	return type === "number" || type === "boolean" ? type : "string";
+}
+function serializeDefault(value) {
+	return formatDefault(value);
+}
+//#endregion
+//#region src/render.ts
+/**
+* Escapes a string for safe use as a YAML scalar value.
+*
+* Wraps the value in double quotes if it contains characters that would
+* break plain YAML scalars (colons, hash signs, brackets, quotes, etc.).
+* Internal double quotes are escaped with a backslash.
+*/
+function escapeYaml(value) {
+	if (/[:#[\]{}&*!|>'"`,@?\\]|^\s|\s$|^---|[\n\r]/.test(value)) return JSON.stringify(value);
+	return value;
+}
+/**
+* Escapes pipe characters in text intended for markdown table cells.
+*
+* Unescaped `|` characters break markdown table structure. This replaces
+* them with `\|` while leaving already-escaped `\|` sequences untouched.
+*/
+function escapeTableCell(value) {
+	return value.replace(/(?<!\\)\|/g, "\\|");
+}
+/**
+* Renders a complete set of skill files from a manifest tree and metadata.
+*
+* Produces:
+* - `SKILL.md` — entrypoint with frontmatter and lazy-load instructions
+* - `commands/` — per-command markdown files mirroring the command hierarchy
+*
+* @param manifest - The canonical manifest tree from {@link buildManifest}
+* @param meta - Skill metadata for frontmatter and naming
+* @returns Array of rendered files ready for writing
+*/
+function renderSkill(manifest, meta) {
+	const files = [];
+	const allNodes = collectNodes(manifest);
+	files.push({
+		path: "SKILL.md",
+		content: renderSkillMd(manifest, meta, allNodes)
+	});
+	for (const node of allNodes) files.push({
+		path: commandFilePath(node),
+		content: renderCommand(node, manifest)
+	});
+	return files;
+}
+/**
+* Collects all nodes in the manifest tree via depth-first traversal.
+* Includes the root node and all descendants.
+*/
+function collectNodes(root) {
+	const nodes = [root];
+	for (const child of root.children) nodes.push(...collectNodes(child));
+	return nodes;
+}
+/**
+* Computes the file path for a command node within the `commands/` directory.
+*
+* The root command maps to `commands/<root-name>.md`.
+* Subcommands strip the root prefix:
+*   `["cli", "remote", "add"]` → `commands/remote/add.md`
+*
+* Single-segment paths (root only) map to `commands/<name>.md`.
+*/
+function commandFilePath(node) {
+	if (node.path.length <= 1) return `commands/${node.name}.md`;
+	return `commands/${node.path.slice(1).join("/")}.md`;
+}
+/**
+* Builds the full invocation string for a command.
+* Example: `my-cli remote add`
+*/
+function commandInvocation(node) {
+	return node.path.join(" ");
+}
+/**
+* Computes a relative path from one file to another within the skill directory.
+*
+* Both paths are relative to the skill root (e.g. "commands/remote/add.md").
+*/
+function relativePath(from, to) {
+	return posix.relative(posix.dirname(from), to);
+}
+/**
+* Renders the `SKILL.md` entrypoint file with YAML frontmatter and
+* lazy-load instructions directing agents to supporting files.
+*/
+function renderSkillMd(manifest, meta, allNodes) {
+	const lines = [];
+	lines.push("---");
+	lines.push(`name: ${escapeYaml(meta.name)}`);
+	lines.push(`description: ${escapeYaml(meta.description)}`);
+	if (meta.version !== void 0) {
+		lines.push("metadata:");
+		lines.push(`  version: "${meta.version}"`);
+	}
+	lines.push("---");
+	lines.push("");
+	lines.push(`# ${meta.name}`);
+	lines.push("");
+	if (manifest.description) {
+		lines.push(manifest.description);
+		lines.push("");
+	}
+	lines.push(`You should use this skill when you need accurate help with \`${meta.name}\` commands, including command selection, syntax, arguments, flags, defaults, and subcommands.`);
+	lines.push("");
+	lines.push("## How to Use This Skill");
+	lines.push("");
+	lines.push("1. You must find the command that best matches the user's task from the Command Reference below.");
+	lines.push("2. You must check the `Type` column before suggesting execution: `runnable` and `runnable, group` commands can be executed, while `group` commands are organizational only.");
+	lines.push("3. You should read only the linked file or files you need from `commands/`.");
+	lines.push("4. You must read a command's file before answering a command-specific question or suggesting that command.");
+	lines.push("5. You must treat the command file as the source of truth for usage, arguments, flags, aliases, and defaults.");
+	lines.push("6. If a flag, argument, alias, or default is not documented there, you must say it is not documented instead of guessing.");
+	lines.push("");
+	lines.push("## Command Reference");
+	lines.push("");
+	lines.push("You should use this table to locate the command file you need.");
+	lines.push("");
+	lines.push(...renderCommandReferenceTable(allNodes));
+	lines.push("");
+	if (manifest.runnable) {
+		lines.push("## Usage");
+		lines.push("");
+		const rootFile = commandFilePath(manifest);
+		lines.push(`The root command is directly executable. You should see [${manifest.name}](${rootFile}) for usage details.`);
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Renders a markdown table mapping all command paths to their
+* documentation file paths.
+*/
+function renderCommandReferenceTable(allNodes) {
+	const lines = [];
+	lines.push("| Command | Type | Description | Documentation |");
+	lines.push("| ------- | ---- | ----------- | ------------- |");
+	for (const node of allNodes) {
+		const invocation = commandInvocation(node);
+		const filePath = commandFilePath(node);
+		const type = commandType(node);
+		const description = escapeTableCell(node.description || "-");
+		lines.push(`| \`${invocation}\` | ${type} | ${description} | [${filePath}](${filePath}) |`);
+	}
+	return lines;
+}
+/**
+* Returns a human-readable label for the command type.
+*/
+function commandType(node) {
+	if (node.runnable && node.children.length > 0) return "runnable, group";
+	if (node.runnable) return "runnable";
+	return "group";
+}
+/** Renders a command markdown file with its runnable details and child links. */
+function renderCommand(node, root) {
+	const lines = [...renderCommandHeading(node), ...renderCommandSections(node)];
+	if (node.runnable) lines.push(...renderRunnableCommandSections(node));
+	if (node.children.length > 0) lines.push(...renderSubcommandLinks(node, commandFilePath(node)));
+	lines.push(...renderNavigation(node, root));
+	return lines.join("\n");
+}
+function renderCommandHeading(node) {
+	const lines = [`# \`${commandInvocation(node)}\``, ""];
+	if (node.description) lines.push(node.description, "");
+	return lines;
+}
+function renderCommandSections(node) {
+	return (node.sections ?? []).flatMap((section) => [
+		`## ${section.title}`,
+		section.body,
+		""
+	]);
+}
+function renderRunnableCommandSections(node) {
+	const lines = [
+		"## Usage",
+		"",
+		"```",
+		node.usage,
+		"```",
+		""
+	];
+	if (node.args.length > 0) lines.push("## Arguments", "", ...renderArgsTable(node.args), "");
+	if (node.flags.length > 0) lines.push("## Flags", "", ...renderFlagsTable(node.flags), "");
+	lines.push("## Command Documentation Authority", "", "You must treat only the arguments, flags, options, aliases, and defaults documented in this file as supported for this command.", "You must not infer or invent additional command-line options.", "");
+	return lines;
+}
+function renderSubcommandLinks(node, filePath) {
+	const lines = ["## Subcommands", ""];
+	for (const child of node.children) {
+		const childRelative = relativePath(filePath, commandFilePath(child));
+		const desc = child.description ? ` - ${child.description}` : "";
+		lines.push(`- [\`${child.name}\`](${childRelative})${desc}`);
+	}
+	lines.push("");
+	return lines;
+}
+/**
+* Renders a markdown table for positional arguments.
+*/
+function renderArgsTable(args) {
+	const lines = [];
+	lines.push("| Argument | Type | Required | Description |");
+	lines.push("| -------- | ---- | -------- | ----------- |");
+	for (const arg of args) {
+		const name = arg.variadic ? `${arg.name}...` : arg.name;
+		const required = arg.required ? "Yes" : "No";
+		const desc = escapeTableCell(formatArgDescription(arg));
+		lines.push(`| \`${name}\` | ${arg.type} | ${required} | ${desc} |`);
+	}
+	return lines;
+}
+/**
+* Formats the description cell for an argument, including default value.
+*/
+function formatArgDescription(arg) {
+	const parts = [];
+	if (arg.description) parts.push(arg.description);
+	if (arg.default !== void 0) parts.push(`Default: \`${arg.default}\``);
+	return parts.join(". ") || "-";
+}
+/**
+* Renders a markdown table for named flags.
+*/
+function renderFlagsTable(flags) {
+	const lines = [];
+	lines.push("| Flag | Type | Required | Description |");
+	lines.push("| ---- | ---- | -------- | ----------- |");
+	for (const flag of flags) {
+		const name = flag.spellings.map((spelling) => `\`${spelling}\``).join(", ");
+		const required = flag.required ? "Yes" : "No";
+		const desc = escapeTableCell(formatFlagDescription(flag));
+		lines.push(`| ${name} | ${flag.type} | ${required} | ${desc} |`);
+	}
+	return lines;
+}
+/**
+* Formats the description cell for a flag, including default value
+* and multiplicity.
+*/
+function formatFlagDescription(flag) {
+	const parts = [];
+	if (flag.description) parts.push(flag.description);
+	if (flag.multiple) parts.push("Can be specified multiple times");
+	if (flag.default !== void 0) parts.push(`Default: \`${flag.default}\``);
+	return parts.join(". ") || "-";
+}
+/**
+* Renders navigation links back to the parent command and skill entrypoint.
+*/
+function renderNavigation(node, root) {
+	const lines = [];
+	const filePath = commandFilePath(node);
+	lines.push("---");
+	lines.push("");
+	if (node.path.length > 1) {
+		const parentNode = findNode(root, node.path.slice(0, -1));
+		if (parentNode) {
+			const parentRelative = relativePath(filePath, commandFilePath(parentNode));
+			const parentInvocation = commandInvocation(parentNode);
+			lines.push(`Parent: [\`${parentInvocation}\`](${parentRelative})`);
+			lines.push("");
+		}
+	}
+	const skillRelative = relativePath(filePath, "SKILL.md");
+	lines.push(`[Skill Overview](${skillRelative})`);
+	lines.push("");
+	return lines;
+}
+/**
+* Finds a node in the manifest tree by its full path.
+*/
+function findNode(root, path) {
+	if (root.path.length === path.length && root.path.every((value, i) => value === path[i])) return root;
+	for (const child of root.children) {
+		const found = findNode(child, path);
+		if (found) return found;
+	}
+}
+//#endregion
+//#region src/build.ts
+var build_exports = /* @__PURE__ */ __exportAll({
+	writeSkills: () => writeSkills,
+	writeSkillsFromSnapshot: () => writeSkillsFromSnapshot
+});
+/**
+* Renders generated and authored skills into a package-ready skill source.
+*/
+async function writeSkills({ app, ...options }) {
+	return await writeSkillSource(await app?.snapshot(), options);
+}
+/** Renders skills from a Command Snapshot prepared in this or another process. */
+async function writeSkillsFromSnapshot(snapshot, options) {
+	return await writeSkillSource(snapshot, options);
+}
+async function writeSkillSource(snapshot, options) {
+	if (snapshot === void 0 && (options.extras?.length ?? 0) === 0) throw new Error("Nothing to write: provide an app or at least one extra skill directory.");
+	const outDir = resolve(options.outDir);
+	if (basename(outDir) !== "skills") throw new Error(`Skill source outDir "${outDir}" must be named "skills".`);
+	const skills = /* @__PURE__ */ new Map();
+	const authoredNames = /* @__PURE__ */ new Set();
+	for (const sourceDir of options.extras ?? []) {
+		const resolved = resolveSourceDir(sourceDir);
+		if (isWithin(outDir, resolved)) throw new Error(`Extra skill directory "${resolved}" is inside outDir "${outDir}", which is replaced on every build. Move authored skills outside the build output.`);
+		const bundle = await loadBundleFiles(sourceDir);
+		validateSkillName(bundle.frontmatter.name);
+		if (authoredNames.has(bundle.frontmatter.name)) throw new SkillSourceConflictError(bundle.frontmatter.name);
+		authoredNames.add(bundle.frontmatter.name);
+		skills.set(bundle.frontmatter.name, bundle.files);
+	}
+	if (snapshot) {
+		const generatedMeta = {
+			name: options.name ?? snapshot.meta.name,
+			description: options.description ?? snapshot.meta.description ?? "",
+			version: options.version
+		};
+		if (!authoredNames.has(generatedMeta.name)) {
+			validateSkillName(generatedMeta.name);
+			requireSkillFrontmatter(generatedMeta, `Skill "${generatedMeta.name}"`);
+			skills.set(generatedMeta.name, renderSkill(buildManifest(snapshot), generatedMeta));
+		}
+	}
+	const cwd = resolve(".");
+	if (outDir === dirname(outDir) || isWithin(outDir, cwd)) throw new Error(`Refusing to replace "${outDir}": outDir must be a dedicated directory, not the filesystem root, the working directory, or an ancestor of it.`);
+	await rm(outDir, {
+		recursive: true,
+		force: true
+	});
+	const written = [];
+	for (const [name, files] of skills) written.push(...(await writeFiles(join(outDir, name), files)).map((path) => join(name, path)));
+	return written;
+}
+function validateSkillName(name) {
+	if (!isValidSkillName(name)) throw new Error(`Invalid skill name "${name}": must be 1–64 lowercase alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens.`);
+}
+async function writeFiles(baseDir, files) {
+	for (const file of files) {
+		const filePath = join(baseDir, file.path);
+		await mkdir(dirname(filePath), { recursive: true });
+		await writeFile(filePath, file.content);
+	}
+	return files.map((file) => file.path);
+}
+//#endregion
+export { SkillConflictError, SkillSourceConflictError, SkillSourceUnavailableError, detectInstalledAgents, getAdditionalAgents, getSkillStatus, getUniversalAgents, installSkill, isUniversalAgent, isValidSkillName, loadPackagedSkills, resolveSkillSource, skill, uninstallSkill, writeSkills, writeSkillsFromSnapshot };