@skillit/core 1.5.0

package/dist/docs-scanner.d.ts

@@ -0,0 +1,40 @@
+import type { DocsExtractionOptions, ParsedMarkdownDoc } from './markdown-types.js';
+import type { ExtractedDocument } from './types.js';
+/**
+ * Scan a docs directory and return parsed markdown documents.
+ *
+ * - Returns `[]` when `docsDir` does not exist.
+ * - Recursively collects `.md` / `.mdx` files, honouring exclude patterns.
+ * - Default exclusions: **\/api\/**, **\/node_modules\/**, **\/.specify\/**, **\/superpowers\/**.
+ * - Sorts ascending by `order`, then alphabetically by `title`.
+ * - Truncates to `maxDocs` (default 20).
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have hand-written prose docs (tutorials, guides, architecture) in a docs/ directory
+ * - You want these docs included alongside API skills for richer agent context
+ * @avoidWhen
+ * - Your docs/ directory contains only auto-generated API docs — they duplicate the TypeDoc output
+ */
+export declare function scanDocs(options: DocsExtractionOptions): ParsedMarkdownDoc[];
+/**
+ * Convert parsed markdown documents to the generic `ExtractedDocument` shape.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have ParsedMarkdownDoc objects from scanDocs() and need to attach them to an ExtractedSkill
+ */
+export declare function docsToExtractedDocuments(docs: ParsedMarkdownDoc[]): ExtractedDocument[];
+/**
+ * Scan root-level .md files that contain useful documentation.
+ * Skips README.md (parsed separately), LICENSE, CODE_OF_CONDUCT.md.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You want to include well-known root-level markdown files (ARCHITECTURE.md, MIGRATION.md, CONTRIBUTING.md) as documents
+ * - Supplementing API skills with project-level documentation context
+ * @avoidWhen
+ * - Your root directory has many auto-generated or release-tracking markdown files — use explicit include lists instead
+ */
+export declare function scanRootDocs(projectRoot: string): ParsedMarkdownDoc[];
+//# sourceMappingURL=docs-scanner.d.ts.map

package/dist/docs-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-scanner.d.ts","sourceRoot":"","sources":["../src/docs-scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA8FpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,EAAE,CAuB5E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAEvF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAyCrE"}

package/dist/docs-scanner.js

@@ -0,0 +1,176 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { join, relative } from 'path';
+import { parseMarkdownDoc } from './markdown-parser.js';
+// ---------------------------------------------------------------------------
+// Default exclusions & limits
+// ---------------------------------------------------------------------------
+const DEFAULT_EXCLUDE = ['**/api/**', '**/node_modules/**', '**/.specify/**', '**/superpowers/**'];
+const DEFAULT_MAX_DOCS = 20;
+// ---------------------------------------------------------------------------
+// Exclude pattern matching
+// ---------------------------------------------------------------------------
+/**
+ * Build a predicate that returns `true` when a relative path matches any of
+ * the given glob-style exclude patterns.
+ *
+ * Supported pattern form: `** /segment/**`
+ * Matching rule: the path equals, starts with, or contains the `segment` as a
+ * directory component.
+ */
+function makeExcludeMatcher(patterns) {
+    // Extract the core segment from each pattern: `**/foo/**` → `foo`
+    const segments = patterns.map((p) => p
+        .replace(/^\*\*\//, '')
+        .replace(/\/\*\*$/, '')
+        .replace(/\\/g, '/'));
+    return (relativePath) => {
+        const norm = relativePath.replace(/\\/g, '/');
+        for (const seg of segments) {
+            if (norm === seg ||
+                norm.startsWith(seg + '/') ||
+                norm.includes('/' + seg + '/') ||
+                norm.endsWith('/' + seg)) {
+                return true;
+            }
+        }
+        return false;
+    };
+}
+// ---------------------------------------------------------------------------
+// Recursive file collection
+// ---------------------------------------------------------------------------
+function collectMarkdownFiles(dir, rootDir, isExcluded) {
+    const results = [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        const relPath = relative(rootDir, fullPath).replace(/\\/g, '/');
+        let stat;
+        try {
+            stat = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            if (!isExcluded(relPath)) {
+                results.push(...collectMarkdownFiles(fullPath, rootDir, isExcluded));
+            }
+        }
+        else if (/\.mdx?$/.test(entry)) {
+            if (!isExcluded(relPath)) {
+                results.push(relPath);
+            }
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Scan a docs directory and return parsed markdown documents.
+ *
+ * - Returns `[]` when `docsDir` does not exist.
+ * - Recursively collects `.md` / `.mdx` files, honouring exclude patterns.
+ * - Default exclusions: **\/api\/**, **\/node_modules\/**, **\/.specify\/**, **\/superpowers\/**.
+ * - Sorts ascending by `order`, then alphabetically by `title`.
+ * - Truncates to `maxDocs` (default 20).
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have hand-written prose docs (tutorials, guides, architecture) in a docs/ directory
+ * - You want these docs included alongside API skills for richer agent context
+ * @avoidWhen
+ * - Your docs/ directory contains only auto-generated API docs — they duplicate the TypeDoc output
+ */
+export function scanDocs(options) {
+    const { docsDir, exclude, maxDocs = DEFAULT_MAX_DOCS } = options;
+    if (!existsSync(docsDir)) {
+        return [];
+    }
+    const effectiveExclude = exclude ?? DEFAULT_EXCLUDE;
+    const isExcluded = makeExcludeMatcher(effectiveExclude);
+    const filePaths = collectMarkdownFiles(docsDir, docsDir, isExcluded);
+    const docs = filePaths.map((relPath) => {
+        const fullPath = join(docsDir, relPath);
+        const content = readFileSync(fullPath, 'utf-8');
+        return parseMarkdownDoc(content, relPath);
+    });
+    docs.sort((a, b) => {
+        if (a.order !== b.order)
+            return a.order - b.order;
+        return a.title.localeCompare(b.title);
+    });
+    return docs.slice(0, maxDocs);
+}
+/**
+ * Convert parsed markdown documents to the generic `ExtractedDocument` shape.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have ParsedMarkdownDoc objects from scanDocs() and need to attach them to an ExtractedSkill
+ */
+export function docsToExtractedDocuments(docs) {
+    return docs.map((doc) => ({ title: doc.title, content: doc.rawContent }));
+}
+/**
+ * Scan root-level .md files that contain useful documentation.
+ * Skips README.md (parsed separately), LICENSE, CODE_OF_CONDUCT.md.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You want to include well-known root-level markdown files (ARCHITECTURE.md, MIGRATION.md, CONTRIBUTING.md) as documents
+ * - Supplementing API skills with project-level documentation context
+ * @avoidWhen
+ * - Your root directory has many auto-generated or release-tracking markdown files — use explicit include lists instead
+ */
+export function scanRootDocs(projectRoot) {
+    const SKIP = new Set([
+        'readme.md',
+        'license',
+        'license.md',
+        'code_of_conduct.md',
+        'changelog.md',
+        'changes.md',
+        'history.md',
+        'releases.md',
+        'security.md',
+        'support.md',
+        'contributors.md',
+        'authors.md',
+        'acknowledgments.md',
+        'agents.md',
+        'claude.md',
+        'gemini.md',
+        'copilot.md'
+    ]);
+    if (!existsSync(projectRoot))
+        return [];
+    const entries = readdirSync(projectRoot, { withFileTypes: true });
+    const docs = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        if (!/\.mdx?$/i.test(entry.name))
+            continue;
+        if (SKIP.has(entry.name.toLowerCase()))
+            continue;
+        try {
+            const content = readFileSync(join(projectRoot, entry.name), 'utf-8');
+            const parsed = parseMarkdownDoc(content, entry.name);
+            docs.push(parsed);
+        }
+        catch {
+            // skip unreadable
+        }
+    }
+    return docs.sort((a, b) => a.title.localeCompare(b.title));
+}
+//# sourceMappingURL=docs-scanner.js.map

package/dist/docs-scanner.js.map

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

package/dist/examples-scanner.d.ts

@@ -0,0 +1,39 @@
+import type { ExtractedSkill } from './types.js';
+export interface ParsedExample {
+    /** File path relative to examples dir */
+    relativePath: string;
+    /** Title derived from top-level JSDoc @description or first comment, or filename */
+    title: string;
+    /** Description from top-level JSDoc or first comment */
+    description?: string;
+    /** Imported symbol names (e.g. ["renderSkill", "writeSkills"]) */
+    importedSymbols: string[];
+    /** Package names imported from (e.g. ["@skillit/core"]) */
+    importedFrom: string[];
+    /** Full file content */
+    content: string;
+}
+/**
+ * Scan an examples directory for `.ts`/`.js`/`.tsx`/`.jsx` files and parse
+ * their import statements and top-level comments.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have an `examples/` directory alongside source code
+ * - You want to link example files to the exported symbols they demonstrate
+ * @avoidWhen
+ * - Your examples are embedded as @example JSDoc tags (use TypeDoc extraction instead)
+ */
+export declare function scanExamples(examplesDir: string): ParsedExample[];
+/**
+ * Mutate an `ExtractedSkill` in place by linking each example to the first
+ * matching exported function or class. Falls back to `skill.examples` when no
+ * symbol matches any export.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have scanned examples with `scanExamples` and want to attach them to
+ *   the relevant exported symbols inside an `ExtractedSkill`
+ */
+export declare function linkExamplesToSkill(examples: ParsedExample[], skill: ExtractedSkill): void;
+//# sourceMappingURL=examples-scanner.d.ts.map

package/dist/examples-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples-scanner.d.ts","sourceRoot":"","sources":["../src/examples-scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAsJD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CA0CjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CA4B1F"}

package/dist/examples-scanner.js

@@ -0,0 +1,221 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { extname, join, relative } from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SUPPORTED_EXTS = new Set(['.ts', '.js', '.tsx', '.jsx']);
+/**
+ * Matches all forms of import statements:
+ * - Named:     import { X, Y as Z } from 'pkg'
+ * - Namespace: import * as X from 'pkg'
+ * - Default:   import X from 'pkg'
+ */
+const IMPORT_RE = /import\s+(?:\{([^}]+)\}|(\*\s+as\s+\w+)|(\w+))\s+from\s+['"]([^'"]+)['"]/g;
+// ---------------------------------------------------------------------------
+// Import parsing
+// ---------------------------------------------------------------------------
+function parseImports(content) {
+    const symbols = [];
+    const packages = [];
+    let match;
+    IMPORT_RE.lastIndex = 0;
+    while ((match = IMPORT_RE.exec(content)) !== null) {
+        const namedGroup = match[1]; // { X, Y as Z }
+        const namespaceGroup = match[2]; // * as X
+        const defaultGroup = match[3]; // X
+        const pkg = match[4];
+        packages.push(pkg);
+        if (namedGroup) {
+            // Extract original names (before "as" alias)
+            for (const part of namedGroup.split(',')) {
+                const trimmed = part.trim();
+                if (!trimmed)
+                    continue;
+                // "X as Y" → take X; "X" → take X
+                const original = trimmed.split(/\s+as\s+/)[0].trim();
+                if (original)
+                    symbols.push(original);
+            }
+        }
+        else if (namespaceGroup) {
+            // "* as fs" → take "fs"
+            const nsName = namespaceGroup.replace(/^\*\s+as\s+/, '').trim();
+            if (nsName)
+                symbols.push(nsName);
+        }
+        else if (defaultGroup) {
+            symbols.push(defaultGroup);
+        }
+    }
+    return { symbols, packages };
+}
+// ---------------------------------------------------------------------------
+// Title / description extraction
+// ---------------------------------------------------------------------------
+/**
+ * Convert a filename (without extension) to a human-readable title.
+ * "minimal-server" → "Minimal Server", "my_example" → "My Example"
+ */
+function filenameToTitle(name) {
+    return name.replace(/[-_]/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+ * Extract title and description from a top-level JSDoc or `//` comment.
+ * Returns undefined if no comment is found at the top of the file.
+ */
+function extractComment(content) {
+    const stripped = content.trimStart();
+    // Try JSDoc: /** ... */
+    if (stripped.startsWith('/**')) {
+        const end = stripped.indexOf('*/');
+        if (end !== -1) {
+            const block = stripped.slice(3, end);
+            const lines = block
+                .split('\n')
+                .map((l) => l.replace(/^\s*\*\s?/, '').trim())
+                .filter((l) => l.length > 0);
+            if (lines.length === 0)
+                return undefined;
+            const title = lines[0];
+            const rest = lines.slice(1).join(' ').trim() || undefined;
+            return { title, description: rest };
+        }
+    }
+    // Try single-line // comment
+    if (stripped.startsWith('//')) {
+        const firstLine = stripped.split('\n')[0];
+        const title = firstLine.replace(/^\/\/\s*/, '').trim();
+        if (title)
+            return { title };
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// File collection
+// ---------------------------------------------------------------------------
+function collectExampleFiles(dir, rootDir) {
+    const results = [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        let stat;
+        try {
+            stat = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            results.push(...collectExampleFiles(fullPath, rootDir));
+        }
+        else if (SUPPORTED_EXTS.has(extname(entry))) {
+            const relPath = relative(rootDir, fullPath).replace(/\\/g, '/');
+            results.push(relPath);
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Language tag helper
+// ---------------------------------------------------------------------------
+function langTag(relativePath) {
+    const ext = extname(relativePath);
+    if (ext === '.ts' || ext === '.tsx')
+        return 'typescript';
+    return 'javascript';
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Scan an examples directory for `.ts`/`.js`/`.tsx`/`.jsx` files and parse
+ * their import statements and top-level comments.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have an `examples/` directory alongside source code
+ * - You want to link example files to the exported symbols they demonstrate
+ * @avoidWhen
+ * - Your examples are embedded as @example JSDoc tags (use TypeDoc extraction instead)
+ */
+export function scanExamples(examplesDir) {
+    if (!existsSync(examplesDir))
+        return [];
+    const relPaths = collectExampleFiles(examplesDir, examplesDir);
+    const results = [];
+    for (const relPath of relPaths) {
+        const fullPath = join(examplesDir, relPath);
+        let content;
+        try {
+            content = readFileSync(fullPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const { symbols, packages } = parseImports(content);
+        const comment = extractComment(content);
+        let title;
+        let description;
+        if (comment) {
+            title = comment.title;
+            description = comment.description;
+        }
+        else {
+            // Derive from filename (strip extension)
+            const basename = relPath.split('/').pop();
+            const nameWithoutExt = basename.replace(/\.[^.]+$/, '');
+            title = filenameToTitle(nameWithoutExt);
+        }
+        results.push({
+            relativePath: relPath,
+            title,
+            description,
+            importedSymbols: symbols,
+            importedFrom: packages,
+            content
+        });
+    }
+    return results;
+}
+/**
+ * Mutate an `ExtractedSkill` in place by linking each example to the first
+ * matching exported function or class. Falls back to `skill.examples` when no
+ * symbol matches any export.
+ *
+ * @category Parsing
+ * @useWhen
+ * - You have scanned examples with `scanExamples` and want to attach them to
+ *   the relevant exported symbols inside an `ExtractedSkill`
+ */
+export function linkExamplesToSkill(examples, skill) {
+    for (const example of examples) {
+        const lang = langTag(example.relativePath);
+        const fenced = `\`\`\`${lang}\n${example.content}\n\`\`\``;
+        let linked = false;
+        // Find first symbol that matches a function or class export
+        for (const symbol of example.importedSymbols) {
+            const fn = skill.functions.find((f) => f.name === symbol);
+            if (fn) {
+                fn.examples.push(fenced);
+                linked = true;
+                break;
+            }
+            const cls = skill.classes.find((c) => c.name === symbol);
+            if (cls) {
+                cls.examples.push(fenced);
+                linked = true;
+                break;
+            }
+        }
+        if (!linked) {
+            skill.examples.push(fenced);
+        }
+    }
+}
+//# sourceMappingURL=examples-scanner.js.map

package/dist/examples-scanner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared types, renderers, and utilities for the skillit ecosystem.
+ *
+ * Core provides the intermediate representation (ExtractedSkill), the SKILL.md renderer
+ * with progressive disclosure (lean discovery file + on-demand reference files), the
+ * audit engine (20 checks across fatal/error/warning/alert), and utilities for
+ * token budgeting, README parsing, and docs scanning.
+ *
+ * @remarks
+ * All extractors (@skillit/typedoc, @skillit/cli, @skillit/docusaurus) produce
+ * ExtractedSkill objects. Core renders them into SKILL.md + references/ files.
+ * The rendering is framework-agnostic — it doesn't know where the data came from.
+ *
+ * @packageDocumentation
+ */
+export type { ExtractedSkill, ExtractedSkillAudit, ExtractedFunction, ExtractedFunctionMcpMetadata, ExtractedClass, ExtractedType, ExtractedEnum, ExtractedParameter, ExtractedProperty, ExtractedVariable, ExtractedDocument, ExtractedResource, ExtractedPrompt, ExtractedPromptArgument, SkillSetup, AdapterFingerprint, InvocationAdapter, AdapterRenderContext, AdapterRenderContextBase, AdapterRenderContextBundle, AdapterRenderContextHttp, AdapterRenderContextStdio, RefCategory, RefManifest, RefManifestEntry, RenderedFile, RenderedSkill, SkillRenderOptions, SkillWriteOptions, SkillWriteResult, SkillWritePreserveReason, McpAuditSeverity, McpAuditIssue } from './types.js';
+export { renderSkills, renderSkill } from './renderer.js';
+export { canonicalize } from './canonical.js';
+export type { CanonicalizeOptions } from './canonical.js';
+export { writeSkills, readInstalledSkillMetadata } from './writer.js';
+export { estimateTokens, truncateToTokenBudget } from './tokens.js';
+export { renderResourcesReference, renderPromptsReference } from './references-mcp.js';
+export type { McpReferenceOptions } from './references-mcp.js';
+export { renderLlmsTxt } from './llms-txt.js';
+export type { LlmsTxtOptions, LlmsTxtResult } from './llms-txt.js';
+export type { AuditSeverity, AuditIssue, AuditPass, AuditContext, ParsedReadme, AuditResult } from './audit-types.js';
+export { parseReadme } from './readme-parser.js';
+export { auditSkill } from './audit.js';
+export { formatAuditText, formatAuditJson, formatScoreEstimate } from './audit-formatter.js';
+export { estimateSkillJudgeScore } from './audit-score.js';
+export type { SkillJudgeEstimate, ActionableImprovement } from './audit-score.js';
+export type { ConfigSourceType, ExtractedConfigSurface, ExtractedConfigOption, ExtractedConfigArgument } from './config-types.js';
+export { renderConfigSurfaceSection, renderConfigReference } from './config-renderer.js';
+export type { ParsedSection, ParsedMarkdownDoc, DocsExtractionOptions } from './markdown-types.js';
+export { parseMarkdownDoc } from './markdown-parser.js';
+export { scanDocs, docsToExtractedDocuments, scanRootDocs } from './docs-scanner.js';
+export { scanExamples, linkExamplesToSkill } from './examples-scanner.js';
+export type { ParsedExample } from './examples-scanner.js';
+export * from './refine/index.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;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,cAAc,EACd,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnE,YAAY,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAElF,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * Shared types, renderers, and utilities for the skillit ecosystem.
+ *
+ * Core provides the intermediate representation (ExtractedSkill), the SKILL.md renderer
+ * with progressive disclosure (lean discovery file + on-demand reference files), the
+ * audit engine (20 checks across fatal/error/warning/alert), and utilities for
+ * token budgeting, README parsing, and docs scanning.
+ *
+ * @remarks
+ * All extractors (@skillit/typedoc, @skillit/cli, @skillit/docusaurus) produce
+ * ExtractedSkill objects. Core renders them into SKILL.md + references/ files.
+ * The rendering is framework-agnostic — it doesn't know where the data came from.
+ *
+ * @packageDocumentation
+ */
+export { renderSkills, renderSkill } from './renderer.js';
+export { canonicalize } from './canonical.js';
+export { writeSkills, readInstalledSkillMetadata } from './writer.js';
+export { estimateTokens, truncateToTokenBudget } from './tokens.js';
+export { renderResourcesReference, renderPromptsReference } from './references-mcp.js';
+export { renderLlmsTxt } from './llms-txt.js';
+export { parseReadme } from './readme-parser.js';
+export { auditSkill } from './audit.js';
+export { formatAuditText, formatAuditJson, formatScoreEstimate } from './audit-formatter.js';
+export { estimateSkillJudgeScore } from './audit-score.js';
+export { renderConfigSurfaceSection, renderConfigReference } from './config-renderer.js';
+export { parseMarkdownDoc } from './markdown-parser.js';
+export { scanDocs, docsToExtractedDocuments, scanRootDocs } from './docs-scanner.js';
+export { scanExamples, linkExamplesToSkill } from './examples-scanner.js';
+export * from './refine/index.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":"AAAA;;;;;;;;;;;;;;GAcG;AAsCH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAY9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAU3D,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAIzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG1E,cAAc,mBAAmB,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;AAMjD,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,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAU9F"}