import { Command, type OptionValues } from 'commander';
/** Builds the error message shown when the provided reference name contains invalid characters */
export declare const INVALID_REFERENCE_NAME: (name: string) => string;
/** Outcome of validating a candidate reference name. */
type ReferenceNameValidation = {
    valid: true;
    fileName: string;
} | {
    valid: false;
    message: string;
};
/** Create the `add-reference` subcommand for the `skill` domain command */
export declare function addReferenceCommand(): Command;
/** Creates a new AI skill reference file */
export declare function createReference(program: OptionValues): Promise<void>;
/**
 * Validates a candidate reference name against the filename-level naming rules and resolves
 * it to the filename to write to disk. The name is only the name: references are always
 * created as markdown, so {@link REFERENCE_FILE_EXT} is appended to whatever was typed -
 * `some.other` becomes `some.other.md` and `some.json` becomes `some.json.md`. A name that
 * already ends in `.md` is left as it is rather than doubling the extension.
 */
export declare function validateReferenceName(candidate: string): ReferenceNameValidation;
export {};