import { type ToolName } from "./tool-name.js";
export declare class SkillLoadError extends Error {
    constructor(message: string);
}
export interface SkillMeta {
    name: string;
    description: string;
    /** Parsed `allowed-tools` frontmatter, when present and well-formed. */
    allowedTools?: ToolName[];
    [key: string]: unknown;
}
export interface MarkdownFrontmatter {
    meta: Record<string, unknown>;
    body: string;
    raw: string;
}
export interface LoadMarkdownFrontmatterOptions {
    fileDescription?: string;
}
export interface LoadSkillMdOptions {
    /** Called for parser warnings (unknown allowed-tools tokens, etc.) */
    onWarning?: (message: string) => void;
}
/**
 * Parse a SKILL.md file and extract YAML frontmatter.
 * Returns the parsed metadata (name, description, plus any extra fields).
 */
export declare function loadSkillMd(filePath: string, opts?: LoadSkillMdOptions): Promise<SkillMeta>;
/**
 * Parse a Markdown file and extract YAML frontmatter plus body content.
 */
export declare function loadMarkdownFrontmatter(filePath: string, opts?: LoadMarkdownFrontmatterOptions): Promise<MarkdownFrontmatter>;
export declare function parseMarkdownFrontmatterContent(content: string, filePath: string): MarkdownFrontmatter;
//# sourceMappingURL=loader.d.ts.map