import { type SkillFile, type SkillScope } from "../../../packages/agent-skill-config/dist/index.js";
import type { CliContainer } from "../container.js";
import type { ScopedLogger } from "../logger.js";
export type SkillInstallOutcome = "created" | "overwritten" | "skipped";
export interface InstallSkillFileOptions {
    container: CliContainer;
    logger: ScopedLogger;
    agentId: string;
    skill: SkillFile;
    scope: SkillScope;
    force: boolean;
    dryRun: boolean;
}
/**
 * Install a skill for an install command under one shared policy: an existing
 * SKILL.md is skipped rather than treated as an error, --force overwrites it,
 * and a forced overwrite is always preceded by a diff of what is replaced.
 */
export declare function installSkillFile(options: InstallSkillFileOptions): Promise<SkillInstallOutcome>;