import type { AgentDefinition } from "../agents/agents-registry.js";
/**
 * Find the directory containing core SpecWeave skills (sw:* plugin).
 *
 * Search order:
 * 1. Claude Code plugin cache: ~/.claude/plugins/cache/specweave/sw/{version}/skills/
 * 2. Bundled with vskill package: {packageDir}/../skills/ (for npm distribution)
 */
export declare function findCoreSkillsDir(): string | null;
/**
 * List all core skill names available at the given source directory.
 */
export declare function listCoreSkills(sourceDir: string): string[];
/**
 * Sync core SpecWeave skills to detected agents.
 *
 * Writes to .agents/skills/sw/{skill}/ (canonical source) and creates
 * symlinks from each agent's localSkillsDir (e.g. .opencode/skills/sw/{skill}/).
 *
 * Claude Code is included because it reads project-local .claude/skills/ too,
 * and the plugin cache is only available when Claude Code CLI is installed.
 *
 * Returns the number of skills synced.
 */
export declare function syncCoreSkills(agents: AgentDefinition[], projectRoot: string, coreSkillsDir: string): number;