import { type TreeNode } from '../../utils/terminal/layout';
/** Default extension appended to a reference name that has no extension of its own. */
export declare const REFERENCE_FILE_EXT = ".md";
/** Options describing the reference to scaffold and where to write it. */
export interface GenerateReferenceOptions {
    /** The resolved reference filename, including its extension. */
    fileName: string;
    /** The name of the skill this reference belongs to. */
    skillName: string;
    /** Directory (relative to `cwd`) in which skills are stored. */
    skillsDir: string;
    /** The current working directory the reference is written under. */
    cwd: string;
}
/**
 * Creates a reference file scaffold inside a skill's references directory and returns its
 * file tree. Only a `.md` file gets a `# <stem>` markdown heading; any other extension is
 * scaffolded empty, since a markdown heading would be invalid content for e.g. a `.json`
 * or `.yaml` file.
 */
export declare function generateReference({ fileName, skillName, skillsDir, cwd, }: GenerateReferenceOptions): Promise<TreeNode>;