@easynet/agent-skill 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { SkillMetadata, SkillsConfig, LoadedSkills } from "./types.js";
+export type { ParsedFrontmatter } from "./parser.js";
+export type { MatchResult } from "./matcher.js";
+export { parseSkillFrontmatter } from "./parser.js";
+export { scanSkillsDirectory } from "./scanner.js";
+export { generatePromptSection, loadAndInjectSkills } from "./injector.js";
+export { buildSkillIndex, matchSkill } from "./matcher.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { parseSkillFrontmatter } from "./parser.js";
+export { scanSkillsDirectory } from "./scanner.js";
+export { generatePromptSection, loadAndInjectSkills } from "./injector.js";
+export { buildSkillIndex, matchSkill } from "./matcher.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/injector.d.ts

@@ -0,0 +1,19 @@
+import type { SkillMetadata, SkillsConfig, LoadedSkills } from "./types.js";
+/**
+ * Generate a system prompt section listing available skills.
+ * The agent uses this metadata to decide when to read a skill's SKILL.md.
+ */
+export declare function generatePromptSection(skills: SkillMetadata[]): string;
+/**
+ * Load skills from a config, generate the prompt section, and inject it
+ * into the system prompt.
+ *
+ * For mode "prompt" (default): appends skill metadata to system prompt.
+ * For mode "subagent": still loads metadata but does NOT inject into prompt
+ * (the activateSkill tool handles discovery instead).
+ */
+export declare function loadAndInjectSkills(config: SkillsConfig, systemPrompt: string): Promise<{
+    systemPrompt: string;
+    skills: LoadedSkills;
+}>;
+//# sourceMappingURL=injector.d.ts.map

package/dist/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAerE;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,CAgBzD"}

package/dist/injector.js

@@ -0,0 +1,45 @@
+/**
+ * Generate system prompt sections from discovered skills and inject them.
+ */
+import { resolve } from "node:path";
+import { scanSkillsDirectory } from "./scanner.js";
+/**
+ * Generate a system prompt section listing available skills.
+ * The agent uses this metadata to decide when to read a skill's SKILL.md.
+ */
+export function generatePromptSection(skills) {
+    if (skills.length === 0)
+        return "";
+    const lines = [
+        "## Available Skills",
+        "When a user request matches a skill below, read its SKILL.md file for detailed instructions, then follow them step by step.",
+        "",
+    ];
+    for (const skill of skills) {
+        lines.push(`- **${skill.name}**: ${skill.description}`);
+        lines.push(`  Path: ${skill.skillMdPath}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Load skills from a config, generate the prompt section, and inject it
+ * into the system prompt.
+ *
+ * For mode "prompt" (default): appends skill metadata to system prompt.
+ * For mode "subagent": still loads metadata but does NOT inject into prompt
+ * (the activateSkill tool handles discovery instead).
+ */
+export async function loadAndInjectSkills(config, systemPrompt) {
+    const dirPath = resolve(config.path);
+    const skills = await scanSkillsDirectory(dirPath);
+    const loaded = { config, skills };
+    const shouldInject = config.inject_metadata !== false;
+    const mode = config.mode ?? "prompt";
+    if (mode === "prompt" && shouldInject && skills.length > 0) {
+        const section = generatePromptSection(skills);
+        const injected = systemPrompt.trimEnd() + "\n\n" + section;
+        return { systemPrompt: injected, skills: loaded };
+    }
+    return { systemPrompt, skills: loaded };
+}
+//# sourceMappingURL=injector.js.map

package/dist/injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.js","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG;QACZ,qBAAqB;QACrB,6HAA6H;QAC7H,EAAE;KACH,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAoB,EACpB,YAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAElD,MAAM,MAAM,GAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAEhD,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC;IAErC,IAAI,IAAI,KAAK,QAAQ,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC;QAC3D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/dist/matcher.d.ts

@@ -0,0 +1,26 @@
+import type { SkillMetadata } from "./types.js";
+export interface MatchResult {
+    skill: SkillMetadata;
+    score: number;
+    /** Full SKILL.md content, loaded on match. */
+    instructions: string;
+}
+/** Precomputed keyword set for a skill, derived from name + description. */
+interface SkillKeywords {
+    skill: SkillMetadata;
+    keywords: Set<string>;
+}
+/**
+ * Build keyword index for skills. Call once at startup, reuse across requests.
+ */
+export declare function buildSkillIndex(skills: SkillMetadata[]): SkillKeywords[];
+/**
+ * Match user message against skill index.
+ * Returns the best matching skill if score meets threshold, otherwise null.
+ *
+ * Scoring: proportion of skill keywords found in user message.
+ * A skill with 5 keywords where 3 appear in the message scores 0.6.
+ */
+export declare function matchSkill(message: string, index: SkillKeywords[], threshold?: number): Promise<MatchResult | null>;
+export {};
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsBhD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;CACtB;AA0CD,4EAA4E;AAC5E,UAAU,aAAa;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAMxE;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EAAE,EACtB,SAAS,SAAM,GACd,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAmC7B"}

package/dist/matcher.js

@@ -0,0 +1,116 @@
+/**
+ * Match a user message against available skills using keyword overlap.
+ * Zero-latency, no LLM call — pure string matching on skill descriptions and names.
+ */
+import { readFile } from "node:fs/promises";
+/** Stop words excluded from keyword extraction (EN + common CN particles). */
+const STOP_WORDS = new Set([
+    // English
+    "a", "an", "the", "and", "or", "but", "in", "on", "at", "to", "for",
+    "of", "with", "by", "from", "is", "are", "was", "were", "be", "been",
+    "being", "have", "has", "had", "do", "does", "did", "will", "would",
+    "could", "should", "may", "might", "shall", "can", "need", "must",
+    "it", "its", "that", "this", "these", "those", "i", "you", "we", "they",
+    "he", "she", "my", "your", "our", "their", "what", "which", "who",
+    "how", "when", "where", "why", "not", "no", "so", "if", "then",
+    "just", "also", "very", "too", "more", "most", "some", "any", "all",
+    // Chinese particles
+    "的", "了", "在", "是", "我", "有", "和", "就", "不", "人", "都",
+    "一", "一个", "上", "也", "很", "到", "说", "要", "去", "你",
+    "会", "着", "没有", "看", "好", "自己", "这", "他", "她", "它",
+    "吗", "吧", "呢", "啊", "哪", "那", "这个", "什么", "怎么",
+    "可以", "没", "把", "被", "让", "给", "用", "还", "而", "但",
+    "如果", "因为", "所以",
+]);
+/**
+ * Extract meaningful keywords from a string.
+ * Handles both English (space-delimited) and Chinese (character bigrams + individual chars).
+ */
+function extractKeywords(text) {
+    const lower = text.toLowerCase();
+    const words = new Set();
+    // Extract English words and hyphenated segments
+    for (const match of lower.matchAll(/[a-z][a-z0-9-]*/g)) {
+        const word = match[0];
+        if (word.length >= 2 && !STOP_WORDS.has(word)) {
+            words.add(word);
+            // Also add hyphen-split parts: "disk-usage" → "disk", "usage"
+            if (word.includes("-")) {
+                for (const part of word.split("-")) {
+                    if (part.length >= 2 && !STOP_WORDS.has(part))
+                        words.add(part);
+                }
+            }
+        }
+    }
+    // Extract Chinese characters and bigrams
+    const cjk = lower.match(/[\u4e00-\u9fff]+/g);
+    if (cjk) {
+        for (const segment of cjk) {
+            for (const char of segment) {
+                if (!STOP_WORDS.has(char))
+                    words.add(char);
+            }
+            // Bigrams for better matching
+            for (let i = 0; i < segment.length - 1; i++) {
+                const bigram = segment.slice(i, i + 2);
+                if (!STOP_WORDS.has(bigram))
+                    words.add(bigram);
+            }
+        }
+    }
+    return words;
+}
+/**
+ * Build keyword index for skills. Call once at startup, reuse across requests.
+ */
+export function buildSkillIndex(skills) {
+    return skills.map((skill) => ({
+        skill,
+        // Combine name (with hyphens as spaces) and description for richer matching
+        keywords: extractKeywords(`${skill.name.replace(/-/g, " ")} ${skill.description}`),
+    }));
+}
+/**
+ * Match user message against skill index.
+ * Returns the best matching skill if score meets threshold, otherwise null.
+ *
+ * Scoring: proportion of skill keywords found in user message.
+ * A skill with 5 keywords where 3 appear in the message scores 0.6.
+ */
+export async function matchSkill(message, index, threshold = 0.3) {
+    if (index.length === 0)
+        return null;
+    const messageKeywords = extractKeywords(message);
+    if (messageKeywords.size === 0)
+        return null;
+    let bestMatch = null;
+    for (const entry of index) {
+        if (entry.keywords.size === 0)
+            continue;
+        let hits = 0;
+        for (const kw of entry.keywords) {
+            if (messageKeywords.has(kw))
+                hits++;
+        }
+        const score = hits / entry.keywords.size;
+        if (score >= threshold && (!bestMatch || score > bestMatch.score)) {
+            bestMatch = { entry, score };
+        }
+    }
+    if (!bestMatch)
+        return null;
+    // Load SKILL.md content for the matched skill
+    try {
+        const instructions = await readFile(bestMatch.entry.skill.skillMdPath, "utf-8");
+        return {
+            skill: bestMatch.entry.skill,
+            score: bestMatch.score,
+            instructions,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,8EAA8E;AAC9E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,UAAU;IACV,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK;IACnE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IACpE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;IACnE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IACjE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;IACvE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK;IACjE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM;IAC9D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;IACnE,oBAAoB;IACpB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACrD,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACjD,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAClD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9C,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IACjD,IAAI,EAAE,IAAI,EAAE,IAAI;CACjB,CAAC,CAAC;AASH;;;GAGG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,gDAAgD;IAChD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChB,8DAA8D;YAC9D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;wBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC7C,IAAI,GAAG,EAAE,CAAC;QACR,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7C,CAAC;YACD,8BAA8B;YAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAQD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,KAAK;QACL,4EAA4E;QAC5E,QAAQ,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;KACnF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAe,EACf,KAAsB,EACtB,SAAS,GAAG,GAAG;IAEf,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,IAAI,SAAS,GAAmD,IAAI,CAAC;IAErE,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS;QAExC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACzC,IAAI,KAAK,IAAI,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAClE,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,8CAA8C;IAC9C,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAChF,OAAO;YACL,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK;YAC5B,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,YAAY;SACb,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,11 @@
+export interface ParsedFrontmatter {
+    name: string;
+    description: string;
+    allowedTools?: string;
+}
+/**
+ * Parse YAML frontmatter from a SKILL.md file content string.
+ * Returns extracted metadata fields, or throws on malformed frontmatter.
+ */
+export declare function parseSkillFrontmatter(content: string, filePath: string): ParsedFrontmatter;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAsC1F"}

package/dist/parser.js

@@ -0,0 +1,56 @@
+/**
+ * Minimal SKILL.md frontmatter parser.
+ * Extracts name, description, and allowed-tools from YAML frontmatter.
+ * Full validation (name pattern, length limits, etc.) belongs in agent-tool.
+ */
+import yaml from "js-yaml";
+/**
+ * Parse YAML frontmatter from a SKILL.md file content string.
+ * Returns extracted metadata fields, or throws on malformed frontmatter.
+ */
+export function parseSkillFrontmatter(content, filePath) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith("---")) {
+        throw new Error(`SKILL.md must start with YAML frontmatter (---): ${filePath}`);
+    }
+    const endIndex = trimmed.indexOf("\n---", 3);
+    if (endIndex === -1) {
+        throw new Error(`SKILL.md frontmatter is not closed (missing closing ---): ${filePath}`);
+    }
+    const yamlBlock = trimmed.slice(4, endIndex).trim();
+    let raw;
+    try {
+        const parsed = yaml.load(yamlBlock);
+        if (parsed == null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("YAML frontmatter must be an object (key: value)");
+        }
+        raw = parsed;
+    }
+    catch (err) {
+        throw new Error(`Invalid YAML frontmatter in ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const name = stringField(raw, "name");
+    const description = stringField(raw, "description");
+    if (!name) {
+        throw new Error(`SKILL.md frontmatter missing required field "name": ${filePath}`);
+    }
+    if (!description) {
+        throw new Error(`SKILL.md frontmatter missing required field "description": ${filePath}`);
+    }
+    const allowedTools = stringField(raw, "allowed-tools") || undefined;
+    return { name, description, allowedTools };
+}
+function stringField(raw, key) {
+    const v = raw[key];
+    if (v == null)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    if (Array.isArray(v)) {
+        return v.map((x) => (typeof x === "string" ? x : String(x))).join("\n");
+    }
+    return String(v);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,IAAI,MAAM,SAAS,CAAC;AAQ3B;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,QAAgB;IACrE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAEpC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,oDAAoD,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6DAA6D,QAAQ,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEpD,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,GAAG,GAAG,MAAiC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAEpD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,uDAAuD,QAAQ,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,8DAA8D,QAAQ,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,SAAS,CAAC;IAEpE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,WAAW,CAAC,GAA4B,EAAE,GAAW;IAC5D,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,8 @@
+import type { SkillMetadata } from "./types.js";
+/**
+ * Discover all skills in a directory.
+ * Each subdirectory containing a SKILL.md file is treated as a skill.
+ * Returns metadata (Level 1) for all valid skills found.
+ */
+export declare function scanSkillsDirectory(dirPath: string): Promise<SkillMetadata[]>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAwCnF"}

package/dist/scanner.js

@@ -0,0 +1,51 @@
+/**
+ * Scan a directory for SKILL.md-based skills and return their metadata.
+ */
+import { readdir, readFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { parseSkillFrontmatter } from "./parser.js";
+/**
+ * Discover all skills in a directory.
+ * Each subdirectory containing a SKILL.md file is treated as a skill.
+ * Returns metadata (Level 1) for all valid skills found.
+ */
+export async function scanSkillsDirectory(dirPath) {
+    let entries;
+    try {
+        entries = await readdir(dirPath, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const skills = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name.startsWith(".") || entry.name === "node_modules")
+            continue;
+        const skillDir = join(dirPath, entry.name);
+        const skillMdPath = join(skillDir, "SKILL.md");
+        try {
+            await access(skillMdPath);
+        }
+        catch {
+            continue;
+        }
+        try {
+            const content = await readFile(skillMdPath, "utf-8");
+            const frontmatter = parseSkillFrontmatter(content, skillMdPath);
+            skills.push({
+                name: frontmatter.name,
+                description: frontmatter.description,
+                allowedTools: frontmatter.allowedTools,
+                skillMdPath,
+                dirPath: skillDir,
+            });
+        }
+        catch (err) {
+            console.error(`[agent-skill] Failed to parse ${skillMdPath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return skills;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACvD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAAE,SAAS;QAE1E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAEhE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,WAAW,EAAE,WAAW,CAAC,WAAW;gBACpC,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,WAAW;gBACX,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,WAAW,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/test/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/test/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/test/index.test.ts"],"names":[],"mappings":""}

package/dist/test/index.test.js

@@ -0,0 +1,15 @@
+import { describe, it } from "node:test";
+import assert from "node:assert";
+import { parseSkillFrontmatter, scanSkillsDirectory, loadAndInjectSkills } from "../index.js";
+describe("@easynet/agent-skill", () => {
+    it("exports parseSkillFrontmatter", () => {
+        assert.strictEqual(typeof parseSkillFrontmatter, "function");
+    });
+    it("exports scanSkillsDirectory", () => {
+        assert.strictEqual(typeof scanSkillsDirectory, "function");
+    });
+    it("exports loadAndInjectSkills", () => {
+        assert.strictEqual(typeof loadAndInjectSkills, "function");
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/test/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/test/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE9F,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,WAAW,CAAC,OAAO,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,OAAO,mBAAmB,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,OAAO,mBAAmB,EAAE,UAAU,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Skill metadata extracted from SKILL.md frontmatter (Level 1).
+ * Always loaded at startup for discovery (~100 tokens per skill).
+ */
+export interface SkillMetadata {
+    /** Skill name identifier from frontmatter. */
+    name: string;
+    /** What the skill does and when to use it. */
+    description: string;
+    /** Optional space-delimited list of pre-approved tools. */
+    allowedTools?: string;
+    /** Absolute path to SKILL.md. */
+    skillMdPath: string;
+    /** Absolute path to the skill directory. */
+    dirPath: string;
+}
+/**
+ * Configuration for skill loading and injection.
+ * Corresponds to the `skills` field in agent YAML config.
+ */
+export interface SkillsConfig {
+    /** Skills directory path (resolved to absolute). */
+    path: string;
+    /** How skills are surfaced to the agent. Default: "prompt". */
+    mode?: "prompt" | "subagent";
+    /** Whether to inject skill metadata into the system prompt. Default: true. */
+    inject_metadata?: boolean;
+}
+/**
+ * Result of loading skills from a directory.
+ */
+export interface LoadedSkills {
+    config: SkillsConfig;
+    skills: SkillMetadata[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@easynet/agent-skill",
+  "version": "1.0.0",
+  "description": "Agent Skills discovery, parsing, and prompt injection for Easynet agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "pretest": "npm run build",
+    "test": "node --test dist/test/index.test.js"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^12.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.10.0",
+    "semantic-release": "^24.0.0",
+    "typescript": "~5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/easynet-world/agent-skill.git"
+  }
+}