@codemieai/code 0.0.33 → 0.0.34

package/dist/skills/core/SkillManager.js

@@ -0,0 +1,155 @@
+import { SkillDiscovery } from './SkillDiscovery.js';
+import { loadSkillWithInventory } from '../utils/content-loader.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Skill manager singleton
+ *
+ * Provides high-level API for skill management:
+ * - Discovery and caching
+ * - Agent-aware filtering
+ * - Validation
+ * - Cache management
+ */
+export class SkillManager {
+    static instance;
+    discovery;
+    /**
+     * Private constructor (singleton pattern)
+     */
+    constructor() {
+        this.discovery = new SkillDiscovery();
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!SkillManager.instance) {
+            SkillManager.instance = new SkillManager();
+        }
+        return SkillManager.instance;
+    }
+    /**
+     * Get skills for a specific agent
+     *
+     * @param agentName - Name of the agent (e.g., 'codemie-code')
+     * @param options - Additional discovery options
+     * @returns Array of skills compatible with the agent
+     */
+    async getSkillsForAgent(agentName, options = {}) {
+        return this.discovery.discoverSkills({
+            ...options,
+            agentName,
+        });
+    }
+    /**
+     * Get a specific skill by name
+     *
+     * @param name - Skill name
+     * @param options - Discovery options
+     * @returns Skill if found, undefined otherwise
+     */
+    async getSkillByName(name, options = {}) {
+        const skills = await this.discovery.discoverSkills(options);
+        return skills.find((skill) => skill.metadata.name === name);
+    }
+    /**
+     * List all discovered skills
+     *
+     * @param options - Discovery options
+     * @returns Array of all skills
+     */
+    async listSkills(options = {}) {
+        return this.discovery.discoverSkills(options);
+    }
+    /**
+     * Get multiple skills by names with file inventory
+     *
+     * Used for pattern-based invocation when /skill-name patterns are detected.
+     * Loads skill content and builds file inventory for each requested skill.
+     *
+     * @param names - Array of skill names to load
+     * @param options - Discovery options
+     * @returns Array of skills with inventory (only found skills)
+     */
+    async getSkillsByNames(names, options = {}) {
+        const results = [];
+        // Discover all skills (uses cache)
+        const allSkills = await this.discovery.discoverSkills(options);
+        // Find and load each requested skill
+        for (const name of names) {
+            const skill = allSkills.find((s) => s.metadata.name === name);
+            if (skill) {
+                try {
+                    const withInventory = await loadSkillWithInventory(skill);
+                    results.push(withInventory);
+                }
+                catch (error) {
+                    logger.warn(`Failed to load inventory for skill '${name}':`, error);
+                }
+            }
+            else {
+                logger.debug(`Skill '${name}' not found during pattern invocation`);
+            }
+        }
+        return results;
+    }
+    /**
+     * Reload skills (clear cache and force re-discovery)
+     *
+     * Call this after adding/removing/modifying skill files
+     */
+    reload() {
+        this.discovery.clearCache();
+    }
+    /**
+     * Validate all skill files
+     *
+     * Attempts to discover and parse all skills, returning validation results
+     *
+     * @param options - Discovery options
+     * @returns Validation results for all skills
+     */
+    async validateAll(options = {}) {
+        try {
+            // Force reload to ensure fresh validation
+            const skills = await this.discovery.discoverSkills({
+                ...options,
+                forceReload: true,
+            });
+            // All discovered skills are valid (parsing errors are filtered out in discovery)
+            const valid = skills;
+            // For now, we don't track invalid skills (they're silently filtered)
+            // Future enhancement: return parse errors from discovery
+            const invalid = [];
+            return { valid, invalid };
+        }
+        catch (error) {
+            // Discovery failed entirely
+            return {
+                valid: [],
+                invalid: [
+                    {
+                        valid: false,
+                        filePath: 'unknown',
+                        errors: [
+                            error instanceof Error ? error.message : String(error),
+                        ],
+                    },
+                ],
+            };
+        }
+    }
+    /**
+     * Get cache statistics (for debugging)
+     */
+    getCacheStats() {
+        return this.discovery.getCacheStats();
+    }
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance() {
+        SkillManager.instance = undefined;
+    }
+}
+//# sourceMappingURL=SkillManager.js.map

package/dist/skills/core/SkillManager.js.map

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

package/dist/skills/core/types.d.ts

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+/**
+ * Zod schema for skill metadata (frontmatter)
+ */
+export declare const SkillMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    modes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    compatibility: z.ZodOptional<z.ZodObject<{
+        agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        minVersion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * TypeScript interface for skill metadata
+ */
+export type SkillMetadata = z.infer<typeof SkillMetadataSchema>;
+/**
+ * Source type for a skill
+ */
+export type SkillSource = 'global' | 'project' | 'mode-specific';
+/**
+ * Complete skill with metadata, content, and location info
+ */
+export interface Skill {
+    /** Parsed and validated metadata from YAML frontmatter */
+    metadata: SkillMetadata;
+    /** Markdown content (body after frontmatter) */
+    content: string;
+    /** Absolute path to the SKILL.md file */
+    filePath: string;
+    /** Where this skill was discovered from */
+    source: SkillSource;
+    /** Computed priority (source-based + metadata priority) */
+    computedPriority: number;
+}
+/**
+ * Result of parsing a skill file
+ */
+export interface SkillParseResult {
+    skill?: Skill;
+    error?: {
+        filePath: string;
+        message: string;
+        cause?: unknown;
+    };
+}
+/**
+ * Options for skill discovery
+ */
+export interface SkillDiscoveryOptions {
+    /** Working directory (for project-level skills) */
+    cwd?: string;
+    /** Filter by mode (e.g., 'code', 'architect') */
+    mode?: string;
+    /** Filter by agent name */
+    agentName?: string;
+    /** Force cache reload */
+    forceReload?: boolean;
+}
+/**
+ * Validation result for a skill
+ */
+export interface SkillValidationResult {
+    valid: boolean;
+    filePath: string;
+    skillName?: string;
+    errors: string[];
+}
+/**
+ * Configuration for skills in agent config
+ */
+export interface SkillsConfig {
+    /** Enable/disable skill loading */
+    enabled?: boolean;
+    /** Mode for mode-specific skills */
+    mode?: string;
+    /** Auto-reload on file changes (future feature) */
+    autoReload?: boolean;
+}
+/**
+ * Skill pattern detected in a message
+ */
+export interface SkillPattern {
+    /** Skill name (e.g., 'mr', 'commit') */
+    name: string;
+    /** Position in message where pattern starts */
+    position: number;
+    /** Optional arguments after skill name */
+    args?: string;
+    /** Full matched pattern (e.g., '/mr', '/commit -m "fix"') */
+    raw: string;
+}
+/**
+ * Result of pattern matching
+ */
+export interface PatternMatchResult {
+    /** Detected skill patterns */
+    patterns: SkillPattern[];
+    /** Original message */
+    originalMessage: string;
+    /** Whether any patterns were found */
+    hasPatterns: boolean;
+}
+/**
+ * Skill with file inventory
+ */
+export interface SkillWithInventory {
+    /** Base skill metadata and content */
+    skill: Skill;
+    /** Relative file paths (excluding SKILL.md) */
+    files: string[];
+    /** Formatted content ready for prompt injection */
+    formattedContent: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skills/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/skills/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAc9B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,CAAC;IAExB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2CAA2C;IAC3C,MAAM,EAAE,WAAW,CAAC;IAEpB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/skills/core/types.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+/**
+ * Zod schema for skill metadata (frontmatter)
+ */
+export const SkillMetadataSchema = z.object({
+    name: z.string().min(1, 'Skill name is required'),
+    description: z.string().min(1, 'Skill description is required'),
+    version: z.string().optional(),
+    author: z.string().optional(),
+    license: z.string().optional(),
+    modes: z.array(z.string()).optional(),
+    compatibility: z
+        .object({
+        agents: z.array(z.string()).optional(),
+        minVersion: z.string().optional(),
+    })
+        .optional(),
+    priority: z.number().default(0),
+});
+//# sourceMappingURL=types.js.map

package/dist/skills/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/skills/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,+BAA+B,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC;SACb,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAChC,CAAC,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Skills System - Public API
+ *
+ * Provides skill discovery, loading, and management for CodeMie agents.
+ */
+export { SkillManager } from './core/SkillManager.js';
+export { SkillDiscovery } from './core/SkillDiscovery.js';
+export type { Skill, SkillMetadata, SkillSource, SkillParseResult, SkillDiscoveryOptions, SkillValidationResult, SkillsConfig, } from './core/types.js';
+export { SkillMetadataSchema } from './core/types.js';
+export { parseFrontmatter, hasFrontmatter, extractMetadata, extractContent, FrontmatterParseError, } from './utils/frontmatter.js';
+export type { FrontmatterResult } from './utils/frontmatter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,YAAY,EACV,KAAK,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,12 @@
+/**
+ * Skills System - Public API
+ *
+ * Provides skill discovery, loading, and management for CodeMie agents.
+ */
+// Core exports
+export { SkillManager } from './core/SkillManager.js';
+export { SkillDiscovery } from './core/SkillDiscovery.js';
+export { SkillMetadataSchema } from './core/types.js';
+// Utility exports
+export { parseFrontmatter, hasFrontmatter, extractMetadata, extractContent, FrontmatterParseError, } from './utils/frontmatter.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAY1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/skills/utils/content-loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Content loader for skill files and inventory
+ *
+ * Loads skill content and builds file inventories for pattern-based invocation.
+ */
+import type { Skill } from '../core/types.js';
+/**
+ * Skill with file inventory
+ */
+export interface SkillWithInventory {
+    /** Base skill metadata and content */
+    skill: Skill;
+    /** Relative file paths (excluding SKILL.md) */
+    files: string[];
+    /** Formatted content ready for prompt injection */
+    formattedContent: string;
+}
+/**
+ * Load a skill with its file inventory
+ *
+ * @param skill - Skill to load inventory for
+ * @returns Skill with file inventory and formatted content
+ */
+export declare function loadSkillWithInventory(skill: Skill): Promise<SkillWithInventory>;
+//# sourceMappingURL=content-loader.d.ts.map

package/dist/skills/utils/content-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-loader.d.ts","sourceRoot":"","sources":["../../../src/skills/utils/content-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AA4BD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,kBAAkB,CAAC,CAe7B"}

package/dist/skills/utils/content-loader.js

@@ -0,0 +1,161 @@
+/**
+ * Content loader for skill files and inventory
+ *
+ * Loads skill content and builds file inventories for pattern-based invocation.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../../utils/logger.js';
+/**
+ * File extensions to include in inventory
+ */
+const INCLUDED_EXTENSIONS = new Set([
+    '.md',
+    '.sh',
+    '.js',
+    '.ts',
+    '.py',
+    '.json',
+    '.yaml',
+    '.yml',
+    '.toml',
+    '.txt',
+]);
+/**
+ * Directories to exclude from inventory
+ */
+const EXCLUDED_DIRS = new Set(['node_modules', '.git', 'dist', 'build']);
+/**
+ * Maximum depth for file scanning (prevent infinite loops)
+ */
+const MAX_DEPTH = 5;
+/**
+ * Load a skill with its file inventory
+ *
+ * @param skill - Skill to load inventory for
+ * @returns Skill with file inventory and formatted content
+ */
+export async function loadSkillWithInventory(skill) {
+    // Get skill directory from SKILL.md path
+    const skillDirectory = path.dirname(skill.filePath);
+    // Build file inventory
+    const files = await buildFileInventory(skillDirectory);
+    // Format content for injection
+    const formattedContent = formatSkillContent(skill, files);
+    return {
+        skill,
+        files,
+        formattedContent,
+    };
+}
+/**
+ * Build file inventory for a skill directory
+ *
+ * @param skillDirectoryPath - Absolute path to skill directory
+ * @returns Array of relative file paths (sorted alphabetically)
+ */
+async function buildFileInventory(skillDirectoryPath) {
+    const files = [];
+    try {
+        // Check if directory exists
+        if (!fs.existsSync(skillDirectoryPath)) {
+            logger.warn(`Skill directory not found: ${skillDirectoryPath}`);
+            return [];
+        }
+        // Scan directory recursively
+        await scanDirectory(skillDirectoryPath, skillDirectoryPath, files, 0);
+        // Sort alphabetically for consistent output
+        files.sort();
+        return files;
+    }
+    catch (error) {
+        logger.warn(`Failed to build file inventory for ${skillDirectoryPath}:`, error);
+        return [];
+    }
+}
+/**
+ * Recursively scan a directory for files
+ *
+ * @param basePath - Base skill directory path
+ * @param currentPath - Current directory being scanned
+ * @param files - Accumulator for discovered files
+ * @param depth - Current recursion depth
+ */
+async function scanDirectory(basePath, currentPath, files, depth) {
+    // Prevent infinite loops
+    if (depth >= MAX_DEPTH) {
+        return;
+    }
+    try {
+        const entries = await fs.promises.readdir(currentPath, {
+            withFileTypes: true,
+        });
+        for (const entry of entries) {
+            const fullPath = path.join(currentPath, entry.name);
+            // Skip hidden files/directories
+            if (entry.name.startsWith('.')) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                // Skip excluded directories
+                if (EXCLUDED_DIRS.has(entry.name)) {
+                    continue;
+                }
+                // Recurse into subdirectory
+                await scanDirectory(basePath, fullPath, files, depth + 1);
+            }
+            else if (entry.isFile()) {
+                // Skip SKILL.md (already loaded)
+                if (entry.name === 'SKILL.md') {
+                    continue;
+                }
+                // Check file extension
+                const ext = path.extname(entry.name);
+                if (INCLUDED_EXTENSIONS.has(ext)) {
+                    // Store relative path
+                    const relativePath = path.relative(basePath, fullPath);
+                    files.push(relativePath);
+                }
+            }
+            // Skip symbolic links (avoid loops)
+        }
+    }
+    catch (error) {
+        // Permission errors or other issues - log and continue
+        logger.debug(`Failed to scan directory ${currentPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Format skill content for prompt injection
+ *
+ * @param skill - Skill to format
+ * @param files - File inventory
+ * @returns Formatted markdown content
+ */
+function formatSkillContent(skill, files) {
+    const parts = [];
+    // Header
+    parts.push(`## Skill: ${skill.metadata.name}`);
+    parts.push('');
+    parts.push(skill.metadata.description);
+    parts.push('');
+    // Skill content
+    parts.push('### SKILL.md Content');
+    parts.push('');
+    parts.push(skill.content);
+    parts.push('');
+    // File inventory (if any)
+    if (files.length > 0) {
+        parts.push('### Available Files');
+        parts.push('');
+        parts.push('The following files are available in this skill directory.');
+        parts.push('Use the Read tool to access their content when needed:');
+        parts.push('');
+        for (const file of files) {
+            parts.push(`- ${file}`);
+        }
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=content-loader.js.map

package/dist/skills/utils/content-loader.js.map

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

package/dist/skills/utils/frontmatter.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Result of parsing frontmatter from a markdown file
+ */
+export interface FrontmatterResult<T = Record<string, unknown>> {
+    /** Parsed metadata from YAML frontmatter */
+    metadata: T;
+    /** Markdown content (body after frontmatter) */
+    content: string;
+}
+/**
+ * Error thrown when frontmatter parsing fails
+ */
+export declare class FrontmatterParseError extends Error {
+    readonly filePath?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, filePath?: string | undefined, cause?: unknown | undefined);
+}
+/**
+ * Parse YAML frontmatter from a markdown file
+ *
+ * Expected format:
+ * ```
+ * ---
+ * key: value
+ * ---
+ * Content here
+ * ```
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed frontmatter metadata and markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export declare function parseFrontmatter<T = Record<string, unknown>>(fileContent: string, filePath?: string): FrontmatterResult<T>;
+/**
+ * Check if a file has valid frontmatter format (non-throwing)
+ *
+ * @param fileContent - Raw file content
+ * @returns true if file has valid frontmatter structure
+ */
+export declare function hasFrontmatter(fileContent: string): boolean;
+/**
+ * Extract just the metadata without validating content
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Parsed metadata
+ * @throws FrontmatterParseError if parsing fails
+ */
+export declare function extractMetadata<T = Record<string, unknown>>(fileContent: string, filePath?: string): T;
+/**
+ * Extract just the content without validating metadata
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - Optional file path (for error messages)
+ * @returns Markdown content
+ * @throws FrontmatterParseError if parsing fails
+ */
+export declare function extractContent(fileContent: string, filePath?: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/skills/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/skills/utils/frontmatter.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,4CAA4C;IAC5C,QAAQ,EAAE,CAAC,CAAC;IAEZ,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,QAAQ,CAAC,EAAE,MAAM;aACjB,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,iBAAiB,CAAC,CAAC,CAAC,CA8DtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC,CAGH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7E"}