export type AgentId = "codex" | "claude";
export type Scope = "project" | "user";
type Command = "add" | "list" | "help";
type InstructionTarget = "agents" | "claude";
export declare const MANAGED_BLOCK_START = "<!-- BEGIN @agent-native/skills managed block -->";
export declare const MANAGED_BLOCK_END = "<!-- END @agent-native/skills managed block -->";
export declare const HELP = "skills\n\nUsage:\n  skills list <source> [--json]\n  skills add <source> [--skill <name> ...|--all] [--agent codex|claude|all] [--scope user|project] [--project <dir>] [--instructions agents|claude|both] [--yes] [--force] [--dry-run] [--json]\n\nSources:\n  ./skills\n  ./skills/my-skill\n  owner/repo\n  owner/repo/path/to/skills#ref\n  github:owner/repo/path/to/skills#ref\n  https://github.com/owner/repo/tree/ref/path/to/skills\n\nTargets:\n  project codex  -> <project>/.agents/skills\n  project claude -> <project>/.claude/skills\n  user codex     -> $CODEX_HOME/skills or ~/.codex/skills\n  user claude    -> ~/.claude/skills\n\nOptions:\n  -s, --skill <name>        Install one skill. Repeat or comma-separate.\n      --all                 Install every discovered skill.\n  -a, --agent <target>      codex, claude, or all. Defaults to codex.\n      --scope <scope>       user or project. Defaults to user.\n      --project <dir>       Project root for project-scoped installs.\n      --ref <git-ref>       Git ref for GitHub-style sources.\n      --instructions <set>  agents, claude, both/all, or none.\n      --with-agents-md      Append/update the AGENTS.md managed block.\n      --with-claude-md      Append/update the CLAUDE.md managed block.\n      --agents-file <path>  Override the AGENTS.md path.\n      --claude-file <path>  Override the CLAUDE.md path.\n  -y, --yes                 Accept prompts.\n      --force               Overwrite existing skill folders.\n      --dry-run             Print what would change.\n      --json                Print machine-readable output.";
export interface ParsedSkillsCliArgs {
    command: Command;
    source?: string;
    skills: string[];
    all: boolean;
    agents: AgentId[];
    scope: Scope;
    projectDir: string;
    ref?: string;
    instructionTargets: InstructionTarget[];
    agentsFile: string;
    claudeFile: string;
    yes: boolean;
    force: boolean;
    dryRun: boolean;
    json: boolean;
}
export interface DiscoveredSkill {
    name: string;
    dir: string;
    description?: string;
}
export interface GitHubSource {
    cloneUrl: string;
    ref?: string;
    subdir: string;
    display: string;
}
interface TargetRoot {
    agent: AgentId;
    scope: Scope;
    root: string;
}
interface CopiedSkill {
    skillName: string;
    agent: AgentId;
    scope: Scope;
    from: string;
    to: string;
}
export interface InstallResult {
    source: string;
    dryRun: boolean;
    skills: string[];
    copied: CopiedSkill[];
    instructionFiles: string[];
}
interface RunCommandOptions {
    cwd?: string;
}
export interface RunSkillsCliOptions {
    cwd?: string;
    env?: NodeJS.ProcessEnv;
    isInteractive?: () => boolean;
    log?: (message: string) => void;
    promptSkills?: (skills: DiscoveredSkill[]) => Promise<string[] | null>;
    promptOverwrite?: (paths: string[]) => Promise<boolean>;
    runCommand?: (cmd: string, args: string[], options?: RunCommandOptions) => Promise<number>;
}
export declare function parseSkillsCliArgs(argv: string[], cwd?: string): ParsedSkillsCliArgs;
export declare function parseGitHubSource(input: string, ref?: string): GitHubSource | null;
export declare function discoverSkillFolders(root: string): DiscoveredSkill[];
export declare function targetRootsFor(input: {
    agents: AgentId[];
    scope: Scope;
    projectDir: string;
    env?: NodeJS.ProcessEnv;
}): TargetRoot[];
export declare function upsertManagedBlock(file: string, block: string, dryRun?: boolean): boolean;
export declare function installSkills(parsed: ParsedSkillsCliArgs, options?: RunSkillsCliOptions): Promise<InstallResult>;
export declare function runSkillsCli(argv: string[], options?: RunSkillsCliOptions): Promise<void>;
export {};
//# sourceMappingURL=install.d.ts.map