import type { ToolResult } from "../types.js";
/**
 * List all skills in the `ai-assets` catalog, optionally filtered by domain.
 *
 * Walks every `<domain>/skills/` directory under the `ai-assets` root looking
 * for `SKILL.md` files.  Returns a JSON array of skill summaries
 * `{ id, name, description, source, version, keywords, domain }`.
 *
 * @param projectDir - Absolute path to the skaile project root.
 * @param domain     - Optional domain name filter (e.g. `"skaile-development"`).
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function skillList(projectDir: string, domain: string | undefined): Promise<ToolResult>;
/**
 * List all skill domains — the top-level directories under `ai-assets` that
 * contain a `skills/` subdirectory.
 *
 * Returns a JSON array of `{ name, path }` objects.
 *
 * @param projectDir - Absolute path to the skaile project root.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function skillListDomains(projectDir: string): Promise<ToolResult>;
/**
 * Show the full `SKILL.md` content for a skill.
 *
 * @param projectDir - Absolute path to the skaile project root.
 * @param skillId    - Skill ID (directory name) as returned by {@link skillList}.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function skillShow(projectDir: string, skillId: string): Promise<ToolResult>;
/**
 * Search skills by name, description, ID, or keywords.
 *
 * Case-insensitive substring match against all text fields in every skill
 * entry.  Returns the same summary shape as {@link skillList}.
 *
 * @param projectDir - Absolute path to the skaile project root.
 * @param query      - Search string.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function skillSearch(projectDir: string, query: string): Promise<ToolResult>;
/**
 * Validate that all prerequisites declared in a skill's `SKILL.md` are
 * satisfied in `targetDir`.
 *
 * Uses `@skaile/workspaces/resolver` to parse the `REQUIRES` / `READS` / `WRITES`
 * DSL and run the requirement checks against the filesystem.  Returns a
 * validation report as JSON.
 *
 * @param projectDir - Absolute path to the skaile project root (for skill lookup).
 * @param skillId    - Skill ID as returned by {@link skillList}.
 * @param targetDir  - Directory to validate against (typically the user's project).
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function skillCheckRequirements(projectDir: string, skillId: string, targetDir: string): Promise<ToolResult>;
/**
 * Get the formatted `REQUIRES`/`INPUT`/`READS`/`WRITES` DSL preamble for a skill.
 *
 * Uses `@skaile/workspaces/resolver` to build the requirements preamble that can be
 * prepended to the skill prompt for injection into the agent's context.
 * Returns `"(no requirements declared)"` when the skill has no requirements.
 *
 * @param projectDir - Absolute path to the skaile project root.
 * @param skillId    - Skill ID as returned by {@link skillList}.
 *
 * @docLink packages/workspace-plugin/concepts#tool-delivery
 */
export declare function skillGetPreamble(projectDir: string, skillId: string): Promise<ToolResult>;
//# sourceMappingURL=skills.d.ts.map