import type { Command } from './command';
import type { GroupsType } from './command-groups';
export type GenerateOpts = {
    metadata?: Record<string, string>;
};
type CommandObject = ReturnType<typeof oneCommandToObject> & {
    commands?: any;
};
export declare class GenerateCommandsDoc {
    private commands;
    private options;
    private groups;
    constructor(commands: Command[], options: GenerateOpts, groups?: GroupsType);
    generate(): string;
    generateJson(): CommandObject[];
    /**
     * Generate command list in the style of `bit --help` but without chalk colors.
     * For use in Claude Code skills.
     */
    generateSkillCommands(): string;
    /**
     * Generate command reference with subcommands, arguments, and flags.
     * For use in Claude Code skills.
     */
    generateSkillReference(): string;
    private collectSkillCommandSections;
    private groupCommandsByGroup;
    private commandsToObjects;
    private getFrontmatter;
    private getAllPublicCommandsSorted;
    private generateCommand;
    private generateSubCommands;
    private generateArguments;
    private generateOptions;
    private formatStringToMD;
    private formatDescription;
}
declare function oneCommandToObject(command: Command): Partial<Command>;
export {};