/**
 * Skill info - reads docs, requirements, and metadata from skill source
 */
import { type SkillMeta } from "./registry.js";
export interface SkillDocs {
    skillMd: string | null;
    readme: string | null;
    claudeMd: string | null;
}
export interface SkillRequirements {
    envVars: string[];
    systemDeps: string[];
    cliCommand: string | null;
    dependencies: Record<string, string>;
}
/**
 * Read documentation files from a skill
 */
export declare function getSkillDocs(name: string): SkillDocs | null;
/**
 * Get the best available documentation for a skill (SKILL.md > README.md > CLAUDE.md)
 */
export declare function getSkillBestDoc(name: string): string | null;
/**
 * Extract requirements from a skill's source files
 */
export declare function getSkillRequirements(name: string): SkillRequirements | null;
/**
 * Run a skill by name with given arguments
 */
export declare function runSkill(name: string, args: string[], options?: {
    installed?: boolean;
    stdio?: "inherit" | "pipe";
    env?: Record<string, string>;
}): Promise<{
    exitCode: number;
    error?: string;
    stdout?: string;
    stderr?: string;
}>;
export interface DetectedProjectSkills {
    detected: string[];
    recommended: SkillMeta[];
}
/**
 * Detect project type from package.json and recommend relevant skills
 */
export declare function detectProjectSkills(cwd?: string): DetectedProjectSkills;
/**
 * Generate a .env.example from pinned skills
 */
export declare function generateEnvExample(targetDir?: string): string;
/**
 * Generate a SKILL.md for a skill that doesn't have one.
 * Builds from registry metadata, README.md/CLAUDE.md content, and package.json info.
 */
export declare function generateSkillMd(name: string): string | null;