/** A skill that ships in the package, under `skills/<name>/SKILL.md`. */
export type ShippedSkill = {
    name: string;
    description: string;
    /** The file's text, frontmatter included. */
    text: string;
    /** The text after the frontmatter. */
    body: string;
};
/** The start of a line `install` puts in every file it writes. A file
 *  without it was written by someone else, so `install` leaves it alone.
 *  Never change this text: files written by older versions are recognized
 *  by it. The rest of the line can change. */
export declare const INSTALL_MARKER_PREFIX = "<!-- Written by `agency skills install`.";
export type InstallTargetFlags = {
    claude?: boolean;
    project?: boolean;
    dir?: string;
};
export type Outcome = {
    ok: true;
    text: string;
} | {
    ok: false;
    text: string;
};
/** Where the skills live: in the repo and in an npm install alike, they
 *  sit at the package root, next to `package.json`. */
export declare function shippedSkillsDir(): string;
/**
 * Every skill in `dir`, sorted by name. A folder without a SKILL.md is
 * skipped. A SKILL.md whose frontmatter has no description, or names a
 * different skill than its folder, is a packaging mistake, so it throws.
 */
export declare function listSkills(dir?: string): ShippedSkill[];
export declare function renderSkillList(skills: ShippedSkill[]): string;
/** Looks up each name, or says which ones are unknown and what exists. */
export declare function findSkills(names: string[], skills: ShippedSkill[]): {
    ok: true;
    found: ShippedSkill[];
} | {
    ok: false;
    text: string;
};
/**
 * What `install` writes: the frontmatter and a line telling the agent to
 * run `agency skills show`, or with `full`, the whole skill. See
 * docs/dev/cli/skills-command.md for why the stub is the default.
 *
 * The description is written as a JSON string, which is also a valid YAML
 * string, so a colon or quote in it cannot break another agent's parser.
 */
export declare function renderInstalledFile(skill: ShippedSkill, full: boolean): string;
/** Turns the target flags into one directory. Exactly one flag must be set. */
export declare function resolveInstallDir(flags: InstallTargetFlags, homeDir?: string, cwd?: string): {
    ok: true;
    dir: string;
} | {
    ok: false;
    text: string;
};
/**
 * Writes `<dir>/<name>/SKILL.md`. It refuses a symlink at the skill's
 * folder or file, and refuses to overwrite a file that does not carry
 * the install marker, since someone else wrote that one.
 */
export declare function installSkill(skill: ShippedSkill, dir: string, full: boolean): Outcome;
/**
 * `agency skills install`. It checks the target flags, every name, and
 * every skill's target before writing anything, and reports every refusal
 * at once, so a refusal never leaves some skills installed and others not.
 */
export declare function runInstall(names: string[], flags: InstallTargetFlags & {
    full?: boolean;
}, skills?: ShippedSkill[]): Outcome;