@vibe-agent-toolkit/agent-skills 0.1.11 → 0.1.12

package/dist/index.d.ts

@@ -11,6 +11,10 @@ export { parseFrontmatter, type FrontmatterResult, } from './parsers/frontmatter
 export { validateSkill } from './validators/skill-validator.js';
 export { validate } from './validators/unified-validator.js';
 export { detectResourceFormat } from './validators/format-detection.js';
+export { validateSkillForPackaging, type ExcludedReferenceDetail, type PackagingValidationResult, } from './validators/packaging-validator.js';
+export { createIssue, isOverridable, NAVIGATION_FILE_PATTERNS, NON_OVERRIDABLE_RULES, VALIDATION_RULES, VALIDATION_THRESHOLDS, type RuleCategory, type ValidationRule, type ValidationRuleCode, } from './validators/validation-rules.js';
 export type { ValidationResult, ValidationIssue, ValidateOptions, ResourceFormat, } from './validators/types.js';
 export { importSkillToAgent, type ImportOptions, type ImportResult, } from './import.js';
+export { collectLinks, type DefaultRule, type ExcludeRule, type LinkCollectionOptions, type LinkCollectionResult, type LinkResolution, } from './link-collector.js';
+export type { ValidationOverride } from '@vibe-agent-toolkit/agent-schema';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,GAC/B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE3G,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,GAC/B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE3G,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,GACvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -11,5 +11,8 @@ export { parseFrontmatter, } from './parsers/frontmatter-parser.js';
 export { validateSkill } from './validators/skill-validator.js';
 export { validate } from './validators/unified-validator.js';
 export { detectResourceFormat } from './validators/format-detection.js';
+export { validateSkillForPackaging, } from './validators/packaging-validator.js';
+export { createIssue, isOverridable, NAVIGATION_FILE_PATTERNS, NON_OVERRIDABLE_RULES, VALIDATION_RULES, VALIDATION_THRESHOLDS, } from './validators/validation-rules.js';
 export { importSkillToAgent, } from './import.js';
+export { collectLinks, } from './link-collector.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAuC,MAAM,cAAc,CAAC;AAErF,OAAO,EACL,cAAc,EACd,YAAY,GAIb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,GAGhC,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAqB,MAAM,4BAA4B,CAAC;AAE3G,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAKlB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,GAEjB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAQxE,OAAO,EACL,kBAAkB,GAGnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAuC,MAAM,cAAc,CAAC;AAErF,OAAO,EACL,cAAc,EACd,YAAY,GAIb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,GAGhC,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAqB,MAAM,4BAA4B,CAAC;AAE3G,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAKlB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,gBAAgB,GAEjB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,yBAAyB,GAG1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,kCAAkC,CAAC;AAQ1C,OAAO,EACL,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,GAMb,MAAM,qBAAqB,CAAC"}

package/dist/link-collector.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Unified link collection module
+ *
+ * Provides a single algorithm for collecting and classifying links from a
+ * skill's markdown file tree. Used by both the packaging validator (to report
+ * excluded references) and the skill packager (to rewrite dead links).
+ *
+ * Key design decisions:
+ * - Non-markdown assets (images, JSON, etc.) are always bundled (no recursion, no depth contribution)
+ *   unless they match an exclude pattern
+ * - Markdown links are subject to depth limits and exclude rules
+ * - excludedReferences is NOT deduped: each occurrence preserves per-link context
+ * - bundledFiles IS deduped: same file from multiple paths = one bundle entry
+ * - Glob matching uses forward-slash paths relative to skillRoot
+ */
+/**
+ * Resolution result for a single link found in a bundled markdown file.
+ */
+export interface LinkResolution {
+    /** Absolute path to the linked file */
+    path: string;
+    /** Whether the file will be bundled */
+    bundled: boolean;
+    /** Reason it was excluded (only set when bundled is false) */
+    excludeReason?: 'depth-exceeded' | 'pattern-matched' | 'directory-target' | undefined;
+    /** The rule that matched (only set for pattern-matched exclusions) */
+    matchedRule?: ExcludeRule | undefined;
+    /** Link text from the source markdown */
+    linkText?: string | undefined;
+    /** Original href from the markdown */
+    linkHref?: string | undefined;
+}
+/**
+ * A rule that excludes files from bundling based on glob patterns.
+ * First matching rule wins (ordered evaluation).
+ */
+export interface ExcludeRule {
+    patterns: string[];
+    template?: string | undefined;
+}
+/**
+ * Default template for depth-exceeded and unmatched excluded links.
+ */
+export interface DefaultRule {
+    template?: string | undefined;
+}
+/**
+ * Options for link collection.
+ */
+export interface LinkCollectionOptions {
+    /** Max depth (Infinity for 'full') */
+    maxDepth: number;
+    /** Ordered exclude rules (first match wins) */
+    excludeRules: ExcludeRule[];
+    /** Default handling for depth-exceeded and unmatched excluded links */
+    defaultRule: DefaultRule;
+    /** Skill root directory for resolving relative paths in glob matching */
+    skillRoot: string;
+    /** Package root for boundary enforcement (packager only) */
+    packageRoot?: string | undefined;
+}
+/**
+ * Result of collecting links from a skill's markdown file tree.
+ */
+export interface LinkCollectionResult {
+    /** Files within depth AND not excluded -- will be bundled */
+    bundledFiles: string[];
+    /** Files detected but NOT bundled (depth or exclude) */
+    excludedReferences: LinkResolution[];
+    /** Actual max depth of the bundled portion */
+    maxBundledDepth: number;
+}
+/**
+ * Collect all links from a skill's markdown file tree, classifying each as
+ * bundled or excluded.
+ *
+ * This is the core algorithm used by both the packaging validator and the
+ * skill packager. It walks the markdown link tree starting from the given
+ * skill file, respecting depth limits and exclude rules.
+ *
+ * @param markdownPath - Absolute path to the root SKILL.md file
+ * @param options - Collection options (depth, excludes, etc.)
+ * @returns Collection result with bundled files and excluded references
+ */
+export declare function collectLinks(markdownPath: string, options: LinkCollectionOptions): Promise<LinkCollectionResult>;
+//# sourceMappingURL=link-collector.d.ts.map

package/dist/link-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-collector.d.ts","sourceRoot":"","sources":["../src/link-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACtF,sEAAsE;IACtE,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,uEAAuE;IACvE,WAAW,EAAE,WAAW,CAAC;IACzB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wDAAwD;IACxD,kBAAkB,EAAE,cAAc,EAAE,CAAC;IACrC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AA0BD;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAI/B"}

package/dist/link-collector.js

@@ -0,0 +1,206 @@
+/**
+ * Unified link collection module
+ *
+ * Provides a single algorithm for collecting and classifying links from a
+ * skill's markdown file tree. Used by both the packaging validator (to report
+ * excluded references) and the skill packager (to rewrite dead links).
+ *
+ * Key design decisions:
+ * - Non-markdown assets (images, JSON, etc.) are always bundled (no recursion, no depth contribution)
+ *   unless they match an exclude pattern
+ * - Markdown links are subject to depth limits and exclude rules
+ * - excludedReferences is NOT deduped: each occurrence preserves per-link context
+ * - bundledFiles IS deduped: same file from multiple paths = one bundle entry
+ * - Glob matching uses forward-slash paths relative to skillRoot
+ */
+import { existsSync, statSync } from 'node:fs';
+import { dirname, relative, resolve } from 'node:path';
+import { parseMarkdown } from '@vibe-agent-toolkit/resources';
+import { toForwardSlash } from '@vibe-agent-toolkit/utils';
+import picomatch from 'picomatch';
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Collect all links from a skill's markdown file tree, classifying each as
+ * bundled or excluded.
+ *
+ * This is the core algorithm used by both the packaging validator and the
+ * skill packager. It walks the markdown link tree starting from the given
+ * skill file, respecting depth limits and exclude rules.
+ *
+ * @param markdownPath - Absolute path to the root SKILL.md file
+ * @param options - Collection options (depth, excludes, etc.)
+ * @returns Collection result with bundled files and excluded references
+ */
+export async function collectLinks(markdownPath, options) {
+    const visited = new Set();
+    return collectLinksRecursive(markdownPath, visited, options, 0);
+}
+// ============================================================================
+// Internal Implementation
+// ============================================================================
+/**
+ * Recursive link collection with depth tracking and cycle prevention.
+ *
+ * Depth semantics:
+ * - currentDepth starts at 0 for links found in the root SKILL.md
+ * - The depth check `currentDepth >= maxDepth` is applied to markdown links
+ *   BEFORE recursing into them
+ * - Non-markdown assets bypass the depth check entirely
+ *
+ * @param markdownPath - Current markdown file being processed
+ * @param visited - Set of already-visited normalized paths (cycle prevention)
+ * @param options - Collection options
+ * @param currentDepth - Current depth in the link tree (0 = root's direct links)
+ * @returns Accumulated collection result
+ */
+async function collectLinksRecursive(markdownPath, visited, options, currentDepth) {
+    const normalizedPath = resolve(markdownPath);
+    // Prevent infinite loops from circular references
+    if (visited.has(normalizedPath)) {
+        return { bundledFiles: [], excludedReferences: [], maxBundledDepth: 0 };
+    }
+    visited.add(normalizedPath);
+    // Parse the markdown file to extract links
+    const parseResult = await parseMarkdown(markdownPath);
+    // Resolve all local file links (both markdown and non-markdown)
+    const resolvedLinks = resolveLocalLinks(parseResult.links, markdownPath, options.packageRoot);
+    const bundledFilesSet = new Set();
+    const excludedReferences = [];
+    let maxBundledDepth = 0;
+    // Compile exclude patterns once for this invocation
+    const excludeMatchers = options.excludeRules.map((rule) => ({
+        rule,
+        isMatch: picomatch(rule.patterns),
+    }));
+    for (const link of resolvedLinks) {
+        // Step 0: Directory links are always excluded (directories are not valid bundle targets)
+        if (link.isDirectory) {
+            excludedReferences.push({
+                path: link.path,
+                bundled: false,
+                excludeReason: 'directory-target',
+                linkText: link.linkText,
+                linkHref: link.linkHref,
+            });
+            continue;
+        }
+        // Step 1: Check exclude rules (applies to ALL file types)
+        // Use packageRoot (when available) as the base for glob matching.
+        // skillRoot is dirname(SKILL.md) which may be deep inside the package;
+        // files outside it produce ../  prefixes that picomatch ** cannot match.
+        const matchBase = options.packageRoot ?? options.skillRoot;
+        const relativePath = toForwardSlash(relative(matchBase, link.path));
+        const matchedExclude = excludeMatchers.find((m) => m.isMatch(relativePath));
+        if (matchedExclude) {
+            // Excluded by pattern -- record as excluded reference
+            excludedReferences.push({
+                path: link.path,
+                bundled: false,
+                excludeReason: 'pattern-matched',
+                matchedRule: matchedExclude.rule,
+                linkText: link.linkText,
+                linkHref: link.linkHref,
+            });
+            continue;
+        }
+        // Step 2: Non-markdown assets are always bundled (no recursion, no depth contribution)
+        if (!link.isMarkdown) {
+            bundledFilesSet.add(link.path);
+            continue;
+        }
+        // Step 3: Markdown link -- check depth limit
+        if (currentDepth >= options.maxDepth) {
+            // Beyond depth limit -- record as excluded
+            excludedReferences.push({
+                path: link.path,
+                bundled: false,
+                excludeReason: 'depth-exceeded',
+                linkText: link.linkText,
+                linkHref: link.linkHref,
+            });
+            continue;
+        }
+        // Within depth -- bundle and recurse
+        bundledFilesSet.add(link.path);
+        const childResult = await collectLinksRecursive(link.path, visited, options, currentDepth + 1);
+        // Merge child results
+        for (const childFile of childResult.bundledFiles) {
+            bundledFilesSet.add(childFile);
+        }
+        excludedReferences.push(...childResult.excludedReferences);
+        // Track the deepest bundled depth
+        // The child was at currentDepth+1, so its maxBundledDepth is relative to the root
+        const childDepth = childResult.maxBundledDepth > 0
+            ? childResult.maxBundledDepth
+            : currentDepth + 1;
+        maxBundledDepth = Math.max(maxBundledDepth, childDepth);
+    }
+    return {
+        bundledFiles: [...bundledFilesSet],
+        excludedReferences,
+        maxBundledDepth,
+    };
+}
+/**
+ * Resolve all local file links from parsed markdown, returning both markdown
+ * and non-markdown targets.
+ *
+ * Filters to `local_file` type links, strips anchors, resolves relative paths,
+ * and checks file existence. Optionally enforces package boundary.
+ *
+ * @param links - Raw links from parseMarkdown result
+ * @param markdownPath - Path of the source markdown file (for relative resolution)
+ * @param packageRoot - Optional boundary for path enforcement
+ * @returns Array of resolved links with metadata
+ */
+function resolveLocalLinks(links, markdownPath, packageRoot) {
+    const resolved = [];
+    for (const link of links) {
+        if (link.type !== 'local_file') {
+            continue;
+        }
+        // Strip anchor from href
+        const hrefWithoutAnchor = link.href.split('#')[0] ?? link.href;
+        if (hrefWithoutAnchor === '') {
+            continue;
+        }
+        // Resolve to absolute path
+        const resolvedPath = resolve(dirname(markdownPath), hrefWithoutAnchor);
+        // Check file existence
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Path constructed from parsed markdown links
+        if (!existsSync(resolvedPath)) {
+            continue;
+        }
+        // Enforce package boundary if set
+        if (packageRoot) {
+            const rel = relative(packageRoot, resolvedPath);
+            if (rel.startsWith('..')) {
+                continue;
+            }
+        }
+        // Check if target is a directory (not a file)
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Path constructed from parsed markdown links
+        const stats = statSync(resolvedPath);
+        if (stats.isDirectory()) {
+            resolved.push({
+                path: resolvedPath,
+                isMarkdown: false,
+                isDirectory: true,
+                linkText: link.text ?? '',
+                linkHref: link.href,
+            });
+            continue;
+        }
+        const isMarkdown = resolvedPath.endsWith('.md');
+        resolved.push({
+            path: resolvedPath,
+            isMarkdown,
+            linkText: link.text ?? '',
+            linkHref: link.href,
+        });
+    }
+    return resolved;
+}
+//# sourceMappingURL=link-collector.js.map

package/dist/link-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-collector.js","sourceRoot":"","sources":["../src/link-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,SAAS,MAAM,WAAW,CAAC;AAwFlC,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAAoB,EACpB,OAA8B;IAE9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,OAAO,qBAAqB,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,KAAK,UAAU,qBAAqB,CAClC,YAAoB,EACpB,OAAoB,EACpB,OAA8B,EAC9B,YAAoB;IAEpB,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE7C,kDAAkD;IAClD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAE5B,2CAA2C;IAC3C,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,CAAC;IAEtD,gEAAgE;IAChE,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9F,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,kBAAkB,GAAqB,EAAE,CAAC;IAChD,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,oDAAoD;IACpD,MAAM,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI;QACJ,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;KAClC,CAAC,CAAC,CAAC;IAEJ,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,yFAAyF;QACzF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,kBAAkB,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,kBAAkB;gBACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,kEAAkE;QAClE,uEAAuE;QACvE,yEAAyE;QACzE,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;QAC3D,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QAE5E,IAAI,cAAc,EAAE,CAAC;YACnB,sDAAsD;YACtD,kBAAkB,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,iBAAiB;gBAChC,WAAW,EAAE,cAAc,CAAC,IAAI;gBAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,uFAAuF;QACvF,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,6CAA6C;QAC7C,IAAI,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrC,2CAA2C;YAC3C,kBAAkB,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,gBAAgB;gBAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,qCAAqC;QACrC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAC7C,IAAI,CAAC,IAAI,EACT,OAAO,EACP,OAAO,EACP,YAAY,GAAG,CAAC,CACjB,CAAC;QAEF,sBAAsB;QACtB,KAAK,MAAM,SAAS,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;YACjD,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QACD,kBAAkB,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;QAE3D,kCAAkC;QAClC,kFAAkF;QAClF,MAAM,UAAU,GAAG,WAAW,CAAC,eAAe,GAAG,CAAC;YAChD,CAAC,CAAC,WAAW,CAAC,eAAe;YAC7B,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;QACrB,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,YAAY,EAAE,CAAC,GAAG,eAAe,CAAC;QAClC,kBAAkB;QAClB,eAAe;KAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,iBAAiB,CACxB,KAAkG,EAClG,YAAoB,EACpB,WAAgC;IAEhC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,yBAAyB;QACzB,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC;QAC/D,IAAI,iBAAiB,KAAK,EAAE,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,2BAA2B;QAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAEvE,uBAAuB;QACvB,kHAAkH;QAClH,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,kCAAkC;QAClC,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAChD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,SAAS;YACX,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,kHAAkH;QAClH,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,KAAK;gBACjB,WAAW,EAAE,IAAI;gBACjB,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;gBACzB,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEhD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,YAAY;YAClB,UAAU;YACV,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACzB,QAAQ,EAAE,IAAI,CAAC,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/schemas/claude-plugin.d.ts

@@ -7,11 +7,11 @@ export declare const ClaudePluginSchema: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         email: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        name?: string | undefined;
         email?: string | undefined;
-    }, {
         name?: string | undefined;
+    }, {
         email?: string | undefined;
+        name?: string | undefined;
     }>>;
     homepage: z.ZodOptional<z.ZodString>;
     repository: z.ZodOptional<z.ZodString>;
@@ -72,8 +72,8 @@ export declare const ClaudePluginSchema: z.ZodObject<{
     version?: string | undefined;
     license?: string | undefined;
     author?: {
-        name?: string | undefined;
         email?: string | undefined;
+        name?: string | undefined;
     } | undefined;
     skills?: {
         path: string;
@@ -105,8 +105,8 @@ export declare const ClaudePluginSchema: z.ZodObject<{
     version?: string | undefined;
     license?: string | undefined;
     author?: {
-        name?: string | undefined;
         email?: string | undefined;
+        name?: string | undefined;
     } | undefined;
     skills?: {
         path: string;

package/dist/skill-packager.d.ts

@@ -11,6 +11,10 @@
  * - npm: Standard npm package with package.json
  * - marketplace: JSON manifest for plugin registries
  */
+/**
+ * Resource naming strategy type
+ */
+export type ResourceNamingStrategy = 'basename' | 'resource-id' | 'preserve-path';
 export interface PackageSkillOptions {
     /**
      * Output directory for packaged skill
@@ -32,6 +36,46 @@ export interface PackageSkillOptions {
      * Default: dirname(skillPath)
      */
     basePath?: string;
+    /**
+     * Strategy for naming packaged resource files
+     *
+     * - 'basename': Use original filename only (default, may cause conflicts)
+     * - 'resource-id': Flatten path to kebab-case filename (descriptive, unique)
+     * - 'preserve-path': Preserve directory structure in output
+     *
+     * Default: 'basename'
+     *
+     * @example
+     * // Original: knowledge-base/guides/topics/quickstart/overview.md
+     * // basename:       overview.md (may conflict)
+     * // resource-id:    guides-topics-quickstart-overview.md (with stripPrefix: 'knowledge-base-')
+     * // preserve-path:  guides/topics/quickstart/overview.md (creates subdirectories)
+     */
+    resourceNaming?: ResourceNamingStrategy;
+    /**
+     * Path prefix to strip before applying naming strategy
+     *
+     * Removes a directory prefix from the relative path before the naming strategy is applied.
+     * Works with both 'resource-id' and 'preserve-path' strategies.
+     *
+     * @example
+     * // Original: knowledge-base/guides/topics/quickstart/overview.md
+     * // stripPrefix: 'knowledge-base'
+     * //
+     * // resource-id:    guides-topics-quickstart-overview.md
+     * // preserve-path:  guides/topics/quickstart/overview.md
+     */
+    stripPrefix?: string;
+    /** How deep to follow markdown links (default: 2) */
+    linkFollowDepth?: number | 'full' | undefined;
+    /** Exclude patterns and rewrite templates for non-bundled links */
+    excludeReferencesFromBundle?: {
+        rules?: Array<{
+            patterns: string[];
+            template?: string | undefined;
+        }> | undefined;
+        defaultTemplate?: string | undefined;
+    } | undefined;
 }
 export interface SkillMetadata {
     name: string;
@@ -65,6 +109,8 @@ export interface PackageSkillResult {
         npm?: string;
         marketplace?: string;
     };
+    /** References excluded from bundle */
+    excludedReferences?: string[] | undefined;
 }
 /**
  * Package a skill with all its dependencies

package/dist/skill-packager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-packager.d.ts","sourceRoot":"","sources":["../src/skill-packager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,aAAa,CAAC,EAAE,CAAC;IAE1D;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA4D7B;AAkDD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASlE"}
+{"version":3,"file":"skill-packager.d.ts","sourceRoot":"","sources":["../src/skill-packager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgBH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,aAAa,CAAC,EAAE,CAAC;IAE1D;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,sBAAsB,CAAC;IAExC;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAE9C,mEAAmE;IACnE,2BAA2B,CAAC,EAAE;QAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;YACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;SAC/B,CAAC,GAAG,SAAS,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACtC,GAAG,SAAS,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAmG7B;AAkDD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASlE"}