/**
 * Skill content file module for SKILL.md parsing and frontmatter schemas.
 *
 * Defines the frontmatter schema for SKILL.md files and a parser that
 * combines the shared frontmatter utility with skill-specific validation.
 *
 * @experimental This API is unstable and may change without notice.
 */
import * as Option from "effect/Option";
import * as Schema from "effect/Schema";
import type { Skill } from "./types.js";
/**
 * Schema for SKILL.md frontmatter fields.
 *
 * @experimental This API is unstable and may change without notice.
 */
export declare const SkillFrontmatterSchema: Schema.Struct<{
    readonly name: Schema.String;
    readonly description: Schema.String;
    readonly license: Schema.optionalKey<Schema.String>;
    readonly compatibility: Schema.optionalKey<Schema.String>;
    readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
    readonly "allowed-tools": Schema.optionalKey<Schema.String>;
}>;
export type SkillFrontmatter = Schema.Schema.Type<typeof SkillFrontmatterSchema>;
export type SkillFrontmatterValidation = {
    readonly valid: true;
    readonly frontmatter: SkillFrontmatter;
} | {
    readonly valid: false;
    readonly errors: ReadonlyArray<string>;
};
/** Validate parsed YAML against the pinned Agent Skills metadata contract. */
export declare const validateSkillFrontmatter: (input: unknown, expectedDirectoryName?: string) => SkillFrontmatterValidation;
/**
 * Parse a SKILL.md file's content and extract skill metadata from frontmatter.
 *
 * Returns `Option.some(Skill)` when the file has valid YAML frontmatter with
 * non-empty `name` and `description` fields. Returns `Option.none()` for any
 * invalid input: missing frontmatter, invalid YAML, or missing/empty required fields.
 */
export declare const parseSkillMd: (content: string, expectedDirectoryName?: string) => Option.Option<Skill>;
//# sourceMappingURL=skill-content.d.ts.map