import type { Stats } from "node:fs";
import { type InstallSkillResult, type SkillScope } from "../packages/agent-skill-config/dist/index.js";
export interface InstallSkillFileSystem {
    readFile(path: string, encoding: BufferEncoding): Promise<string>;
    readFile(path: string): Promise<Buffer>;
    symlink(target: string, path: string): Promise<void>;
    readlink(path: string): Promise<string>;
    realpath(path: string): Promise<string>;
    writeFile(path: string, data: string | NodeJS.ArrayBufferView, options?: {
        encoding?: BufferEncoding;
        flag?: string;
    }): Promise<void>;
    mkdir(path: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    stat(path: string): Promise<Stats>;
    lstat(path: string): Promise<Stats>;
    rename(oldPath: string, newPath: string): Promise<void>;
    rm?(path: string, options?: {
        recursive?: boolean;
        force?: boolean;
    }): Promise<void>;
    unlink(path: string): Promise<void>;
    readdir(path: string): Promise<string[]>;
    copyFile?(src: string, dest: string): Promise<void>;
    chmod?(path: string, mode: number): Promise<void>;
}
export type InstallSkillSource = {
    name: string;
    content: string;
} | {
    name: string;
    file: string;
};
export interface InstallSkillOptions {
    cwd?: string;
    homeDir?: string;
    scope?: SkillScope;
    dryRun?: boolean;
    fs?: InstallSkillFileSystem;
}
/**
 * Install arbitrary skill content into an agent's native skill directory.
 *
 * The actual mutation and validation are delegated to poe-code's agent skill
 * configuration machinery, so SDK and CLI installs share the same safety rules.
 */
export declare function installSkill(agentId: string, source: InstallSkillSource, options?: InstallSkillOptions): Promise<InstallSkillResult>;
export type { InstallSkillResult, SkillScope };