import type { SkillSource } from "./types.js";
export interface LocateOptions {
    /** Working directory to use as the project root (defaults to process.cwd()). */
    cwd?: string;
    /** Home directory (defaults to os.homedir() — explicit for testability). */
    home: string;
}
/**
 * Split a source identifier like "sw/ado-mapper" into namespace + skill, or
 * return only the skill when no namespace is present.
 */
export declare function parseSourceIdent(source: string): {
    namespace?: string;
    skill: string;
};
/**
 * Discover a skill across project / personal / cache. Returns every match in
 * search order — the orchestrator handles disambiguation when there is more
 * than one and `--source` was not explicitly provided.
 */
export declare function locateSkill(source: string, opts: LocateOptions): Promise<SkillSource[]>;
/**
 * Enumerate every skill inside a cached plugin. Used by the whole-plugin
 * clone path (T-010). Returns a list of SkillSource entries (one per skill).
 */
export declare function enumeratePluginSkills(pluginName: string, opts: LocateOptions): Promise<SkillSource[]>;