@polka-codes/core 0.10.11 → 0.10.16

package/dist/skills/discovery.js

@@ -0,0 +1,392 @@
+// generated by polka.codes
+import { homedir } from 'node:os';
+import { parse } from 'yaml';
+import { ZodError } from 'zod';
+import { NodeFileSystemProvider } from '../fs';
+import { IGNORED_DIRECTORIES, SKILL_ERROR_MESSAGES, SKILL_LIMITS } from './constants';
+import { SkillDiscoveryError, skillMetadataSchema } from './types';
+/**
+ * PERFORMANCE CONSIDERATION
+ *
+ * The current implementation eagerly loads all skill files into memory during
+ * discovery. This means every CLI command reads the full content of all skills
+ * from disk, which can cause performance degradation with many skills.
+ *
+ * Future optimization: Implement lazy loading where discoverAll() only reads
+ * SKILL.md metadata, and full skill content is loaded on-demand when the loadSkill
+ * tool is called. This would significantly improve CLI startup time.
+ */
+/**
+ * List of binary file extensions that should not be loaded as text
+ */
+const BINARY_EXTENSIONS = [
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.bmp',
+    '.ico',
+    '.webp',
+    '.pdf',
+    '.zip',
+    '.tar',
+    '.gz',
+    '.exe',
+    '.dll',
+    '.so',
+    '.dylib',
+    '.bin',
+    '.dat',
+    '.db',
+    '.sqlite',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.eot',
+];
+/**
+ * Check if a file is likely binary based on its extension.
+ *
+ * For performance, this is a fast check based on known binary extensions.
+ * Files without known extensions are assumed to be text and will be read.
+ * If reading fails with encoding errors, the file will be skipped.
+ *
+ * @param filename - The filename to check
+ * @returns true if the file has a known binary extension
+ */
+function isBinaryFile(filename) {
+    const ext = filename.toLowerCase().slice(filename.lastIndexOf('.'));
+    return BINARY_EXTENSIONS.includes(ext);
+}
+/**
+ * Check if a buffer contains binary content by looking for null bytes.
+ * This is a simple heuristic that works for most binary files.
+ *
+ * @param buffer - The buffer to check
+ * @returns true if the buffer appears to contain binary data
+ */
+function isBinaryContent(buffer) {
+    // Check for null bytes in the first 8KB (common in binary files)
+    const checkLength = Math.min(buffer.length, 8192);
+    for (let i = 0; i < checkLength; i++) {
+        if (buffer[i] === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Try to read a file as UTF-8 text, returning null if it appears to be binary.
+ * This handles binary files that don't have known extensions by checking content.
+ *
+ * @param filePath - The path to the file to read
+ * @returns The file content as a string, or null if it appears to be binary
+ */
+async function tryReadTextFile(filePath, fs) {
+    try {
+        // First, read as a buffer to check for binary content
+        const buffer = await fs.readFileAsBuffer(filePath);
+        // Check if the file contains binary content
+        if (isBinaryContent(buffer)) {
+            return null;
+        }
+        // If not binary, decode as UTF-8 with fatal mode to catch invalid UTF-8 sequences
+        // This ensures binary files that pass the null-byte check are still detected
+        try {
+            return new TextDecoder('utf-8', { fatal: true }).decode(buffer);
+        }
+        catch (_decodeError) {
+            // Invalid UTF-8 sequence detected, treat as binary
+            return null;
+        }
+    }
+    catch (error) {
+        // If reading fails (e.g., directory), skip it
+        if (error && typeof error === 'object' && 'code' in error && (error.code === 'EINVAL' || error.code === 'EISDIR')) {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Service for discovering and loading Agent Skills from filesystem
+ *
+ * Skills are discovered from three sources with priority:
+ * 1. Project skills at .claude/skills/ (highest priority)
+ * 2. Personal skills at ~/.claude/skills/
+ * 3. Plugin skills at node_modules (lowest priority)
+ */
+export class SkillDiscoveryService {
+    fs;
+    personalSkillsDir;
+    projectSkillsDir;
+    pluginSkillsDirs;
+    constructor(options) {
+        this.fs = options.fs ?? new NodeFileSystemProvider();
+        this.personalSkillsDir = options.personalSkillsDir ?? this.fs.join(homedir(), '.claude', 'skills');
+        this.projectSkillsDir = this.fs.join(options.cwd, '.claude', 'skills');
+        this.pluginSkillsDirs = options.pluginSkillsDirs ?? [];
+    }
+    /**
+     * Discover all available skills from all sources
+     * Removes duplicates (project skills take priority over personal/plugin)
+     */
+    async discoverAll() {
+        const skills = [];
+        // Load in parallel but handle failures gracefully
+        const results = await Promise.allSettled([
+            this.discoverInDirectory(this.projectSkillsDir, 'project'),
+            this.discoverInDirectory(this.personalSkillsDir, 'personal'),
+            this.discoverPlugins(),
+        ]);
+        // Extract successful results
+        const projectSkills = results[0].status === 'fulfilled' ? results[0].value : [];
+        const personalSkills = results[1].status === 'fulfilled' ? results[1].value : [];
+        const pluginSkills = results[2].status === 'fulfilled' ? results[2].value : [];
+        // Log errors if any failed
+        if (results[0].status === 'rejected') {
+            console.warn(`Failed to load project skills: ${results[0].reason}`);
+        }
+        if (results[1].status === 'rejected') {
+            console.warn(`Failed to load personal skills: ${results[1].reason}`);
+        }
+        if (results[2].status === 'rejected') {
+            console.warn(`Failed to load plugin skills: ${results[2].reason}`);
+        }
+        // Filter out duplicates (project skills take priority)
+        const seenNames = new Set();
+        const allSkills = [...projectSkills, ...personalSkills, ...pluginSkills];
+        for (const skill of allSkills) {
+            if (!seenNames.has(skill.metadata.name)) {
+                seenNames.add(skill.metadata.name);
+                skills.push(skill);
+            }
+        }
+        return skills;
+    }
+    /**
+     * Discover skills in a specific directory
+     */
+    async discoverInDirectory(dir, source) {
+        const exists = typeof this.fs.exists === 'boolean' ? this.fs.exists(dir) : await this.fs.exists(dir);
+        if (!exists) {
+            return [];
+        }
+        const skills = [];
+        const entries = await this.fs.readdir(dir);
+        for (const entry of entries) {
+            if (!entry.isDirectory) {
+                continue;
+            }
+            const skillPath = this.fs.join(dir, entry.name);
+            const skillMdPath = this.fs.join(skillPath, 'SKILL.md');
+            const skillMdExists = typeof this.fs.exists === 'boolean' ? this.fs.exists(skillMdPath) : await this.fs.exists(skillMdPath);
+            if (!skillMdExists) {
+                continue;
+            }
+            try {
+                // Only load metadata
+                const content = await this.fs.readFile(skillMdPath);
+                const { metadata } = this.parseSkillMd(content);
+                skills.push({
+                    metadata,
+                    path: skillPath,
+                    source,
+                });
+            }
+            catch (error) {
+                // Log all errors and continue to discover other skills
+                let message = 'Unknown error';
+                let path = skillPath;
+                if (error instanceof SkillDiscoveryError) {
+                    message = error.message;
+                    path = error.path;
+                }
+                else if (error instanceof ZodError) {
+                    message = error.issues[0]?.message ?? 'Invalid skill metadata';
+                }
+                else if (error instanceof Error) {
+                    message = error.message;
+                }
+                console.warn(`Warning: Failed to load skill at ${path}: ${message}`);
+            }
+        }
+        return skills;
+    }
+    /**
+     * Discover skills from plugin directories (node_modules)
+     */
+    async discoverPlugins() {
+        const skills = [];
+        for (const pluginDir of this.pluginSkillsDirs) {
+            const exists = typeof this.fs.exists === 'boolean' ? this.fs.exists(pluginDir) : await this.fs.exists(pluginDir);
+            if (!exists) {
+                continue;
+            }
+            const pluginSkills = await this.discoverInDirectory(pluginDir, 'plugin');
+            skills.push(...pluginSkills);
+        }
+        return skills;
+    }
+    /**
+     * Load a single skill from its directory
+     */
+    async loadSkill(skillPath, source) {
+        const skillMdPath = this.fs.join(skillPath, 'SKILL.md');
+        const skillMdExists = typeof this.fs.exists === 'boolean' ? this.fs.exists(skillMdPath) : await this.fs.exists(skillMdPath);
+        if (!skillMdExists) {
+            throw new SkillDiscoveryError('SKILL.md not found', skillPath);
+        }
+        const content = await this.fs.readFile(skillMdPath);
+        const { metadata, content: instructions } = this.parseSkillMd(content);
+        // Load additional files
+        const files = new Map();
+        let totalSize = 0;
+        const entries = await this.fs.readdir(skillPath);
+        for (const entry of entries) {
+            if (entry.name === 'SKILL.md') {
+                continue;
+            }
+            const filePath = this.fs.join(skillPath, entry.name);
+            if (entry.isFile) {
+                // Skip binary files to avoid corruption
+                if (isBinaryFile(entry.name)) {
+                    continue;
+                }
+                // Check file size before reading to prevent OOM
+                const fileStats = await this.fs.stat(filePath);
+                const fileSize = fileStats.size;
+                if (fileSize > SKILL_LIMITS.MAX_FILE_SIZE) {
+                    throw new SkillDiscoveryError(`File size exceeds limit (${fileSize} > ${SKILL_LIMITS.MAX_FILE_SIZE}): ${entry.name}`, skillPath);
+                }
+                // Check if we would exceed the total skill size limit
+                if (totalSize + fileSize > SKILL_LIMITS.MAX_SKILL_SIZE) {
+                    throw new SkillDiscoveryError(`Total skill size exceeds limit (${totalSize + fileSize} > ${SKILL_LIMITS.MAX_SKILL_SIZE}): ${skillPath}`, skillPath);
+                }
+                const fileContent = await tryReadTextFile(filePath, this.fs);
+                if (fileContent === null) {
+                    // Skip binary files - don't count them towards total size
+                    continue;
+                }
+                // Track cumulative size to prevent resource exhaustion
+                totalSize += fileSize;
+                files.set(entry.name, fileContent);
+            }
+            else if (entry.isDirectory) {
+                // Recursively load directory contents and update total size
+                totalSize = await this.loadDirectoryFiles(filePath, entry.name, files, 0, totalSize);
+            }
+        }
+        return {
+            metadata,
+            content: instructions,
+            files,
+            path: skillPath,
+            source,
+        };
+    }
+    /**
+     * Parse SKILL.md content and extract frontmatter
+     */
+    parseSkillMd(content) {
+        // Use \r?\n to support both LF and CRLF line endings
+        // Use \s* to allow optional trailing spaces after ---
+        const frontmatterRegex = /^---\r?\n([\s\S]+?)\r?\n---\r?\n([\s\S]*)$/;
+        const match = content.match(frontmatterRegex);
+        if (!match || match.length < 3) {
+            throw new SkillDiscoveryError(SKILL_ERROR_MESSAGES.MISSING_FRONTMATTER, '');
+        }
+        const frontmatter = match[1] ?? '';
+        const instructions = match[2] ?? '';
+        const metadata = this.parseMetadata(frontmatter);
+        return { metadata, content: instructions };
+    }
+    /**
+     * Parse and validate YAML frontmatter
+     */
+    parseMetadata(frontmatter) {
+        const parsed = parse(frontmatter);
+        return skillMetadataSchema.parse(parsed);
+    }
+    /**
+     * Recursively load files from a directory into the files map
+     * @returns The total size of all files loaded (in bytes)
+     */
+    async loadDirectoryFiles(dirPath, prefix, files, depth = 0, currentTotal = 0) {
+        const { MAX_DEPTH, MAX_FILES } = SKILL_LIMITS;
+        let totalSize = currentTotal;
+        // Prevent stack overflow from deep recursion
+        if (depth > MAX_DEPTH) {
+            return totalSize;
+        }
+        // Prevent memory exhaustion from too many files
+        if (files.size >= MAX_FILES) {
+            return totalSize;
+        }
+        // Check if the current directory (from prefix) should be ignored
+        const currentDirName = prefix.split('/').pop() ?? prefix;
+        if (IGNORED_DIRECTORIES.includes(currentDirName)) {
+            return totalSize;
+        }
+        const entries = await this.fs.readdir(dirPath);
+        for (const entry of entries) {
+            // Check file count limit before processing each entry
+            if (files.size >= MAX_FILES) {
+                break;
+            }
+            const filePath = this.fs.join(dirPath, entry.name);
+            // Normalize key to avoid double slashes
+            const key = `${prefix}/${entry.name}`.replace(/\/+/g, '/');
+            if (entry.isFile) {
+                // Skip binary files to avoid corruption
+                if (isBinaryFile(entry.name)) {
+                    continue;
+                }
+                // Check file size before reading to prevent OOM
+                const fileStats = await this.fs.stat(filePath);
+                const fileSize = fileStats.size;
+                if (fileSize > SKILL_LIMITS.MAX_FILE_SIZE) {
+                    throw new SkillDiscoveryError(`File size exceeds limit (${fileSize} > ${SKILL_LIMITS.MAX_FILE_SIZE}): ${key}`, dirPath);
+                }
+                // Check if we would exceed the total skill size limit
+                if (totalSize + fileSize > SKILL_LIMITS.MAX_SKILL_SIZE) {
+                    throw new SkillDiscoveryError(`Total skill size exceeds limit (${totalSize + fileSize} > ${SKILL_LIMITS.MAX_SKILL_SIZE}): ${dirPath}`, dirPath);
+                }
+                const content = await tryReadTextFile(filePath, this.fs);
+                if (content === null) {
+                    // Skip binary files - don't count them towards total size
+                    continue;
+                }
+                // Track cumulative size to prevent resource exhaustion
+                totalSize += fileSize;
+                files.set(key, content);
+            }
+            else if (entry.isDirectory) {
+                // Skip ignored directories
+                if (IGNORED_DIRECTORIES.includes(entry.name)) {
+                    continue;
+                }
+                totalSize = await this.loadDirectoryFiles(filePath, key, files, depth + 1, totalSize);
+            }
+        }
+        return totalSize;
+    }
+    /**
+     * Create an initial skill context object
+     */
+    async createContext() {
+        const availableSkills = await this.discoverAll();
+        return {
+            activeSkill: null,
+            availableSkills,
+            skillLoadingHistory: [],
+            loadSkill: async (name) => {
+                const ref = availableSkills.find((s) => s.metadata.name === name);
+                if (!ref)
+                    return null;
+                return this.loadSkill(ref.path, ref.source);
+            },
+        };
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/skills/discovery.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,4 @@
+export * from './constants';
+export * from './discovery';
+export * from './types';
+export * from './validation';

package/dist/skills/index.js

@@ -0,0 +1,6 @@
+// generated by polka.codes
+export * from './constants';
+export * from './discovery';
+export * from './types';
+export * from './validation';
+//# 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,2BAA2B;AAE3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA"}

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

@@ -0,0 +1,3 @@
+export * from './listSkills';
+export * from './loadSkill';
+export * from './readSkillFile';

package/dist/skills/tools/index.js

@@ -0,0 +1,5 @@
+// generated by polka.codes
+export * from './listSkills';
+export * from './loadSkill';
+export * from './readSkillFile';
+//# sourceMappingURL=index.js.map

package/dist/skills/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/tools/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA"}

package/dist/skills/tools/listSkills.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import type { SkillContext } from '../types';
+/**
+ * Tool input parameters for listing skills
+ */
+export declare const ListSkillsInputSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ListSkillsInput = z.infer<typeof ListSkillsInputSchema>;
+/**
+ * Tool output for listing skills
+ */
+export declare const ListSkillsOutputSchema: z.ZodObject<{
+    skills: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        source: z.ZodEnum<{
+            project: "project";
+            personal: "personal";
+            plugin: "plugin";
+        }>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ListSkillsOutput = z.infer<typeof ListSkillsOutputSchema>;
+/**
+ * List all available skills with their descriptions
+ *
+ * This tool enables agents to discover what specialized capabilities
+ * are available based on task context.
+ */
+export declare function listSkills(input: ListSkillsInput, context: SkillContext): Promise<ListSkillsOutput>;
+/**
+ * Tool info for listSkills (used in agent workflow)
+ */
+export declare const listSkillsToolInfo: {
+    readonly name: "listSkills";
+    readonly description: "List all available skills with their descriptions. Use this to discover what specialized capabilities are available.";
+    readonly parameters: z.ZodObject<{
+        filter: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly returns: z.ZodObject<{
+        skills: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            source: z.ZodEnum<{
+                project: "project";
+                personal: "personal";
+                plugin: "plugin";
+            }>;
+        }, z.core.$strip>>;
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+};

package/dist/skills/tools/listSkills.js

@@ -0,0 +1,52 @@
+// generated by polka.codes
+import { z } from 'zod';
+/**
+ * Tool input parameters for listing skills
+ */
+export const ListSkillsInputSchema = z.object({
+    filter: z.string().optional().describe('Optional filter string to match against skill names and descriptions'),
+});
+/**
+ * Tool output for listing skills
+ */
+export const ListSkillsOutputSchema = z.object({
+    skills: z.array(z.object({
+        name: z.string(),
+        description: z.string(),
+        source: z.enum(['personal', 'project', 'plugin']),
+    })),
+    total: z.number(),
+});
+/**
+ * List all available skills with their descriptions
+ *
+ * This tool enables agents to discover what specialized capabilities
+ * are available based on task context.
+ */
+export async function listSkills(input, context) {
+    const { filter } = input;
+    let skills = context.availableSkills;
+    // Apply filter if provided
+    if (filter) {
+        const filterLower = filter.toLowerCase();
+        skills = skills.filter((s) => s.metadata.name.includes(filterLower) || s.metadata.description.toLowerCase().includes(filterLower));
+    }
+    return {
+        skills: skills.map((s) => ({
+            name: s.metadata.name,
+            description: s.metadata.description,
+            source: s.source,
+        })),
+        total: skills.length,
+    };
+}
+/**
+ * Tool info for listSkills (used in agent workflow)
+ */
+export const listSkillsToolInfo = {
+    name: 'listSkills',
+    description: 'List all available skills with their descriptions. Use this to discover what specialized capabilities are available.',
+    parameters: ListSkillsInputSchema,
+    returns: ListSkillsOutputSchema,
+};
+//# sourceMappingURL=listSkills.js.map

package/dist/skills/tools/listSkills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listSkills.js","sourceRoot":"","sources":["../../../src/skills/tools/listSkills.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;CAC/G,CAAC,CAAA;AAIF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;KAClD,CAAC,CACH;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA;AAIF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB,EAAE,OAAqB;IAC5E,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IACxB,IAAI,MAAM,GAAG,OAAO,CAAC,eAAe,CAAA;IAEpC,2BAA2B;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;QACxC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IACpI,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;YACrB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW;YACnC,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;QACH,KAAK,EAAE,MAAM,CAAC,MAAM;KACrB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,sHAAsH;IACnI,UAAU,EAAE,qBAAqB;IACjC,OAAO,EAAE,sBAAsB;CACvB,CAAA"}

package/dist/skills/tools/loadSkill.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import type { SkillContext } from '../types';
+/**
+ * Tool input parameters for loading a skill
+ */
+export declare const LoadSkillInputSchema: z.ZodObject<{
+    skillName: z.ZodString;
+}, z.core.$strip>;
+export type LoadSkillInput = z.infer<typeof LoadSkillInputSchema>;
+/**
+ * Tool output for loading a skill
+ */
+export declare const LoadSkillOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    skill: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        content: z.ZodString;
+        availableFiles: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type LoadSkillOutput = z.infer<typeof LoadSkillOutputSchema>;
+/**
+ * Load a skill by name to access its instructions and resources
+ *
+ * This tool enables agents to autonomously load specialized knowledge
+ * and capabilities based on task context.
+ */
+export declare function loadSkill(input: LoadSkillInput, context: SkillContext): Promise<LoadSkillOutput>;
+/**
+ * Tool info for loadSkill (used in agent workflow)
+ */
+export declare const loadSkillToolInfo: {
+    readonly name: "loadSkill";
+    readonly description: "Load a skill by name to access its instructions and resources. Use this when you need specialized knowledge or capabilities for a specific task.";
+    readonly parameters: z.ZodObject<{
+        skillName: z.ZodString;
+    }, z.core.$strip>;
+    readonly returns: z.ZodObject<{
+        success: z.ZodBoolean;
+        skill: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            content: z.ZodString;
+            availableFiles: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+};