import { type SkillsMap } from '@levelcode/common/types/skill';
export { formatAvailableSkillsXml } from '@levelcode/common/util/skills';
export type LoadSkillsOptions = {
    /** Working directory for project skills. Defaults to process.cwd() */
    cwd?: string;
    /** Optional specific skills directory path */
    skillsPath?: string;
    /** Whether to log errors during loading */
    verbose?: boolean;
};
/**
 * Load skills from .agents/skills and .claude/skills directories.
 *
 * By default, searches for skills in (later overrides earlier):
 * - `~/.claude/skills/` (global, Claude Code compatible)
 * - `~/.agents/skills/` (global)
 * - `{cwd}/.claude/skills/` (project, Claude Code compatible)
 * - `{cwd}/.agents/skills/` (project, highest priority)
 *
 * Each skill must be in its own directory with a SKILL.md file:
 * - `.agents/skills/my-skill/SKILL.md`
 * - `.claude/skills/my-skill/SKILL.md`
 *
 * @param options.cwd - Working directory for project skills
 * @param options.skillsPath - Optional path to a specific skills directory
 * @param options.verbose - Whether to log errors during loading
 * @returns Record of skill definitions keyed by skill name
 *
 * @example
 * ```typescript
 * // Load from default locations
 * const skills = await loadSkills({ verbose: true })
 *
 * // Load from a specific directory
 * const skills = await loadSkills({ skillsPath: './my-skills' })
 *
 * // Access a skill
 * const gitReleaseSkill = skills['git-release']
 * console.log(gitReleaseSkill.description)
 * ```
 */
export declare function loadSkills(options?: LoadSkillsOptions): Promise<SkillsMap>;
