skillkit 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -1,567 +1,3 @@
-import { z } from 'zod';
-
-declare const AgentType: z.ZodEnum<["claude-code", "codex", "cursor", "antigravity", "opencode", "gemini-cli", "amp", "clawdbot", "droid", "github-copilot", "goose", "kilo", "kiro-cli", "roo", "trae", "windsurf", "universal"]>;
-type AgentType = z.infer<typeof AgentType>;
-declare const GitProvider: z.ZodEnum<["github", "gitlab", "bitbucket", "local"]>;
-type GitProvider = z.infer<typeof GitProvider>;
-declare const SkillFrontmatter: z.ZodObject<{
-    name: z.ZodString;
-    description: z.ZodString;
-    license: z.ZodOptional<z.ZodString>;
-    compatibility: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    'allowed-tools': z.ZodOptional<z.ZodString>;
-    version: z.ZodOptional<z.ZodString>;
-    author: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    agents: z.ZodOptional<z.ZodArray<z.ZodEnum<["claude-code", "codex", "cursor", "antigravity", "opencode", "gemini-cli", "amp", "clawdbot", "droid", "github-copilot", "goose", "kilo", "kiro-cli", "roo", "trae", "windsurf", "universal"]>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    description: string;
-    license?: string | undefined;
-    compatibility?: string | undefined;
-    metadata?: Record<string, string> | undefined;
-    'allowed-tools'?: string | undefined;
-    version?: string | undefined;
-    author?: string | undefined;
-    tags?: string[] | undefined;
-    agents?: ("claude-code" | "codex" | "cursor" | "antigravity" | "opencode" | "gemini-cli" | "amp" | "clawdbot" | "droid" | "github-copilot" | "goose" | "kilo" | "kiro-cli" | "roo" | "trae" | "windsurf" | "universal")[] | undefined;
-}, {
-    name: string;
-    description: string;
-    license?: string | undefined;
-    compatibility?: string | undefined;
-    metadata?: Record<string, string> | undefined;
-    'allowed-tools'?: string | undefined;
-    version?: string | undefined;
-    author?: string | undefined;
-    tags?: string[] | undefined;
-    agents?: ("claude-code" | "codex" | "cursor" | "antigravity" | "opencode" | "gemini-cli" | "amp" | "clawdbot" | "droid" | "github-copilot" | "goose" | "kilo" | "kiro-cli" | "roo" | "trae" | "windsurf" | "universal")[] | undefined;
-}>;
-type SkillFrontmatter = z.infer<typeof SkillFrontmatter>;
-declare const SkillMetadata: z.ZodObject<{
-    name: z.ZodString;
-    description: z.ZodString;
-    source: z.ZodString;
-    sourceType: z.ZodEnum<["github", "gitlab", "bitbucket", "local"]>;
-    subpath: z.ZodOptional<z.ZodString>;
-    installedAt: z.ZodString;
-    updatedAt: z.ZodOptional<z.ZodString>;
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    version: z.ZodOptional<z.ZodString>;
-    checksum: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    description: string;
-    source: string;
-    sourceType: "github" | "gitlab" | "bitbucket" | "local";
-    installedAt: string;
-    enabled: boolean;
-    version?: string | undefined;
-    subpath?: string | undefined;
-    updatedAt?: string | undefined;
-    checksum?: string | undefined;
-}, {
-    name: string;
-    description: string;
-    source: string;
-    sourceType: "github" | "gitlab" | "bitbucket" | "local";
-    installedAt: string;
-    version?: string | undefined;
-    subpath?: string | undefined;
-    updatedAt?: string | undefined;
-    enabled?: boolean | undefined;
-    checksum?: string | undefined;
-}>;
-type SkillMetadata = z.infer<typeof SkillMetadata>;
-declare const SkillLocation: z.ZodEnum<["project", "global"]>;
-type SkillLocation = z.infer<typeof SkillLocation>;
-declare const Skill: z.ZodObject<{
-    name: z.ZodString;
-    description: z.ZodString;
-    path: z.ZodString;
-    location: z.ZodEnum<["project", "global"]>;
-    metadata: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodString;
-        source: z.ZodString;
-        sourceType: z.ZodEnum<["github", "gitlab", "bitbucket", "local"]>;
-        subpath: z.ZodOptional<z.ZodString>;
-        installedAt: z.ZodString;
-        updatedAt: z.ZodOptional<z.ZodString>;
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        version: z.ZodOptional<z.ZodString>;
-        checksum: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        description: string;
-        source: string;
-        sourceType: "github" | "gitlab" | "bitbucket" | "local";
-        installedAt: string;
-        enabled: boolean;
-        version?: string | undefined;
-        subpath?: string | undefined;
-        updatedAt?: string | undefined;
-        checksum?: string | undefined;
-    }, {
-        name: string;
-        description: string;
-        source: string;
-        sourceType: "github" | "gitlab" | "bitbucket" | "local";
-        installedAt: string;
-        version?: string | undefined;
-        subpath?: string | undefined;
-        updatedAt?: string | undefined;
-        enabled?: boolean | undefined;
-        checksum?: string | undefined;
-    }>>;
-    enabled: z.ZodDefault<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    name: string;
-    description: string;
-    enabled: boolean;
-    location: "project" | "global";
-    metadata?: {
-        name: string;
-        description: string;
-        source: string;
-        sourceType: "github" | "gitlab" | "bitbucket" | "local";
-        installedAt: string;
-        enabled: boolean;
-        version?: string | undefined;
-        subpath?: string | undefined;
-        updatedAt?: string | undefined;
-        checksum?: string | undefined;
-    } | undefined;
-}, {
-    path: string;
-    name: string;
-    description: string;
-    location: "project" | "global";
-    metadata?: {
-        name: string;
-        description: string;
-        source: string;
-        sourceType: "github" | "gitlab" | "bitbucket" | "local";
-        installedAt: string;
-        version?: string | undefined;
-        subpath?: string | undefined;
-        updatedAt?: string | undefined;
-        enabled?: boolean | undefined;
-        checksum?: string | undefined;
-    } | undefined;
-    enabled?: boolean | undefined;
-}>;
-type Skill = z.infer<typeof Skill>;
-declare const SkillkitConfig: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    agent: z.ZodDefault<z.ZodEnum<["claude-code", "codex", "cursor", "antigravity", "opencode", "gemini-cli", "amp", "clawdbot", "droid", "github-copilot", "goose", "kilo", "kiro-cli", "roo", "trae", "windsurf", "universal"]>>;
-    skillsDir: z.ZodOptional<z.ZodString>;
-    enabledSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    disabledSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    autoSync: z.ZodDefault<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    version: 1;
-    agent: "claude-code" | "codex" | "cursor" | "antigravity" | "opencode" | "gemini-cli" | "amp" | "clawdbot" | "droid" | "github-copilot" | "goose" | "kilo" | "kiro-cli" | "roo" | "trae" | "windsurf" | "universal";
-    autoSync: boolean;
-    skillsDir?: string | undefined;
-    enabledSkills?: string[] | undefined;
-    disabledSkills?: string[] | undefined;
-}, {
-    version: 1;
-    agent?: "claude-code" | "codex" | "cursor" | "antigravity" | "opencode" | "gemini-cli" | "amp" | "clawdbot" | "droid" | "github-copilot" | "goose" | "kilo" | "kiro-cli" | "roo" | "trae" | "windsurf" | "universal" | undefined;
-    skillsDir?: string | undefined;
-    enabledSkills?: string[] | undefined;
-    disabledSkills?: string[] | undefined;
-    autoSync?: boolean | undefined;
-}>;
-type SkillkitConfig = z.infer<typeof SkillkitConfig>;
-interface InstallOptions {
-    global?: boolean;
-    skills?: string[];
-    provider?: GitProvider;
-    yes?: boolean;
-    force?: boolean;
-}
-interface SyncOptions {
-    output?: string;
-    agent?: AgentType;
-    yes?: boolean;
-    enabledOnly?: boolean;
-}
-interface UpdateOptions {
-    skills?: string[];
-    all?: boolean;
-    force?: boolean;
-}
-interface RegistrySkill {
-    name: string;
-    description: string;
-    source: string;
-    provider: GitProvider;
-    downloads?: number;
-    stars?: number;
-    tags?: string[];
-}
-interface DiscoveredSkill {
-    name: string;
-    dirName: string;
-    path: string;
-}
-interface CloneResult {
-    success: boolean;
-    path?: string;
-    tempRoot?: string;
-    error?: string;
-    skills?: string[];
-    discoveredSkills?: DiscoveredSkill[];
-}
-interface CommandResult {
-    success: boolean;
-    message: string;
-    data?: unknown;
-}
-
-declare const SKILL_DISCOVERY_PATHS: string[];
-declare function discoverSkills(rootDir: string): Skill[];
-declare function parseSkill(skillPath: string, location?: SkillLocation): Skill | null;
-declare function extractFrontmatter(content: string): Record<string, unknown> | null;
-declare function extractField(content: string, field: string): string | null;
-declare function loadMetadata(skillPath: string): SkillMetadata | null;
-declare function readSkillContent(skillPath: string): string | null;
-declare function findSkill(name: string, searchDirs: string[]): Skill | null;
-declare function findAllSkills(searchDirs: string[]): Skill[];
-declare function validateSkill(skillPath: string): {
-    valid: boolean;
-    errors: string[];
-    warnings?: string[];
-};
-declare function isPathInside(child: string, parent: string): boolean;
-
-declare function getProjectConfigPath(): string;
-declare function getGlobalConfigPath(): string;
-declare function loadConfig(): SkillkitConfig;
-declare function saveConfig(config: SkillkitConfig, global?: boolean): void;
-declare function getSearchDirs(agentType?: AgentType): string[];
-declare function getInstallDir(global?: boolean, agentType?: AgentType): string;
-declare function getAgentConfigPath(agentType?: AgentType): string;
-declare function saveSkillMetadata(skillPath: string, metadata: SkillMetadata): void;
-declare function loadSkillMetadata(skillPath: string): SkillMetadata | null;
-declare function setSkillEnabled(skillPath: string, enabled: boolean): boolean;
-declare function initProject(agentType?: AgentType): Promise<void>;
-
-interface AgentAdapter {
-    readonly type: AgentType;
-    readonly name: string;
-    readonly skillsDir: string;
-    readonly configFile: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-declare function createSkillXml(skill: Skill): string;
-declare function escapeXml(text: string): string;
-
-declare class ClaudeCodeAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Claude Code";
-    readonly skillsDir = ".claude/skills";
-    readonly configFile = "AGENTS.md";
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class CursorAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Cursor";
-    readonly skillsDir = ".cursor/skills";
-    readonly configFile = ".cursorrules";
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class CodexAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "OpenAI Codex CLI";
-    readonly skillsDir = ".codex/skills";
-    readonly configFile = "AGENTS.md";
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class GeminiCliAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Gemini CLI";
-    readonly skillsDir = ".gemini/skills";
-    readonly configFile = "GEMINI.md";
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class OpenCodeAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "OpenCode";
-    readonly skillsDir = ".opencode/skills";
-    readonly configFile = "AGENTS.md";
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class AntigravityAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Antigravity";
-    readonly skillsDir = ".antigravity/skills";
-    readonly configFile = "AGENTS.md";
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class AmpAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Amp";
-    readonly skillsDir = ".agents/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class ClawdbotAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Clawdbot";
-    readonly skillsDir = "skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class DroidAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Droid (Factory)";
-    readonly skillsDir = ".factory/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class GitHubCopilotAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "GitHub Copilot";
-    readonly skillsDir = ".github/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class GooseAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Goose";
-    readonly skillsDir = ".goose/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class KiloAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Kilo Code";
-    readonly skillsDir = ".kilocode/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class KiroCliAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Kiro CLI";
-    readonly skillsDir = ".kiro/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class RooAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Roo Code";
-    readonly skillsDir = ".roo/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class TraeAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Trae";
-    readonly skillsDir = ".trae/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class WindsurfAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Windsurf";
-    readonly skillsDir = ".windsurf/skills";
-    readonly configFile = "AGENTS.md";
-    readonly globalSkillsDir: string;
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare class UniversalAdapter implements AgentAdapter {
-    readonly type: AgentType;
-    readonly name = "Universal (Any Agent)";
-    readonly skillsDir = ".agent/skills";
-    readonly configFile = "AGENTS.md";
-    generateConfig(skills: Skill[]): string;
-    parseConfig(content: string): string[];
-    getInvokeCommand(skillName: string): string;
-    isDetected(): Promise<boolean>;
-}
-
-declare function getAdapter(type: AgentType): AgentAdapter;
-declare function getAllAdapters(): AgentAdapter[];
-declare function detectAgent(): Promise<AgentType>;
-declare function getSkillsDir(type: AgentType): string;
-declare function getConfigFile(type: AgentType): string;
-
-interface GitProviderAdapter {
-    readonly type: GitProvider;
-    readonly name: string;
-    readonly baseUrl: string;
-    parseSource(source: string): {
-        owner: string;
-        repo: string;
-        subpath?: string;
-    } | null;
-    matches(source: string): boolean;
-    getCloneUrl(owner: string, repo: string): string;
-    getSshUrl(owner: string, repo: string): string;
-    clone(source: string, targetDir: string, options?: CloneOptions): Promise<CloneResult>;
-}
-interface CloneOptions {
-    depth?: number;
-    branch?: string;
-    ssh?: boolean;
-}
-declare function parseShorthand(source: string): {
-    owner: string;
-    repo: string;
-    subpath?: string;
-} | null;
-declare function isLocalPath(source: string): boolean;
-declare function isGitUrl(source: string): boolean;
-
-declare class GitHubProvider implements GitProviderAdapter {
-    readonly type: GitProvider;
-    readonly name = "GitHub";
-    readonly baseUrl = "https://github.com";
-    parseSource(source: string): {
-        owner: string;
-        repo: string;
-        subpath?: string;
-    } | null;
-    matches(source: string): boolean;
-    getCloneUrl(owner: string, repo: string): string;
-    getSshUrl(owner: string, repo: string): string;
-    clone(source: string, _targetDir: string, options?: CloneOptions): Promise<CloneResult>;
-}
-
-declare class GitLabProvider implements GitProviderAdapter {
-    readonly type: GitProvider;
-    readonly name = "GitLab";
-    readonly baseUrl = "https://gitlab.com";
-    parseSource(source: string): {
-        owner: string;
-        repo: string;
-        subpath?: string;
-    } | null;
-    matches(source: string): boolean;
-    getCloneUrl(owner: string, repo: string): string;
-    getSshUrl(owner: string, repo: string): string;
-    clone(source: string, _targetDir: string, options?: CloneOptions): Promise<CloneResult>;
-}
-
-declare class BitbucketProvider implements GitProviderAdapter {
-    readonly type: GitProvider;
-    readonly name = "Bitbucket";
-    readonly baseUrl = "https://bitbucket.org";
-    parseSource(source: string): {
-        owner: string;
-        repo: string;
-        subpath?: string;
-    } | null;
-    matches(source: string): boolean;
-    getCloneUrl(owner: string, repo: string): string;
-    getSshUrl(owner: string, repo: string): string;
-    clone(source: string, _targetDir: string, options?: CloneOptions): Promise<CloneResult>;
-}
-
-declare class LocalProvider implements GitProviderAdapter {
-    readonly type: GitProvider;
-    readonly name = "Local Filesystem";
-    readonly baseUrl = "";
-    parseSource(source: string): {
-        owner: string;
-        repo: string;
-        subpath?: string;
-    } | null;
-    matches(source: string): boolean;
-    getCloneUrl(_owner: string, _repo: string): string;
-    getSshUrl(_owner: string, _repo: string): string;
-    clone(source: string, _targetDir: string, _options?: CloneOptions): Promise<CloneResult>;
-}
-
-declare function getProvider(type: GitProvider): GitProviderAdapter | undefined;
-declare function getAllProviders(): GitProviderAdapter[];
-declare function detectProvider(source: string): GitProviderAdapter | undefined;
-declare function parseSource(source: string): {
-    provider: GitProviderAdapter;
-    owner: string;
-    repo: string;
-    subpath?: string;
-} | null;
-
-export { type AgentAdapter, AgentType, AmpAdapter, AntigravityAdapter, BitbucketProvider, ClaudeCodeAdapter, ClawdbotAdapter, type CloneOptions, type CloneResult, CodexAdapter, type CommandResult, CursorAdapter, type DiscoveredSkill, DroidAdapter, GeminiCliAdapter, GitHubCopilotAdapter, GitHubProvider, GitLabProvider, GitProvider, type GitProviderAdapter, GooseAdapter, type InstallOptions, KiloAdapter, KiroCliAdapter, LocalProvider, OpenCodeAdapter, type RegistrySkill, RooAdapter, SKILL_DISCOVERY_PATHS, Skill, SkillFrontmatter, SkillLocation, SkillMetadata, SkillkitConfig, type SyncOptions, TraeAdapter, UniversalAdapter, type UpdateOptions, WindsurfAdapter, createSkillXml, detectAgent, detectProvider, discoverSkills, escapeXml, extractField, extractFrontmatter, findAllSkills, findSkill, getAdapter, getAgentConfigPath, getAllAdapters, getAllProviders, getConfigFile, getGlobalConfigPath, getInstallDir, getProjectConfigPath, getProvider, getSearchDirs, getSkillsDir, initProject, isGitUrl, isLocalPath, isPathInside, loadConfig, loadMetadata, loadSkillMetadata, parseShorthand, parseSkill, parseSource, readSkillContent, saveConfig, saveSkillMetadata, setSkillEnabled, validateSkill };
+export * from '@skillkit/core';
+export * from '@skillkit/agents';
+export { startTUI } from '@skillkit/tui';