/**
 * Skill File Parser
 *
 * Parses agent instruction files from 8 different AI frameworks into a common
 * format for scanning. Supports SKILL.md, HOOK.md, handler.js, .cursorrules,
 * .windsurfrules, .clinerules, CLAUDE.md, copilot-instructions.md,
 * .aider.conf.yml, and .continue/config.json.
 *
 * The parser never throws — malformed input produces sensible defaults.
 */
export type SkillFormat = 'skill-md' | 'hook-md' | 'hook-js' | 'rules' | 'claude-md' | 'copilot-md' | 'aider-yml' | 'continue-json' | 'unknown';
export interface ParsedSkill {
    /** Extracted from metadata or filename */
    name: string;
    /** Auto-detected format */
    format: SkillFormat;
    /** The text content to scan (body only, no frontmatter) */
    content: string;
    /** YAML/JSON frontmatter if present */
    metadata?: Record<string, unknown>;
    /** Original file contents */
    raw: string;
    /** Source path if read from disc */
    filePath?: string;
}
/**
 * Auto-detect the skill format based on the file path.
 * Uses basename for filename matching; case-insensitive for .md files.
 */
export declare function detectFormat(filePath: string): SkillFormat;
/**
 * Auto-detect the skill format based on the content itself (no file path).
 * Used when pasting content in the cloud dashboard with "Auto-detect" selected.
 */
export declare function detectFormatFromContent(content: string): SkillFormat;
/**
 * Parse file content into a ParsedSkill structure.
 *
 * @param content  Raw file content
 * @param format   Detected format (defaults to auto-detected from content)
 */
export declare function parseSkillFile(content: string, format?: SkillFormat): ParsedSkill;
/**
 * Read a skill file from disc, auto-detect its format, and parse it.
 *
 * Returns a ParsedSkill with the filePath field populated.
 * If the file cannot be read, returns a minimal ParsedSkill with empty content.
 */
export declare function readSkillFile(filePath: string): ParsedSkill;
