@to-skills/core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Pradeep Mouli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { ExtractedSkill, ExtractedFunction, ExtractedClass, ExtractedType, ExtractedEnum, ExtractedParameter, ExtractedProperty, RenderedSkill, SkillRenderOptions, } from "./types.js";
+export { renderSkills, renderSkill } from "./renderer.js";
+export { writeSkills } from "./writer.js";
+export { estimateTokens, truncateToTokenBudget } from "./tokens.js";
+export { renderLlmsTxt } from "./llms-txt.js";
+export type { LlmsTxtOptions, LlmsTxtResult } from "./llms-txt.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,EACV,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { renderSkills, renderSkill } from "./renderer.js";
+export { writeSkills } from "./writer.js";
+export { estimateTokens, truncateToTokenBudget } from "./tokens.js";
+export { renderLlmsTxt } from "./llms-txt.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":"AAYA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/llms-txt.d.ts

@@ -0,0 +1,20 @@
+import type { ExtractedSkill } from "./types.js";
+export interface LlmsTxtOptions {
+    /** Project name (falls back to first skill name) */
+    projectName: string;
+    /** Project description */
+    projectDescription: string;
+}
+export interface LlmsTxtResult {
+    /** llms.txt content (summary index) */
+    summary: string;
+    /** llms-full.txt content (complete API) */
+    full: string;
+    /** Estimated tokens for summary */
+    summaryTokens: number;
+    /** Estimated tokens for full */
+    fullTokens: number;
+}
+/** Render llms.txt and llms-full.txt from extracted skills */
+export declare function renderLlmsTxt(skills: ExtractedSkill[], options: LlmsTxtOptions): LlmsTxtResult;
+//# sourceMappingURL=llms-txt.d.ts.map

package/dist/llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../src/llms-txt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiBjD,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,EAAE,cAAc,GACtB,aAAa,CAUf"}

package/dist/llms-txt.js

@@ -0,0 +1,184 @@
+import { estimateTokens } from "./tokens.js";
+/** Max description length in llms.txt summary */
+const SUMMARY_DESC_MAX = 150;
+/** Section ordering — functions/classes first, types/enums in Optional */
+const SECTION_ORDER = {
+    Functions: 1,
+    Classes: 2,
+    Variables: 3,
+    Interfaces: 10,
+    Types: 11,
+    Enums: 12,
+    Other: 20,
+};
+/** Render llms.txt and llms-full.txt from extracted skills */
+export function renderLlmsTxt(skills, options) {
+    const summary = renderSummary(skills, options);
+    const full = renderFull(skills, options);
+    return {
+        summary,
+        full,
+        summaryTokens: estimateTokens(summary),
+        fullTokens: estimateTokens(full),
+    };
+}
+// ---------------------------------------------------------------------------
+// llms.txt — summary index
+// ---------------------------------------------------------------------------
+function renderSummary(skills, options) {
+    const lines = [];
+    lines.push(`# ${options.projectName}\n`);
+    if (options.projectDescription) {
+        lines.push(`> ${options.projectDescription}\n`);
+    }
+    if (skills.length > 1) {
+        for (const skill of skills) {
+            lines.push(`## ${skill.name}\n`);
+            if (skill.description) {
+                lines.push(`> ${truncateDescription(skill.description)}\n`);
+            }
+            renderSummarySections(skill, lines);
+        }
+    }
+    else if (skills.length === 1) {
+        renderSummarySections(skills[0], lines);
+    }
+    return lines.join("\n");
+}
+function renderSummarySections(skill, lines) {
+    const primary = [];
+    const optional = [];
+    // Functions
+    for (const fn of skill.functions) {
+        const desc = truncateDescription(fn.description);
+        primary.push(`- \`${fn.name}\`${desc ? `: ${desc}` : ""}`);
+    }
+    // Classes
+    for (const cls of skill.classes) {
+        const desc = truncateDescription(cls.description);
+        primary.push(`- \`${cls.name}\`${desc ? `: ${desc}` : ""}`);
+    }
+    // Types/Interfaces
+    for (const t of skill.types) {
+        const desc = truncateDescription(t.description);
+        optional.push(`- \`${t.name}\`${desc ? `: ${desc}` : ""}`);
+    }
+    // Enums
+    for (const e of skill.enums) {
+        const desc = truncateDescription(e.description);
+        optional.push(`- \`${e.name}\`${desc ? `: ${desc}` : ""}`);
+    }
+    if (primary.length > 0) {
+        lines.push("### API\n");
+        lines.push(...primary);
+        lines.push("");
+    }
+    if (optional.length > 0) {
+        lines.push("## Optional\n");
+        lines.push("### Types\n");
+        lines.push(...optional);
+        lines.push("");
+    }
+}
+// ---------------------------------------------------------------------------
+// llms-full.txt — complete API content
+// ---------------------------------------------------------------------------
+function renderFull(skills, options) {
+    const lines = [];
+    lines.push(`# ${options.projectName}\n`);
+    if (options.projectDescription) {
+        lines.push(`> ${options.projectDescription}\n`);
+    }
+    for (const skill of skills) {
+        if (skills.length > 1) {
+            lines.push(`## ${skill.name}\n`);
+            if (skill.description)
+                lines.push(`${skill.description}\n`);
+        }
+        // Functions
+        for (const fn of skill.functions) {
+            lines.push(`### ${fn.name}\n`);
+            if (fn.description)
+                lines.push(`${fn.description}\n`);
+            if (fn.signature) {
+                lines.push("```ts", fn.signature, "```\n");
+            }
+            if (fn.parameters.length > 0) {
+                lines.push("**Parameters:**");
+                for (const p of fn.parameters) {
+                    const opt = p.optional ? " (optional)" : "";
+                    lines.push(`- \`${p.name}: ${p.type}\`${opt} — ${p.description || ""}`);
+                }
+                lines.push("");
+            }
+            if (fn.returnType && fn.returnType !== "void") {
+                lines.push(`**Returns:** \`${fn.returnType}\`\n`);
+            }
+            if (fn.examples.length > 0) {
+                for (const ex of fn.examples) {
+                    lines.push(ex);
+                }
+                lines.push("");
+            }
+        }
+        // Classes
+        for (const cls of skill.classes) {
+            lines.push(`### ${cls.name}\n`);
+            if (cls.description)
+                lines.push(`${cls.description}\n`);
+            if (cls.constructorSignature) {
+                lines.push("```ts", cls.constructorSignature, "```\n");
+            }
+            if (cls.properties.length > 0) {
+                lines.push("**Properties:**");
+                for (const p of cls.properties) {
+                    lines.push(`- \`${p.name}: ${p.type}\` — ${p.description || ""}`);
+                }
+                lines.push("");
+            }
+            if (cls.methods.length > 0) {
+                lines.push("**Methods:**");
+                for (const m of cls.methods) {
+                    lines.push(`- \`${m.signature}\` — ${m.description || ""}`);
+                }
+                lines.push("");
+            }
+        }
+        // Types
+        for (const t of skill.types) {
+            lines.push(`### ${t.name}\n`);
+            if (t.description)
+                lines.push(`${t.description}\n`);
+            if (t.definition) {
+                lines.push("```ts", `type ${t.name} = ${t.definition}`, "```\n");
+            }
+        }
+        // Enums
+        for (const e of skill.enums) {
+            lines.push(`### ${e.name}\n`);
+            if (e.description)
+                lines.push(`${e.description}\n`);
+            for (const m of e.members) {
+                lines.push(`- \`${m.name}\` = \`${m.value}\` — ${m.description || ""}`);
+            }
+            lines.push("");
+        }
+        if (skills.length > 1) {
+            lines.push("---\n");
+        }
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function truncateDescription(desc) {
+    if (!desc || desc.length <= SUMMARY_DESC_MAX)
+        return desc;
+    const firstSentence = desc.match(/^[^.!?]+[.!?]/)?.[0];
+    if (firstSentence && firstSentence.length <= SUMMARY_DESC_MAX) {
+        return firstSentence;
+    }
+    return desc.slice(0, SUMMARY_DESC_MAX - 3) + "...";
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.js","sourceRoot":"","sources":["../src/llms-txt.ts"],"names":[],"mappings":"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"}

package/dist/renderer.d.ts

@@ -0,0 +1,6 @@
+import type { ExtractedSkill, RenderedSkill, SkillRenderOptions } from "./types.js";
+/** Render multiple extracted skills into SKILL.md files */
+export declare function renderSkills(skills: ExtractedSkill[], options?: Partial<SkillRenderOptions>): RenderedSkill[];
+/** Render a single extracted skill into a SKILL.md file */
+export declare function renderSkill(skill: ExtractedSkill, options?: Partial<SkillRenderOptions>): RenderedSkill;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAKd,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAepB,2DAA2D;AAC3D,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACpC,aAAa,EAAE,CAGjB;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACpC,aAAa,CA2Df"}

package/dist/renderer.js

@@ -0,0 +1,272 @@
+import { estimateTokens, truncateToTokenBudget } from "./tokens.js";
+/** agentskills.io spec: max 1024 chars for description */
+const DESCRIPTION_MAX = 1024;
+const DEFAULT_OPTIONS = {
+    outDir: "skills",
+    includeExamples: true,
+    includeSignatures: true,
+    maxTokens: 4000,
+    namePrefix: "",
+    license: "",
+};
+/** Render multiple extracted skills into SKILL.md files */
+export function renderSkills(skills, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    return skills.map((skill) => renderSkill(skill, opts));
+}
+/** Render a single extracted skill into a SKILL.md file */
+export function renderSkill(skill, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const skillName = toSkillName(opts.namePrefix || skill.name);
+    const sections = [];
+    // Frontmatter — description is truncated and enriched with trigger phrases
+    const description = buildDescription(skill);
+    sections.push(renderFrontmatter(skillName, description, opts.license || skill.license || ""));
+    // Title
+    sections.push(`# ${skill.name}`);
+    // Overview
+    if (skill.description) {
+        sections.push(skill.description);
+    }
+    // When to Use — derived from API surface
+    const whenToUse = renderWhenToUse(skill);
+    if (whenToUse)
+        sections.push(whenToUse);
+    // Quick Reference — summary of exported surface
+    const quickRef = renderQuickReference(skill);
+    if (quickRef)
+        sections.push(quickRef);
+    // Primary API: Functions and Classes first (what agents can call)
+    if (skill.functions.length > 0) {
+        sections.push(renderFunctions(skill.functions, opts));
+    }
+    if (skill.classes.length > 0) {
+        sections.push(renderClasses(skill.classes, opts));
+    }
+    // Examples (high value — before type definitions)
+    if (opts.includeExamples && skill.examples.length > 0) {
+        sections.push("## Examples\n\n" + skill.examples.join("\n\n"));
+    }
+    // Secondary: Types and Enums (supporting definitions)
+    if (skill.types.length > 0) {
+        sections.push(renderTypes(skill.types));
+    }
+    if (skill.enums.length > 0) {
+        sections.push(renderEnums(skill.enums));
+    }
+    const raw = sections.join("\n\n");
+    const content = truncateToTokenBudget(raw, opts.maxTokens);
+    return {
+        filename: `${skillName}/SKILL.md`,
+        content,
+        tokens: estimateTokens(content),
+    };
+}
+// ---------------------------------------------------------------------------
+// Description builder — enriches with trigger phrases for agent discovery
+// ---------------------------------------------------------------------------
+function buildDescription(skill) {
+    const parts = [];
+    // Base description
+    if (skill.description) {
+        parts.push(skill.description);
+    }
+    else {
+        parts.push(`API reference for ${skill.name}`);
+    }
+    // Add trigger phrases from API surface
+    const triggers = [];
+    if (skill.functions.length > 0) {
+        const names = skill.functions.slice(0, 5).map((f) => f.name);
+        triggers.push(names.join(", "));
+    }
+    if (skill.classes.length > 0) {
+        const names = skill.classes.slice(0, 3).map((c) => c.name);
+        triggers.push(names.join(", "));
+    }
+    if (triggers.length > 0) {
+        parts.push(`Use when working with ${triggers.join(", ")}.`);
+    }
+    const full = parts.join(" ");
+    return truncateDescription(full, DESCRIPTION_MAX);
+}
+/** Truncate description to max chars, keeping sentence boundary */
+function truncateDescription(desc, max) {
+    if (desc.length <= max)
+        return desc;
+    const firstSentence = desc.match(/^[^.!?]+[.!?]/)?.[0];
+    if (firstSentence && firstSentence.length <= max) {
+        return firstSentence;
+    }
+    return desc.slice(0, max - 3) + "...";
+}
+// ---------------------------------------------------------------------------
+// Frontmatter
+// ---------------------------------------------------------------------------
+function renderFrontmatter(name, description, license) {
+    const lines = ["---", `name: ${name}`];
+    lines.push(`description: ${quoteYaml(description)}`);
+    if (license) {
+        lines.push(`license: ${license}`);
+    }
+    lines.push("---");
+    return lines.join("\n");
+}
+function quoteYaml(value) {
+    if (/[:#{}[\],&*?|>!%@`"']/.test(value) || value.includes("\n")) {
+        return `"${value.replace(/"/g, '\\"')}"`;
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
+// When to Use — richer triggers from API surface
+// ---------------------------------------------------------------------------
+function renderWhenToUse(skill) {
+    const triggers = [];
+    if (skill.functions.length > 0) {
+        const names = skill.functions.slice(0, 5).map((f) => `\`${f.name}()\``);
+        triggers.push(`- Calling ${names.join(", ")}${skill.functions.length > 5 ? `, and ${skill.functions.length - 5} more` : ""}`);
+    }
+    if (skill.classes.length > 0) {
+        const names = skill.classes.slice(0, 3).map((c) => `\`${c.name}\``);
+        triggers.push(`- Instantiating or extending ${names.join(", ")}`);
+    }
+    if (skill.types.length > 0) {
+        const names = skill.types.slice(0, 5).map((t) => `\`${t.name}\``);
+        triggers.push(`- Typing with ${names.join(", ")}`);
+    }
+    // Extract @see / @remarks triggers from function tags
+    for (const fn of skill.functions) {
+        if (fn.tags["see"]) {
+            triggers.push(`- See also: ${fn.tags["see"]}`);
+            break; // one is enough
+        }
+    }
+    if (triggers.length === 0)
+        return "";
+    return "## When to Use\n\n" + triggers.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Quick Reference
+// ---------------------------------------------------------------------------
+function renderQuickReference(skill) {
+    const items = [];
+    if (skill.functions.length > 0) {
+        items.push(`**${skill.functions.length} functions** — ${skill.functions.map((f) => `\`${f.name}\``).join(", ")}`);
+    }
+    if (skill.classes.length > 0) {
+        items.push(`**${skill.classes.length} classes** — ${skill.classes.map((c) => `\`${c.name}\``).join(", ")}`);
+    }
+    if (skill.types.length > 0) {
+        items.push(`**${skill.types.length} types** — ${skill.types.map((t) => `\`${t.name}\``).join(", ")}`);
+    }
+    if (skill.enums.length > 0) {
+        items.push(`**${skill.enums.length} enums** — ${skill.enums.map((e) => `\`${e.name}\``).join(", ")}`);
+    }
+    if (items.length === 0)
+        return "";
+    return "## Quick Reference\n\n" + items.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Section renderers
+// ---------------------------------------------------------------------------
+function renderFunctions(fns, opts) {
+    const lines = ["## Functions\n"];
+    for (const fn of fns) {
+        lines.push(`### \`${fn.name}\``);
+        if (fn.description)
+            lines.push(fn.description);
+        if (opts.includeSignatures && fn.signature) {
+            lines.push("```ts", fn.signature, "```");
+        }
+        if (fn.parameters.length > 0) {
+            lines.push("**Parameters:**");
+            for (const p of fn.parameters) {
+                const opt = p.optional ? " (optional)" : "";
+                const def = p.defaultValue ? ` — default: \`${p.defaultValue}\`` : "";
+                lines.push(`- \`${p.name}: ${p.type}\`${opt}${def} — ${p.description || ""}`);
+            }
+        }
+        if (fn.returnType && fn.returnType !== "void") {
+            lines.push(`**Returns:** \`${fn.returnType}\``);
+        }
+        if (opts.includeExamples && fn.examples.length > 0) {
+            for (const ex of fn.examples) {
+                lines.push(ex);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function renderClasses(classes, opts) {
+    const lines = ["## Classes\n"];
+    for (const cls of classes) {
+        lines.push(`### \`${cls.name}\``);
+        if (cls.description)
+            lines.push(cls.description);
+        if (opts.includeSignatures && cls.constructorSignature) {
+            lines.push("```ts", cls.constructorSignature, "```");
+        }
+        if (cls.properties.length > 0) {
+            lines.push("**Properties:**");
+            for (const p of cls.properties) {
+                const opt = p.optional ? " (optional)" : "";
+                lines.push(`- \`${p.name}: ${p.type}\`${opt} — ${p.description || ""}`);
+            }
+        }
+        if (cls.methods.length > 0) {
+            lines.push("**Methods:**");
+            for (const m of cls.methods) {
+                if (opts.includeSignatures) {
+                    lines.push(`- \`${m.signature}\` — ${m.description || ""}`);
+                }
+                else {
+                    lines.push(`- \`${m.name}\` — ${m.description || ""}`);
+                }
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function renderTypes(types) {
+    const lines = ["## Types\n"];
+    for (const t of types) {
+        lines.push(`### \`${t.name}\``);
+        if (t.description)
+            lines.push(t.description);
+        if (t.definition) {
+            lines.push("```ts", t.definition, "```");
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function renderEnums(enums) {
+    const lines = ["## Enums\n"];
+    for (const e of enums) {
+        lines.push(`### \`${e.name}\``);
+        if (e.description)
+            lines.push(e.description);
+        for (const m of e.members) {
+            lines.push(`- \`${m.name}\` = \`${m.value}\` — ${m.description || ""}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+/** Convert a package name to a valid skill name (lowercase, hyphens only) */
+function toSkillName(name) {
+    return name
+        .replace(/^@/, "")
+        .replace(/\//g, "-")
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .toLowerCase();
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}

package/dist/tokens.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Rough token estimate: ~4 chars per token for English/code.
+ * Not exact, but good enough for budgeting skill file sizes.
+ */
+export declare function estimateTokens(text: string): number;
+/** Truncate text to fit within a token budget, preserving complete lines */
+export declare function truncateToTokenBudget(text: string, maxTokens: number): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAY7E"}

package/dist/tokens.js

@@ -0,0 +1,20 @@
+/**
+ * Rough token estimate: ~4 chars per token for English/code.
+ * Not exact, but good enough for budgeting skill file sizes.
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Truncate text to fit within a token budget, preserving complete lines */
+export function truncateToTokenBudget(text, maxTokens) {
+    if (estimateTokens(text) <= maxTokens)
+        return text;
+    const maxChars = maxTokens * 4;
+    const truncated = text.slice(0, maxChars);
+    const lastNewline = truncated.lastIndexOf("\n");
+    if (lastNewline > 0) {
+        return truncated.slice(0, lastNewline) + "\n\n<!-- truncated -->\n";
+    }
+    return truncated + "\n\n<!-- truncated -->\n";
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAU;IACnD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAAA,CACnC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAAiB,EAAU;IAC7E,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAEnD,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,0BAA0B,CAAC;IACtE,CAAC;IAED,OAAO,SAAS,GAAG,0BAA0B,CAAC;AAAA,CAC/C"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/** Extracted API surface for a single package/module */
+export interface ExtractedSkill {
+    /** Package or module name */
+    name: string;
+    /** Package description */
+    description: string;
+    /** License identifier (e.g. "MIT", "Apache-2.0") */
+    license?: string;
+    /** Exported functions */
+    functions: ExtractedFunction[];
+    /** Exported classes */
+    classes: ExtractedClass[];
+    /** Exported interfaces and type aliases */
+    types: ExtractedType[];
+    /** Exported enums */
+    enums: ExtractedEnum[];
+    /** Usage examples from @example tags or doc pages */
+    examples: string[];
+}
+export interface ExtractedFunction {
+    name: string;
+    description: string;
+    signature: string;
+    parameters: ExtractedParameter[];
+    returnType: string;
+    examples: string[];
+    tags: Record<string, string>;
+}
+export interface ExtractedClass {
+    name: string;
+    description: string;
+    constructorSignature: string;
+    methods: ExtractedFunction[];
+    properties: ExtractedProperty[];
+    examples: string[];
+}
+export interface ExtractedType {
+    name: string;
+    description: string;
+    definition: string;
+}
+export interface ExtractedEnum {
+    name: string;
+    description: string;
+    members: Array<{
+        name: string;
+        value: string;
+        description: string;
+    }>;
+}
+export interface ExtractedParameter {
+    name: string;
+    type: string;
+    description: string;
+    optional: boolean;
+    defaultValue?: string;
+}
+export interface ExtractedProperty {
+    name: string;
+    type: string;
+    description: string;
+    optional: boolean;
+}
+/** A rendered skill file ready to write */
+export interface RenderedSkill {
+    /** File path relative to output dir */
+    filename: string;
+    /** Full SKILL.md content with frontmatter */
+    content: string;
+    /** Estimated token count */
+    tokens?: number;
+}
+/** Options controlling skill rendering */
+export interface SkillRenderOptions {
+    /** Output directory for skill files (default: ".github/skills") */
+    outDir: string;
+    /** Include usage examples (default: true) */
+    includeExamples: boolean;
+    /** Include type signatures (default: true) */
+    includeSignatures: boolean;
+    /** Maximum approximate token budget per skill (default: 4000) */
+    maxTokens: number;
+    /** Custom name prefix */
+    namePrefix: string;
+    /** License to include in frontmatter (default: read from package.json) */
+    license: string;
+}
+//# 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,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,uBAAuB;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,2CAA2C;IAC3C,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,eAAe,EAAE,OAAO,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,4 @@
+import type { RenderedSkill, SkillRenderOptions } from "./types.js";
+/** Write rendered skill files to disk */
+export declare function writeSkills(skills: RenderedSkill[], options: Pick<SkillRenderOptions, "outDir">): void;
+//# sourceMappingURL=writer.d.ts.map

package/dist/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEpE,yCAAyC;AACzC,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAC1C,IAAI,CAMN"}

package/dist/writer.js

@@ -0,0 +1,11 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/** Write rendered skill files to disk */
+export function writeSkills(skills, options) {
+    for (const skill of skills) {
+        const fullPath = join(options.outDir, skill.filename);
+        mkdirSync(dirname(fullPath), { recursive: true });
+        writeFileSync(fullPath, skill.content, "utf-8");
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG1C,yCAAyC;AACzC,MAAM,UAAU,WAAW,CACzB,MAAuB,EACvB,OAA2C,EACrC;IACN,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;AAAA,CACF"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@to-skills/core",
+  "version": "0.2.0",
+  "description": "Shared types, SKILL.md renderer, and token budgeting for to-skills plugins",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pradeepmouli/to-skills.git",
+    "directory": "packages/core"
+  },
+  "scripts": {
+    "build": "tsgo -p tsconfig.build.json",
+    "type-check": "tsgo --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}