transskill 0.1.0

package/dist/index.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { registerResolver, LocalResolver, GitHubResolver, resolveInput } from './resolver/index.js';
+import { registerParser, SKILLMdParser, CursorRulesParser, MdcParser, getRegisteredFormats } from './parser/index.js';
+import { DefaultMapper } from './mapper/index.js';
+import { registerRenderer, SKILLMdRenderer, CursorRulesRenderer, MdcRenderer, getRegisteredRenderers } from './renderer/index.js';
+import { detectFormatFromPath } from './utils/format-detector.js';
+import { writeOutput, ensureDir, displayPath } from './utils/file-utils.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+// ============================================================
+// Bootstrap: register all plugins
+// ============================================================
+registerResolver(new GitHubResolver());
+registerResolver(new LocalResolver());
+registerParser(new SKILLMdParser());
+registerParser(new CursorRulesParser());
+registerParser(new MdcParser());
+const mapper = new DefaultMapper();
+registerRenderer(new SKILLMdRenderer());
+registerRenderer(new CursorRulesRenderer());
+registerRenderer(new MdcRenderer());
+// ============================================================
+// CLI
+// ============================================================
+const program = new Command();
+program
+    .name('transskill')
+    .description('Cross-platform AI agent skill converter - Write once, run on any agent')
+    .version(pkg.version);
+program
+    .command('convert <input>')
+    .description('Convert a skill file/directory/GitHub repo to another format')
+    .requiredOption('-t, --to <format>', 'Target format (skill.md, .cursorrules, .mdc)')
+    .option('-o, --output <path>', 'Output directory (default: current directory)')
+    .option('--install-to <path>', 'Install directly to target agent config directory')
+    .option('--glob <pattern>', 'File glob pattern (for .mdc output)')
+    .option('--always-apply', 'Always apply rule (for .mdc output)')
+    .option('--dry-run', 'Preview what would happen without actually writing')
+    .option('-v, --verbose', 'Show detailed conversion report')
+    .action(async (input, options) => {
+    try {
+        console.log(`\n🔄 TransSkill v${pkg.version}`);
+        console.log(`${'─'.repeat(40)}`);
+        // Step 1: Resolve input
+        const resolved = await resolveInput(input);
+        if (options.verbose) {
+            console.log(`  Source:      ${resolved.isRemote ? 'GitHub (remote)' : 'Local'}`);
+            console.log(`  Path:        ${resolved.localPath}`);
+            console.log(`  Type:        ${resolved.type}`);
+        }
+        // Step 2: Detect format
+        const { format: sourceFormat, isDirectory } = detectFormatFromPath(resolved.localPath);
+        const targetFormat = options.to;
+        console.log(`  From:        ${sourceFormat}${isDirectory ? ' (directory)' : ''}`);
+        console.log(`  To:          ${targetFormat}`);
+        // Step 3: Get parser and renderer
+        const { getParser } = await import('./parser/parser-registry.js');
+        const { getRenderer } = await import('./renderer/renderer-registry.js');
+        const parser = getParser(sourceFormat);
+        const renderer = getRenderer(targetFormat);
+        if (options.dryRun) {
+            console.log(`\n${'─'.repeat(40)}`);
+            console.log(`🔍 DRY RUN - no files will be written`);
+            console.log(`${'─'.repeat(40)}`);
+            console.log(`  Pipeline:    ${sourceFormat} → ${targetFormat}`);
+            console.log(`  Input:       ${input}`);
+            console.log(`  Source file: ${resolved.localPath}`);
+            if (options.output)
+                console.log(`  Output:      ${options.output}`);
+            if (options.installTo)
+                console.log(`  Install to:  ${options.installTo}`);
+            if (options.glob)
+                console.log(`  Glob:        ${options.glob}`);
+            if (options.alwaysApply)
+                console.log(`  Always apply: yes`);
+            console.log(`${'─'.repeat(40)}\n`);
+            console.log('✅ Dry-run complete. Remove --dry-run to execute.\n');
+            if (resolved.cleanup)
+                await resolved.cleanup();
+            return;
+        }
+        // Step 4: Determine output path
+        const cwd = options.installTo || options.output || process.cwd();
+        ensureDir(cwd);
+        // Step 5: Process
+        if (isDirectory) {
+            // Directory mode
+            const skillDir = parser.parseDirectory(resolved.localPath);
+            // Read and parse SKILL.md
+            const { readInput } = await import('./utils/file-utils.js');
+            const content = readInput(skillDir.skillFile);
+            const skill = parser.parse(content, skillDir.skillFile);
+            // Apply mapper
+            const { skill: mapped, report } = mapper.map(skill, targetFormat);
+            // Apply CLI options to mapped skill
+            if (options.glob && mapped.platformSpecific.cursor) {
+                mapped.platformSpecific.cursor.globs = [options.glob];
+            }
+            if (options.alwaysApply && mapped.platformSpecific.cursor) {
+                mapped.platformSpecific.cursor.alwaysApply = true;
+            }
+            // Render directory
+            if (renderer.renderDirectory) {
+                const result = renderer.renderDirectory(skillDir, mapped, cwd);
+                console.log(`\n${'─'.repeat(40)}`);
+                console.log('✅ Directory conversion complete');
+                console.log(`  Main:        ${displayPath(result.mainOutput)}`);
+                for (const copied of result.copiedFiles) {
+                    console.log(`  Copied:      ${displayPath(copied)}`);
+                }
+                for (const skipped of result.skippedFiles) {
+                    console.log(`  ⚠️  Skipped:   ${displayPath(skipped)}`);
+                }
+            }
+            else {
+                // Fallback: single file output for directory input
+                const outPath = join(cwd, `${skillDir.name}${renderer.extension}`);
+                writeOutput(outPath, renderer.render(mapped));
+                console.log(`\n✅ Converted: ${displayPath(outPath)}`);
+            }
+            // Show report
+            if (report.warnings.length > 0) {
+                console.log('');
+                for (const w of report.warnings) {
+                    console.log(`  ⚠️  ${w}`);
+                }
+            }
+            if (options.verbose && report.lost.length > 0) {
+                console.log(`\n  Lost fields: ${report.lost.join(', ')}`);
+            }
+        }
+        else {
+            // File mode
+            const { readInput } = await import('./utils/file-utils.js');
+            const content = readInput(resolved.localPath);
+            const skill = parser.parse(content, resolved.localPath);
+            // Apply mapper
+            const { skill: mapped, report } = mapper.map(skill, targetFormat);
+            // Apply CLI options
+            if (options.glob && mapped.platformSpecific.cursor) {
+                mapped.platformSpecific.cursor.globs = [options.glob];
+            }
+            if (options.alwaysApply && mapped.platformSpecific.cursor) {
+                mapped.platformSpecific.cursor.alwaysApply = true;
+            }
+            // Render
+            const rendered = renderer.render(mapped);
+            const { basename, extname } = await import('node:path');
+            const outName = basename(resolved.localPath, extname(resolved.localPath)) + renderer.extension;
+            const outPath = join(cwd, outName);
+            writeOutput(outPath, rendered);
+            console.log(`\n${'─'.repeat(40)}`);
+            console.log('✅ Conversion complete');
+            console.log(`  Output:      ${displayPath(outPath)}`);
+            if (report.warnings.length > 0) {
+                console.log('');
+                for (const w of report.warnings) {
+                    console.log(`  ⚠️  ${w}`);
+                }
+            }
+            if (options.verbose && report.lost.length > 0) {
+                console.log(`\n  Lost fields: ${report.lost.join(', ')}`);
+            }
+        }
+        console.log('');
+        // Cleanup
+        if (resolved.cleanup)
+            await resolved.cleanup();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`\n❌ Error: ${message}\n`);
+        process.exit(1);
+    }
+});
+program
+    .command('list-formats')
+    .description('List all supported input/output formats')
+    .action(() => {
+    console.log('\n📦 Supported formats:\n');
+    console.log('   Input → Output');
+    console.log('   ────────────────');
+    console.log('   SKILL.md    → .cursorrules, .mdc');
+    console.log('   .cursorrules → SKILL.md, .mdc');
+    console.log('   .mdc        → SKILL.md, .cursorrules');
+    console.log('   MCP JSON    → SKILL.md');
+    console.log('');
+    console.log('   Input sources:');
+    console.log('     ./file           Local file');
+    console.log('     ./dir/           Local skill directory');
+    console.log('     gh:user/repo     GitHub repository');
+    console.log('     https://github.com/user/repo  GitHub URL');
+    console.log('');
+    console.log(`   Parsers:  ${getRegisteredFormats().join(', ')}`);
+    console.log(`   Renderers: ${getRegisteredRenderers().map((r) => r.format).join(', ')}`);
+    console.log('');
+});
+program
+    .command('validate <input>')
+    .description('Validate a skill file or directory')
+    .option('-f, --format <format>', 'Specify input format (auto-detected if omitted)')
+    .action(async (input, _options) => {
+    try {
+        console.log(`\n🔍 Validating: ${input}`);
+        const resolved = await resolveInput(input);
+        console.log(`  Resolved:    ${resolved.localPath}`);
+        console.log(`  Type:        ${resolved.type}`);
+        if (resolved.type === 'directory') {
+            const { getParser, detectFormat } = await import('./parser/parser-registry.js');
+            const parser = getParser('skill.md');
+            const dir = parser.parseDirectory(resolved.localPath);
+            console.log(`  Skill:       ${dir.name}`);
+            console.log(`  SKILL.md:    ${dir.skillFile}`);
+            if (dir.scriptsDir)
+                console.log(`  Scripts:     ${dir.scriptsDir}`);
+            if (dir.referencesDir)
+                console.log(`  References:  ${dir.referencesDir}`);
+            if (dir.assetsDir)
+                console.log(`  Assets:      ${dir.assetsDir}`);
+        }
+        else {
+            const { readInput } = await import('./utils/file-utils.js');
+            const content = readInput(resolved.localPath);
+            const { detectFormat } = await import('./parser/parser-registry.js');
+            const format = detectFormat(content, resolved.localPath);
+            if (format) {
+                console.log(`  Format:      ${format}`);
+            }
+            else {
+                console.log(`  Format:      unknown (use --format to specify)`);
+            }
+        }
+        console.log('\n✅ Validation passed - input looks valid.\n');
+        if (resolved.cleanup)
+            await resolved.cleanup();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`\n❌ Validation failed: ${message}\n`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mapper/default.mapper.d.ts

@@ -0,0 +1,18 @@
+import type { Mapper, MappedResult } from './mapper.interface.js';
+import type { FormatType, IntermediateSkill } from '../core/types.js';
+/**
+ * Default mapper handles all bidirectional conversions:
+ *   SKILL.md ↔ .cursorrules
+ *   SKILL.md ↔ .mdc
+ *   .cursorrules ↔ .mdc
+ */
+export declare class DefaultMapper implements Mapper {
+    private readonly biMap;
+    supportedSources(): FormatType[];
+    supportedTargets(): FormatType[];
+    map(skill: IntermediateSkill, targetFormat: FormatType): MappedResult;
+    /** Remove platform-specific fields irrelevant to the target */
+    private cleanupPlatformFields;
+    private deepClone;
+}
+//# sourceMappingURL=default.mapper.d.ts.map

package/dist/mapper/default.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.mapper.d.ts","sourceRoot":"","sources":["../../src/mapper/default.mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAoB,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAIpB;IAEF,gBAAgB,IAAI,UAAU,EAAE;IAIhC,gBAAgB,IAAI,UAAU,EAAE;IAQhC,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,GAAG,YAAY;IAmFrE,+DAA+D;IAC/D,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,SAAS;CAGlB"}

package/dist/mapper/default.mapper.js

@@ -0,0 +1,107 @@
+/**
+ * Default mapper handles all bidirectional conversions:
+ *   SKILL.md ↔ .cursorrules
+ *   SKILL.md ↔ .mdc
+ *   .cursorrules ↔ .mdc
+ */
+export class DefaultMapper {
+    biMap = {
+        'skill.md': ['.cursorrules', '.mdc'],
+        '.cursorrules': ['skill.md', '.mdc'],
+        '.mdc': ['skill.md', '.cursorrules'],
+    };
+    supportedSources() {
+        return Object.keys(this.biMap);
+    }
+    supportedTargets() {
+        const set = new Set();
+        for (const targets of Object.values(this.biMap)) {
+            targets.forEach((t) => set.add(t));
+        }
+        return Array.from(set);
+    }
+    map(skill, targetFormat) {
+        const report = {
+            sourceFormat: skill.metadata.sourceFormat,
+            targetFormat,
+            warnings: [],
+            preserved: ['name', 'description', 'instructions'],
+            lost: [],
+        };
+        const result = this.deepClone(skill);
+        result.metadata.sourceFormat = targetFormat;
+        switch (targetFormat) {
+            case '.cursorrules': {
+                // .cursorrules has no frontmatter — scripts and asset refs are lost
+                if (result.metadata.attachedFiles && result.metadata.attachedFiles.length > 0) {
+                    report.warnings.push('Scripts and asset references from the skill directory will not work in .cursorrules (pure text format). Files have been copied alongside the output.');
+                    report.lost.push('attachedFiles (scripts, assets, references)');
+                }
+                // Claude-specific fields are meaningless in Cursor
+                if (result.platformSpecific.claude?.disableModelInvocation) {
+                    report.warnings.push('.cursorrules does not support disableModelInvocation — rules always apply.');
+                    report.lost.push('platformSpecific.claude.disableModelInvocation');
+                }
+                if (result.platformSpecific.claude?.manualOnly) {
+                    report.lost.push('platformSpecific.claude.manualOnly');
+                }
+                break;
+            }
+            case '.mdc': {
+                // Ensure cursor-specific fields exist
+                if (!result.platformSpecific.cursor) {
+                    result.platformSpecific.cursor = { alwaysApply: false };
+                }
+                // Transfer attached files info if available
+                if (result.metadata.attachedFiles && result.metadata.attachedFiles.length > 0) {
+                    report.warnings.push('Attached files were copied but .mdc cannot reference them natively.');
+                }
+                // Claude-specific fields
+                if (result.platformSpecific.claude?.disableModelInvocation) {
+                    report.warnings.push('disableModelInvocation has no equivalent in .mdc — use alwaysApply for similar effect.');
+                    report.lost.push('platformSpecific.claude.disableModelInvocation');
+                }
+                break;
+            }
+            case 'skill.md': {
+                // SKILL.md is the richest format — most fields preserve
+                report.preserved.push('metadata.tags', 'metadata.author', 'metadata.version');
+                // Cursor-specific globs have no direct equivalent
+                if (result.platformSpecific.cursor?.globs) {
+                    report.warnings.push('File glob scoping (globs) is not supported in SKILL.md. Consider splitting into multiple skills.');
+                    report.lost.push('platformSpecific.cursor.globs');
+                }
+                break;
+            }
+            default: {
+                report.warnings.push(`Target format "${targetFormat}" uses generic mapping.`);
+            }
+        }
+        // Clean up platform fields that don't apply to target
+        this.cleanupPlatformFields(result, targetFormat);
+        return { skill: result, report };
+    }
+    /** Remove platform-specific fields irrelevant to the target */
+    cleanupPlatformFields(skill, targetFormat) {
+        switch (targetFormat) {
+            case '.cursorrules':
+            case '.mdc':
+                delete skill.platformSpecific.claude;
+                delete skill.platformSpecific.openclaw;
+                delete skill.platformSpecific.mcp;
+                break;
+            case 'skill.md':
+                // Keep everything — SKILL.md is the canonical format
+                break;
+            default:
+                delete skill.platformSpecific.cursor;
+                delete skill.platformSpecific.claude;
+                delete skill.platformSpecific.openclaw;
+                delete skill.platformSpecific.mcp;
+        }
+    }
+    deepClone(obj) {
+        return JSON.parse(JSON.stringify(obj));
+    }
+}
+//# sourceMappingURL=default.mapper.js.map

package/dist/mapper/default.mapper.js.map

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

package/dist/mapper/index.d.ts

@@ -0,0 +1,3 @@
+export { DefaultMapper } from './default.mapper.js';
+export type { Mapper, MappedResult, ConversionReport } from './mapper.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mapper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mapper/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mapper/index.js

@@ -0,0 +1,2 @@
+export { DefaultMapper } from './default.mapper.js';
+//# sourceMappingURL=index.js.map

package/dist/mapper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mapper/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mapper/mapper.interface.d.ts

@@ -0,0 +1,25 @@
+import type { FormatType, IntermediateSkill } from '../core/types.js';
+export interface ConversionReport {
+    sourceFormat: FormatType;
+    targetFormat: FormatType;
+    warnings: string[];
+    preserved: string[];
+    lost: string[];
+}
+/**
+ * Mapper interface - maps fields between platform skill formats.
+ * Reports what was preserved and what was lost during conversion.
+ */
+export interface Mapper {
+    /** Map an IntermediateSkill to a target format */
+    map(skill: IntermediateSkill, targetFormat: FormatType): MappedResult;
+    /** List source formats this mapper supports */
+    supportedSources(): FormatType[];
+    /** List target formats this mapper supports */
+    supportedTargets(): FormatType[];
+}
+export interface MappedResult {
+    skill: IntermediateSkill;
+    report: ConversionReport;
+}
+//# sourceMappingURL=mapper.interface.d.ts.map

package/dist/mapper/mapper.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.interface.d.ts","sourceRoot":"","sources":["../../src/mapper/mapper.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,kDAAkD;IAClD,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,GAAG,YAAY,CAAC;IAEtE,+CAA+C;IAC/C,gBAAgB,IAAI,UAAU,EAAE,CAAC;IAEjC,+CAA+C;IAC/C,gBAAgB,IAAI,UAAU,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/dist/mapper/mapper.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mapper.interface.js.map

package/dist/mapper/mapper.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.interface.js","sourceRoot":"","sources":["../../src/mapper/mapper.interface.ts"],"names":[],"mappings":""}

package/dist/parser/cursor-rules.parser.d.ts

@@ -0,0 +1,16 @@
+import type { Parser } from './parser.interface.js';
+import type { FormatType, IntermediateSkill, SkillDirectory } from '../core/types.js';
+/**
+ * Parser for .cursorrules format.
+ *
+ * .cursorrules is a plain text file with instructions for Cursor IDE.
+ * It has no frontmatter — the entire content is treated as instructions.
+ * Used by: Cursor IDE (legacy format)
+ */
+export declare class CursorRulesParser implements Parser {
+    readonly format: FormatType;
+    detect(_content: string, filePath?: string): boolean;
+    parse(content: string, filePath?: string): IntermediateSkill;
+    parseDirectory(dirPath: string): SkillDirectory;
+}
+//# sourceMappingURL=cursor-rules.parser.d.ts.map

package/dist/parser/cursor-rules.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rules.parser.d.ts","sourceRoot":"","sources":["../../src/parser/cursor-rules.parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGtF;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,MAAM;IAC9C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAkB;IAE7C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAIpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAuB5D,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CAOhD"}

package/dist/parser/cursor-rules.parser.js

@@ -0,0 +1,38 @@
+import { basename, extname } from 'node:path';
+import { TransSkillError } from '../core/errors.js';
+/**
+ * Parser for .cursorrules format.
+ *
+ * .cursorrules is a plain text file with instructions for Cursor IDE.
+ * It has no frontmatter — the entire content is treated as instructions.
+ * Used by: Cursor IDE (legacy format)
+ */
+export class CursorRulesParser {
+    format = '.cursorrules';
+    detect(_content, filePath) {
+        return filePath?.endsWith('.cursorrules') ?? false;
+    }
+    parse(content, filePath) {
+        const instructions = content.trim();
+        // Derive name from filename (or parent directory)
+        const name = filePath
+            ? basename(filePath, extname(filePath))
+            : 'untitled-rules';
+        // Extract first meaningful line as description
+        const firstLine = instructions.split('\n')[0]?.replace(/^[#\s]*/, '').trim() || '';
+        const description = firstLine.length > 0 ? firstLine : `Cursor rules from ${name}`;
+        return {
+            name,
+            description,
+            instructions,
+            metadata: {
+                sourceFormat: '.cursorrules',
+            },
+            platformSpecific: {},
+        };
+    }
+    parseDirectory(dirPath) {
+        throw new TransSkillError(`.cursorrules does not support directory parsing — use single file mode`, 'UNSUPPORTED_INPUT', { dirPath });
+    }
+}
+//# sourceMappingURL=cursor-rules.parser.js.map

package/dist/parser/cursor-rules.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rules.parser.js","sourceRoot":"","sources":["../../src/parser/cursor-rules.parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACnB,MAAM,GAAe,cAAc,CAAC;IAE7C,MAAM,CAAC,QAAgB,EAAE,QAAiB;QACxC,OAAO,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,QAAiB;QACtC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpC,kDAAkD;QAClD,MAAM,IAAI,GAAG,QAAQ;YACnB,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC,CAAC,gBAAgB,CAAC;QAErB,+CAA+C;QAC/C,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACnF,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,IAAI,EAAE,CAAC;QAEnF,OAAO;YACL,IAAI;YACJ,WAAW;YACX,YAAY;YACZ,QAAQ,EAAE;gBACR,YAAY,EAAE,cAAc;aAC7B;YACD,gBAAgB,EAAE,EAAE;SACrB,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,MAAM,IAAI,eAAe,CACvB,wEAAwE,EACxE,mBAAmB,EACnB,EAAE,OAAO,EAAE,CACZ,CAAC;IACJ,CAAC;CACF"}

package/dist/parser/index.d.ts

@@ -0,0 +1,6 @@
+export { registerParser, getParser, detectFormat, getRegisteredFormats, isFormatSupported } from './parser-registry.js';
+export { SKILLMdParser } from './skill-md.parser.js';
+export { CursorRulesParser } from './cursor-rules.parser.js';
+export { MdcParser } from './mdc.parser.js';
+export type { Parser } from './parser.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACxH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,5 @@
+export { registerParser, getParser, detectFormat, getRegisteredFormats, isFormatSupported } from './parser-registry.js';
+export { SKILLMdParser } from './skill-md.parser.js';
+export { CursorRulesParser } from './cursor-rules.parser.js';
+export { MdcParser } from './mdc.parser.js';
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACxH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/parser/mdc.parser.d.ts

@@ -0,0 +1,17 @@
+import type { Parser } from './parser.interface.js';
+import type { FormatType, IntermediateSkill, SkillDirectory } from '../core/types.js';
+/**
+ * Parser for .mdc format (Cursor 2.3+ rules).
+ *
+ * .mdc files have YAML frontmatter with description, globs, and alwaysApply fields.
+ * The body contains the rule instructions in Markdown.
+ *
+ * Used by: Cursor IDE (.cursor/rules/*.mdc)
+ */
+export declare class MdcParser implements Parser {
+    readonly format: FormatType;
+    detect(_content: string, filePath?: string): boolean;
+    parse(content: string, filePath?: string): IntermediateSkill;
+    parseDirectory(dirPath: string): SkillDirectory;
+}
+//# sourceMappingURL=mdc.parser.d.ts.map

package/dist/parser/mdc.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdc.parser.d.ts","sourceRoot":"","sources":["../../src/parser/mdc.parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGtF;;;;;;;GAOG;AACH,qBAAa,SAAU,YAAW,MAAM;IACtC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAU;IAErC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAIpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB;IA6C5D,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CAOhD"}

package/dist/parser/mdc.parser.js

@@ -0,0 +1,62 @@
+import matter from 'gray-matter';
+import { basename, extname } from 'node:path';
+import { TransSkillError } from '../core/errors.js';
+/**
+ * Parser for .mdc format (Cursor 2.3+ rules).
+ *
+ * .mdc files have YAML frontmatter with description, globs, and alwaysApply fields.
+ * The body contains the rule instructions in Markdown.
+ *
+ * Used by: Cursor IDE (.cursor/rules/*.mdc)
+ */
+export class MdcParser {
+    format = '.mdc';
+    detect(_content, filePath) {
+        return filePath?.endsWith('.mdc') ?? false;
+    }
+    parse(content, filePath) {
+        let parsed;
+        try {
+            parsed = matter(content);
+        }
+        catch {
+            // No valid frontmatter — treat as plain text (fallback)
+            const instructions = content.trim();
+            const name = filePath ? basename(filePath, extname(filePath)) : 'untitled-rule';
+            return {
+                name,
+                description: instructions.split('\n')[0]?.replace(/^[#\s]*/, '').trim() || name,
+                instructions,
+                metadata: { sourceFormat: '.mdc' },
+                platformSpecific: { cursor: {} },
+            };
+        }
+        const frontmatter = parsed.data;
+        const instructions = parsed.content.trim();
+        const name = filePath ? basename(filePath, extname(filePath)) : 'untitled-rule';
+        const description = typeof frontmatter.description === 'string' ? frontmatter.description : name;
+        const cursorSpecific = {};
+        if (typeof frontmatter.globs === 'string') {
+            cursorSpecific.globs = [frontmatter.globs];
+        }
+        if (typeof frontmatter.alwaysApply === 'boolean') {
+            cursorSpecific.alwaysApply = frontmatter.alwaysApply;
+        }
+        return {
+            name,
+            description,
+            instructions,
+            metadata: {
+                sourceFormat: '.mdc',
+                rawFrontmatter: { ...frontmatter, description: undefined },
+            },
+            platformSpecific: {
+                cursor: Object.keys(cursorSpecific).length > 0 ? cursorSpecific : undefined,
+            },
+        };
+    }
+    parseDirectory(dirPath) {
+        throw new TransSkillError('.mdc format does not support directory parsing — use single file mode', 'UNSUPPORTED_INPUT', { dirPath });
+    }
+}
+//# sourceMappingURL=mdc.parser.js.map