import type { ResourceDiagnostic } from "./diagnostics.js";
/**
 * The standard ecosystem skills directory used by skills.sh and the
 * Agent Skills standard.  All agents share this location for globally
 * installed skills.
 */
export declare const ECOSYSTEM_SKILLS_DIR: string;
/**
 * The standard project-level skills directory (`.agents/skills/` relative to cwd).
 */
export declare const ECOSYSTEM_PROJECT_SKILLS_DIR = ".agents";
export interface SkillFrontmatter {
    name?: string;
    description?: string;
    "disable-model-invocation"?: boolean;
    [key: string]: unknown;
}
export interface Skill {
    name: string;
    description: string;
    filePath: string;
    baseDir: string;
    source: string;
    disableModelInvocation: boolean;
}
export interface LoadSkillsResult {
    skills: Skill[];
    diagnostics: ResourceDiagnostic[];
}
export declare function getLoadedSkills(): Skill[];
export interface LoadSkillsFromDirOptions {
    /** Directory to scan for skills */
    dir: string;
    /** Source identifier for these skills */
    source: string;
}
/**
 * Load skills from a directory.
 *
 * Discovery rules:
 * - direct .md children in the root
 * - recursive SKILL.md under subdirectories
 */
export declare function loadSkillsFromDir(options: LoadSkillsFromDirOptions): LoadSkillsResult;
/**
 * Format skills for inclusion in a system prompt.
 * Uses XML format per Agent Skills standard.
 * See: https://agentskills.io/integrate-skills
 *
 * Skills with disableModelInvocation=true are excluded from the prompt
 * (they can only be invoked explicitly via /skill:name commands).
 */
export declare function formatSkillsForPrompt(skills: Skill[]): string;
export interface LoadSkillsOptions {
    /** Working directory for project-local skills. Default: process.cwd() */
    cwd?: string;
    /** @deprecated Skills now use ~/.agents/skills/ exclusively. This option is ignored. */
    agentDir?: string;
    /** Explicit skill paths (files or directories) */
    skillPaths?: string[];
    /** Include default skills directories. Default: true */
    includeDefaults?: boolean;
}
/**
 * Load skills from all configured locations.
 * Returns skills and any validation diagnostics.
 */
export declare function loadSkills(options?: LoadSkillsOptions): LoadSkillsResult;
//# sourceMappingURL=skills.d.ts.map