export interface FrontmatterValidationResult {
    valid: boolean;
    errors: string[];
    warnings: string[];
    /** Parsed frontmatter if valid. */
    parsed?: Record<string, string>;
}
/**
 * Validate SKILL.md content for required frontmatter structure.
 * Used before persisting agent-created skills.
 */
export declare function validateSkillContent(content: string, expectedName?: string): FrontmatterValidationResult;
/**
 * Generate valid SKILL.md content with proper frontmatter from minimal inputs.
 * Used when auto-persisting skills from skill_instruction events.
 */
export declare function generateSkillContent(params: {
    name: string;
    description: string;
    tools?: string[];
    body: string;
    version?: string;
    category?: string;
}): string;
/**
 * Auto-fix common frontmatter issues in LLM-generated skill content.
 * Returns fixed content or null if unfixable.
 */
export declare function autoFixFrontmatter(content: string, name: string, description?: string): string | null;
