nova-terminal-ai 0.3.4

package/dist/packages/core/src/extensions/SkillInstaller.d.ts

@@ -0,0 +1,74 @@
+export interface SkillInstallOptions {
+    /** GitHub repository URL or shorthand (e.g., "obra/superpowers") */
+    source: string;
+    /** Target directory for installation (default: ~/.nova/skills/) */
+    targetDir?: string;
+    /** Specific skill names to install (default: all) */
+    skills?: string[];
+    /** Force overwrite existing skills */
+    force?: boolean;
+}
+export interface InstalledSkill {
+    name: string;
+    path: string;
+    source: string;
+}
+/**
+ * Install skills from GitHub repositories
+ *
+ * Supports formats:
+ * - "obra/superpowers" -> https://github.com/obra/superpowers
+ * - "https://github.com/obra/superpowers"
+ * - Full GitHub URL
+ */
+export declare class SkillInstaller {
+    private baseDir;
+    constructor(baseDir?: string);
+    /**
+     * Install skills from a GitHub repository
+     */
+    install(options: SkillInstallOptions): Promise<InstalledSkill[]>;
+    /**
+     * Parse various Git repository URL formats (GitHub, Gitee, etc.)
+     */
+    private parseGitHubUrl;
+    /**
+     * Find the skills directory in a repository
+     */
+    private findSkillsDirectory;
+    /**
+     * List all skill directories
+     */
+    private listSkills;
+    /**
+     * Copy a skill directory
+     */
+    private copySkill;
+    /**
+     * Recursive delete
+     */
+    private rmrf;
+    /**
+     * List installed skills
+     */
+    listInstalled(): string[];
+    /**
+     * Uninstall a skill
+     */
+    uninstall(skillName: string): boolean;
+}
+/**
+ * Popular skill repositories
+ */
+export declare const POPULAR_SKILL_REPOS: {
+    superpowers: {
+        url: string;
+        description: string;
+        skills: string[];
+    };
+};
+/**
+ * Quick install function
+ */
+export declare function installSuperpowers(baseDir?: string): Promise<InstalledSkill[]>;
+//# sourceMappingURL=SkillInstaller.d.ts.map

package/dist/packages/core/src/extensions/SkillInstaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillInstaller.d.ts","sourceRoot":"","sources":["../../../../../../core/src/extensions/SkillInstaller.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,CAAC,EAAE,MAAM;IAI5B;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA2DtE;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAkBjB;;OAEG;IACH,OAAO,CAAC,IAAI;IAeZ;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAOzB;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAMtC;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;CAoB/B,CAAC;AAEF;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAMpF"}

package/dist/packages/core/src/extensions/SkillInstaller.js

@@ -0,0 +1,216 @@
+// ============================================================================
+// SkillInstaller - Install skills from GitHub repositories
+// ============================================================================
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { execSync } from 'node:child_process';
+/**
+ * Install skills from GitHub repositories
+ *
+ * Supports formats:
+ * - "obra/superpowers" -> https://github.com/obra/superpowers
+ * - "https://github.com/obra/superpowers"
+ * - Full GitHub URL
+ */
+export class SkillInstaller {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir || path.join(os.homedir(), '.nova', 'skills');
+    }
+    /**
+     * Install skills from a GitHub repository
+     */
+    async install(options) {
+        const { source, targetDir, skills: specificSkills, force } = options;
+        const target = targetDir || this.baseDir;
+        // Parse GitHub URL
+        const repoUrl = this.parseGitHubUrl(source);
+        const repoName = repoUrl.split('/').pop() || 'unknown';
+        console.log(`Installing skills from ${repoUrl}...`);
+        // Create temp directory for cloning
+        const tempDir = path.join(os.tmpdir(), `nova-skills-${Date.now()}`);
+        try {
+            // Clone repository
+            console.log(`  Cloning repository...`);
+            execSync(`git clone --depth 1 ${repoUrl} "${tempDir}"`, { stdio: 'pipe' });
+            // Find skills directory
+            const skillsDir = this.findSkillsDirectory(tempDir);
+            if (!skillsDir) {
+                throw new Error(`No skills directory found in ${repoName}`);
+            }
+            // Get all skills
+            const availableSkills = this.listSkills(skillsDir);
+            const toInstall = specificSkills
+                ? availableSkills.filter(s => specificSkills.includes(s))
+                : availableSkills;
+            if (toInstall.length === 0) {
+                throw new Error(`No matching skills found`);
+            }
+            // Install each skill
+            const installed = [];
+            for (const skillName of toInstall) {
+                const srcPath = path.join(skillsDir, skillName);
+                const destPath = path.join(target, skillName);
+                // Check if exists
+                if (fs.existsSync(destPath) && !force) {
+                    console.log(`  ⚠ ${skillName} already exists, use --force to overwrite`);
+                    continue;
+                }
+                // Copy skill
+                this.copySkill(srcPath, destPath);
+                installed.push({ name: skillName, path: destPath, source: repoUrl });
+                console.log(`  ✓ Installed: ${skillName}`);
+            }
+            return installed;
+        }
+        finally {
+            // Cleanup temp directory
+            this.rmrf(tempDir);
+        }
+    }
+    /**
+     * Parse various Git repository URL formats (GitHub, Gitee, etc.)
+     */
+    parseGitHubUrl(source) {
+        // Already a full URL (GitHub, Gitee, GitLab, etc.)
+        if (source.startsWith('https://') || source.startsWith('git@')) {
+            return source;
+        }
+        // Gitee shorthand: "gitee:owner/repo"
+        if (source.startsWith('gitee:')) {
+            const repoPath = source.substring(6); // Remove 'gitee:'
+            return `https://gitee.com/${repoPath}.git`;
+        }
+        // GitHub shorthand: "owner/repo"
+        if (source.match(/^[\w-]+\/[\w-]+$/)) {
+            return `https://github.com/${source}.git`;
+        }
+        // Assume it's a GitHub shorthand
+        return `https://github.com/${source}.git`;
+    }
+    /**
+     * Find the skills directory in a repository
+     */
+    findSkillsDirectory(repoDir) {
+        // Common skill directory names
+        const candidates = ['skills', '.claude/skills', 'plugins', '.skills'];
+        for (const name of candidates) {
+            const fullPath = path.join(repoDir, name);
+            if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+                // Verify it contains SKILL.md files
+                const entries = fs.readdirSync(fullPath);
+                const hasSkills = entries.some(entry => {
+                    const skillPath = path.join(fullPath, entry);
+                    return fs.statSync(skillPath).isDirectory() &&
+                        fs.existsSync(path.join(skillPath, 'SKILL.md'));
+                });
+                if (hasSkills)
+                    return fullPath;
+            }
+        }
+        return null;
+    }
+    /**
+     * List all skill directories
+     */
+    listSkills(skillsDir) {
+        return fs.readdirSync(skillsDir).filter(entry => {
+            const skillPath = path.join(skillsDir, entry);
+            return fs.statSync(skillPath).isDirectory() &&
+                fs.existsSync(path.join(skillPath, 'SKILL.md'));
+        });
+    }
+    /**
+     * Copy a skill directory
+     */
+    copySkill(src, dest) {
+        // Create destination
+        fs.mkdirSync(dest, { recursive: true });
+        // Copy all files
+        const entries = fs.readdirSync(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isDirectory()) {
+                this.copySkill(srcPath, destPath);
+            }
+            else {
+                fs.copyFileSync(srcPath, destPath);
+            }
+        }
+    }
+    /**
+     * Recursive delete
+     */
+    rmrf(dir) {
+        if (!fs.existsSync(dir))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                this.rmrf(fullPath);
+            }
+            else {
+                fs.unlinkSync(fullPath);
+            }
+        }
+        fs.rmdirSync(dir);
+    }
+    /**
+     * List installed skills
+     */
+    listInstalled() {
+        if (!fs.existsSync(this.baseDir))
+            return [];
+        return fs.readdirSync(this.baseDir).filter(name => {
+            return fs.existsSync(path.join(this.baseDir, name, 'SKILL.md'));
+        });
+    }
+    /**
+     * Uninstall a skill
+     */
+    uninstall(skillName) {
+        const skillPath = path.join(this.baseDir, skillName);
+        if (!fs.existsSync(skillPath))
+            return false;
+        this.rmrf(skillPath);
+        return true;
+    }
+}
+/**
+ * Popular skill repositories
+ */
+export const POPULAR_SKILL_REPOS = {
+    superpowers: {
+        // Default to Gitee mirror for better accessibility in China
+        url: 'gitee:anderson2/superpowers',
+        description: 'Agentic skills framework - TDD, debugging, code review, planning',
+        skills: [
+            'brainstorming',
+            'writing-plans',
+            'executing-plans',
+            'test-driven-development',
+            'systematic-debugging',
+            'requesting-code-review',
+            'receiving-code-review',
+            'using-git-worktrees',
+            'finishing-a-development-branch',
+            'subagent-driven-development',
+            'verification-before-completion',
+            'writing-skills',
+        ],
+    },
+};
+/**
+ * Quick install function
+ */
+export async function installSuperpowers(baseDir) {
+    const installer = new SkillInstaller(baseDir);
+    return installer.install({
+        source: 'gitee:anderson2/superpowers',
+        force: false,
+    });
+}
+//# sourceMappingURL=SkillInstaller.js.map

package/dist/packages/core/src/extensions/SkillInstaller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillInstaller.js","sourceRoot":"","sources":["../../../../../../core/src/extensions/SkillInstaller.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/extensions/SkillRegistry.d.ts

@@ -0,0 +1,99 @@
+export interface SkillMetadata {
+    /** Unique skill identifier */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Author */
+    author?: string;
+    /** Version (semver) */
+    version: string;
+    /** Tags for categorization and search */
+    tags: string[];
+    /** Supported model providers (empty = all) */
+    providers?: string[];
+    /** Required tools for this skill */
+    requiredTools?: string[];
+    /** Whether this skill was auto-generated */
+    autoGenerated?: boolean;
+    /** Creation date */
+    createdAt: string;
+    /** Last update date */
+    updatedAt: string;
+    /** File size in bytes */
+    sizeBytes?: number;
+    /** Reviewed at date */
+    reviewedAt?: string;
+}
+export interface SkillDefinition {
+    /** Skill metadata */
+    metadata: SkillMetadata;
+    /** SKILL.md content (the skill prompt/instructions) */
+    content: string;
+    /** Associated script files */
+    scripts?: Record<string, string>;
+    /** Associated reference files */
+    references?: string[];
+}
+export interface SkillSearchParams {
+    /** Search query string */
+    query?: string;
+    /** Filter by tags */
+    tags?: string[];
+    /** Filter by provider compatibility */
+    provider?: string;
+    /** Include auto-generated skills */
+    includeAutoGenerated?: boolean;
+    /** Maximum results */
+    limit?: number;
+}
+export declare class SkillRegistry {
+    private skillsDir;
+    private cache;
+    private initialized;
+    constructor(skillsDir?: string);
+    /**
+     * Initialize the registry by loading all skills from disk.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Register a new skill.
+     */
+    register(skill: SkillDefinition): Promise<void>;
+    /**
+     * Get a skill by name.
+     */
+    get(name: string): Promise<SkillDefinition | null>;
+    /**
+     * Search for skills matching the given criteria.
+     */
+    search(params: SkillSearchParams): Promise<SkillDefinition[]>;
+    /**
+     * List all registered skills.
+     */
+    list(): Promise<SkillDefinition[]>;
+    /**
+     * Remove a skill.
+     */
+    remove(name: string): Promise<boolean>;
+    /**
+     * Get the skills directory path.
+     */
+    getSkillsDir(): string;
+    /**
+     * Build the full SKILL.md content with metadata header.
+     */
+    private buildSkillMd;
+    /**
+     * Load a skill from disk.
+     */
+    private loadSkill;
+    /**
+     * Parse SKILL.md content into metadata and body.
+     */
+    private parseSkillMd;
+    /**
+     * Recursively remove a directory.
+     */
+    private removeDirectory;
+}
+//# sourceMappingURL=SkillRegistry.d.ts.map

package/dist/packages/core/src/extensions/SkillRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillRegistry.d.ts","sourceRoot":"","sources":["../../../../../../core/src/extensions/SkillRegistry.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,WAAW,CAAS;gBAEhB,SAAS,CAAC,EAAE,MAAM;IAI9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBjC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAYxD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA4DnE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAOxC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa5C;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;YACW,SAAS;IAkCvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwDpB;;OAEG;YACW,eAAe;CAG9B"}

package/dist/packages/core/src/extensions/SkillRegistry.js

@@ -0,0 +1,263 @@
+// ============================================================================
+// SkillRegistry - Register, discover, and manage agent skills
+// Reference: WorkBuddy skill system with metadata tracking
+// ============================================================================
+import { readFile, writeFile, mkdir, readdir, stat, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+// --- SkillRegistry ---
+export class SkillRegistry {
+    skillsDir;
+    cache = new Map();
+    initialized = false;
+    constructor(skillsDir) {
+        this.skillsDir = skillsDir || join(process.env.HOME || process.env.USERPROFILE || '~', '.nova-cli', 'skills');
+    }
+    /**
+     * Initialize the registry by loading all skills from disk.
+     */
+    async initialize() {
+        try {
+            await mkdir(this.skillsDir, { recursive: true });
+        }
+        catch {
+            // Directory may already exist
+        }
+        const entries = await readdir(this.skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const skillPath = join(this.skillsDir, entry.name);
+                try {
+                    const skill = await this.loadSkill(entry.name);
+                    if (skill) {
+                        this.cache.set(entry.name, skill);
+                    }
+                }
+                catch {
+                    // Skip invalid skills
+                }
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Register a new skill.
+     */
+    async register(skill) {
+        const skillDir = join(this.skillsDir, skill.metadata.name);
+        await mkdir(skillDir, { recursive: true });
+        // Write SKILL.md
+        const skillMdPath = join(skillDir, 'SKILL.md');
+        const fullContent = this.buildSkillMd(skill.metadata, skill.content);
+        await writeFile(skillMdPath, fullContent, 'utf-8');
+        // Write script files
+        if (skill.scripts) {
+            const scriptsDir = join(skillDir, 'scripts');
+            await mkdir(scriptsDir, { recursive: true });
+            for (const [filename, content] of Object.entries(skill.scripts)) {
+                await writeFile(join(scriptsDir, filename), content, 'utf-8');
+            }
+        }
+        // Update cache
+        skill.metadata.updatedAt = new Date().toISOString();
+        this.cache.set(skill.metadata.name, skill);
+    }
+    /**
+     * Get a skill by name.
+     */
+    async get(name) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        if (this.cache.has(name)) {
+            return this.cache.get(name);
+        }
+        return this.loadSkill(name);
+    }
+    /**
+     * Search for skills matching the given criteria.
+     */
+    async search(params) {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        let results = Array.from(this.cache.values());
+        // Filter by auto-generated
+        if (!params.includeAutoGenerated) {
+            results = results.filter((s) => !s.metadata.autoGenerated);
+        }
+        // Filter by provider
+        if (params.provider) {
+            results = results.filter((s) => !s.metadata.providers ||
+                s.metadata.providers.length === 0 ||
+                s.metadata.providers.includes(params.provider));
+        }
+        // Filter by tags
+        if (params.tags && params.tags.length > 0) {
+            results = results.filter((s) => params.tags.some((tag) => s.metadata.tags.includes(tag)));
+        }
+        // Filter by query
+        if (params.query) {
+            const query = params.query.toLowerCase();
+            results = results.filter((s) => s.metadata.name.toLowerCase().includes(query) ||
+                s.metadata.description.toLowerCase().includes(query) ||
+                s.metadata.tags.some((t) => t.toLowerCase().includes(query)));
+        }
+        // Sort by relevance (name match first, then description match)
+        if (params.query) {
+            const query = params.query.toLowerCase();
+            results.sort((a, b) => {
+                const aNameMatch = a.metadata.name.toLowerCase().includes(query) ? 2 : 0;
+                const bNameMatch = b.metadata.name.toLowerCase().includes(query) ? 2 : 0;
+                const aDescMatch = a.metadata.description.toLowerCase().includes(query) ? 1 : 0;
+                const bDescMatch = b.metadata.description.toLowerCase().includes(query) ? 1 : 0;
+                return (bNameMatch + bDescMatch) - (aNameMatch + aDescMatch);
+            });
+        }
+        // Limit results
+        if (params.limit) {
+            results = results.slice(0, params.limit);
+        }
+        return results;
+    }
+    /**
+     * List all registered skills.
+     */
+    async list() {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        return Array.from(this.cache.values());
+    }
+    /**
+     * Remove a skill.
+     */
+    async remove(name) {
+        const skillDir = join(this.skillsDir, name);
+        try {
+            await rm(skillDir, { recursive: true, force: true });
+        }
+        catch {
+            return false;
+        }
+        this.cache.delete(name);
+        return true;
+    }
+    /**
+     * Get the skills directory path.
+     */
+    getSkillsDir() {
+        return this.skillsDir;
+    }
+    /**
+     * Build the full SKILL.md content with metadata header.
+     */
+    buildSkillMd(metadata, content) {
+        const header = `---
+name: ${metadata.name}
+description: ${metadata.description}
+version: ${metadata.version}
+author: ${metadata.author || 'unknown'}
+tags: ${metadata.tags.join(', ')}
+${metadata.providers ? `providers: ${metadata.providers.join(', ')}` : ''}
+${metadata.requiredTools ? `requiredTools: ${metadata.requiredTools.join(', ')}` : ''}
+${metadata.autoGenerated ? 'autoGenerated: true' : ''}
+createdAt: ${metadata.createdAt}
+updatedAt: ${metadata.updatedAt}
+---
+
+`;
+        return header + content;
+    }
+    /**
+     * Load a skill from disk.
+     */
+    async loadSkill(name) {
+        const skillDir = join(this.skillsDir, name);
+        const skillMdPath = join(skillDir, 'SKILL.md');
+        try {
+            const rawContent = await readFile(skillMdPath, 'utf-8');
+            const { metadata, content } = this.parseSkillMd(rawContent);
+            // Load scripts
+            const scripts = {};
+            const scriptsDir = join(skillDir, 'scripts');
+            try {
+                const entries = await readdir(scriptsDir);
+                for (const entry of entries) {
+                    if (entry.endsWith('.ts') || entry.endsWith('.js') || entry.endsWith('.sh') || entry.endsWith('.py')) {
+                        scripts[entry] = await readFile(join(scriptsDir, entry), 'utf-8');
+                    }
+                }
+            }
+            catch {
+                // No scripts directory
+            }
+            const fileStat = await stat(skillMdPath);
+            return {
+                metadata: { ...metadata, sizeBytes: fileStat.size },
+                content,
+                scripts: Object.keys(scripts).length > 0 ? scripts : undefined,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Parse SKILL.md content into metadata and body.
+     */
+    parseSkillMd(rawContent) {
+        const frontmatterMatch = rawContent.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        if (!frontmatterMatch) {
+            return {
+                metadata: {
+                    name: 'unknown',
+                    description: 'No description',
+                    version: '0.0.0',
+                    tags: [],
+                    createdAt: new Date().toISOString(),
+                    updatedAt: new Date().toISOString(),
+                },
+                content: rawContent,
+            };
+        }
+        const frontmatter = frontmatterMatch[1];
+        const content = frontmatterMatch[2];
+        const parseField = (field) => {
+            const match = frontmatter.match(new RegExp(`${field}:\\s*(.+)`));
+            return match ? match[1].trim() : '';
+        };
+        const parseArray = (field) => {
+            const raw = parseField(field);
+            if (!raw)
+                return [];
+            return raw.split(',').map((s) => s.trim()).filter(Boolean);
+        };
+        const parseBool = (field) => {
+            const raw = parseField(field);
+            return raw.toLowerCase() === 'true';
+        };
+        const name = parseField('name') || 'unknown';
+        return {
+            metadata: {
+                name,
+                description: parseField('description'),
+                version: parseField('version') || '0.0.0',
+                author: parseField('author') || undefined,
+                tags: parseArray('tags'),
+                providers: parseArray('providers').length > 0 ? parseArray('providers') : undefined,
+                requiredTools: parseArray('requiredTools').length > 0 ? parseArray('requiredTools') : undefined,
+                autoGenerated: parseBool('autoGenerated'),
+                createdAt: parseField('createdAt') || new Date().toISOString(),
+                updatedAt: parseField('updatedAt') || new Date().toISOString(),
+            },
+            content,
+        };
+    }
+    /**
+     * Recursively remove a directory.
+     */
+    async removeDirectory(dirPath) {
+        await rm(dirPath, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=SkillRegistry.js.map