/**
 * The frontmatter fields stored in each app skill fact file.
 */
export type ParsedSkillFileFrontmatter = {
    name: string;
    description: string;
    /**
     * "always"    — injected into every system prompt automatically.
     * "on_demand" — only injected when Clark explicitly retrieves it (default for new facts).
     */
    accessType: "always" | "on_demand";
    isEnabled: boolean;
    createdAt?: string;
};
/**
 * A parsed app skill fact: frontmatter + body content.
 */
export type ParsedSkillFile = ParsedSkillFileFrontmatter & {
    /** The markdown body below the frontmatter */
    content: string;
};
/**
 * A loaded app skill fact with its disk path.
 */
export type AppSkillFact = ParsedSkillFile & {
    path: string;
};
/**
 * Parse a markdown file that has YAML frontmatter.
 *
 * Expected format:
 * ```
 * ---
 * name: "..."
 * description: "..."
 * accessType: always
 * isEnabled: true
 * createdAt: "..."
 * ---
 *
 * The body content goes here.
 * ```
 */
export declare function parseSkillFile(raw: string): ParsedSkillFile | null;
/**
 * Serialize a skill fact back to a markdown file string with YAML frontmatter.
 */
export declare function serializeSkillFile(fact: ParsedSkillFile): string;
/**
 * Convert a fact name to a safe file name (kebab-case, no special chars).
 */
export declare function factNameToFileName(name: string): string;
//# sourceMappingURL=parser.d.ts.map