@supertiny99/easy-skill 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 supertiny99
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# easy-skill
+
+🛠️ TUI tool for managing skills - download, organize and create symlinks for `.claude` and `.trae`.
+
+[![npm version](https://badge.fury.io/js/%40supertiny99%2Feasy-skill.svg)](https://www.npmjs.com/package/@supertiny99/easy-skill)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ Features
+
+- 📥 **Smart Download** - Auto-detect branches and skill candidates from Git repos
+- 🔍 **Repository Explorer** - Browse and multi-select skills from any repo
+- 🔗 **Batch Link/Unlink** - Manage symlinks across multiple IDEs at once
+- 📋 **Status Overview** - View all skills and their link status
+- ⚡ **Quick Actions** - Toggle all, rename conflicts, skip duplicates
+
+## 🚀 Installation
+
+```bash
+npm install -g @supertiny99/easy-skill
+```
+
+## 📖 Usage
+
+### Interactive TUI (Recommended)
+
+```bash
+easy-skill
+# or short alias
+es
+```
+
+### TUI Flow
+
+```
+1. Select action (Download / Link / Unlink / List / Remove)
+2. For Git downloads:
+   - Enter repository URL
+   - Select branch from list
+   - Multi-select skills to download ([space] select, [a] toggle all)
+   - Handle conflicts (overwrite/rename/skip/reselect)
+   - Multi-select IDEs to create symlinks
+```
+
+### CLI Commands
+
+```bash
+# Download from Git (with smart explore)
+easy-skill download https://github.com/user/skills.git
+
+# Download with options
+easy-skill download https://github.com/user/skills.git \
+  --branch main \
+  --subdir my-skill \
+  --id custom-name \
+  --link
+
+# Link/Unlink skills
+easy-skill link my-skill --claude --trae
+easy-skill unlink my-skill
+
+# List all skills
+easy-skill list  # or: es ls
+
+# Remove skill
+easy-skill remove my-skill  # or: es rm my-skill --force
+```
+
+## 📁 Directory Structure
+
+```
+your-project/
+├── skills/                    # Downloaded skills
+│   ├── skill-1/
+│   └── skill-2/
+├── .claude/skills/            # Claude symlinks
+│   ├── skill-1 -> ../../skills/skill-1
+│   └── skill-2 -> ../../skills/skill-2
+└── .trae/skills/              # Trae symlinks
+    ├── skill-1 -> ../../skills/skill-1
+    └── skill-2 -> ../../skills/skill-2
+```
+
+## 🎯 Supported IDEs
+
+| IDE | Skill Directory |
+|-----|-----------------|
+| 🤖 Claude | `.claude/skills/` |
+| 🚀 Trae | `.trae/skills/` |
+
+## 🔧 Development
+
+```bash
+# Clone and install
+git clone https://github.com/supertiny99/easy-skill.git
+cd easy-skill
+npm install
+
+# Build and link globally
+npm run build
+npm link
+
+# Run in dev mode
+npm run dev
+```
+
+## 📦 Release
+
+```bash
+# Patch release (1.0.0 -> 1.0.1)
+npm run release:patch
+
+# Minor release (1.0.0 -> 1.1.0)
+npm run release:minor
+
+# Major release (1.0.0 -> 2.0.0)
+npm run release:major
+```
+
+## 📄 License
+
+MIT © [supertiny99](https://github.com/supertiny99)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const prompts_1 = __importDefault(require("prompts"));
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const quick_select_1 = require("./ui/quick-select");
+const downloader_1 = require("./lib/skill/downloader");
+const linker_1 = require("./lib/skill/linker");
+const SKILLS_DIR = 'skills';
+const program = new commander_1.Command();
+program
+    .name('easy-skill')
+    .description('TUI tool for managing skills - download, organize and create symlinks')
+    .version('1.0.0');
+// Default action: TUI quick select
+program
+    .action(async () => {
+    await (0, quick_select_1.quickSelect)();
+});
+// Download command
+program
+    .command('download <url>')
+    .alias('dl')
+    .description('Download a skill from git repository')
+    .option('-b, --branch <branch>', 'Git branch')
+    .option('-s, --subdir <subdir>', 'Subdirectory in the repository')
+    .option('-i, --id <id>', 'Skill ID (folder name)')
+    .option('-l, --link', 'Create symlinks after download')
+    .action(async (url, options) => {
+    try {
+        const skillId = options.id || path_1.default.basename(url, '.git').replace(/^skill-/, '');
+        const targetDir = path_1.default.join(process.cwd(), SKILLS_DIR);
+        const source = {
+            type: 'git',
+            url,
+            branch: options.branch,
+            subdir: options.subdir
+        };
+        if (await (0, downloader_1.skillExists)(targetDir, skillId)) {
+            const { overwrite } = await (0, prompts_1.default)({
+                type: 'confirm',
+                name: 'overwrite',
+                message: `Skill "${skillId}" exists. Overwrite?`,
+                initial: false
+            });
+            if (!overwrite) {
+                console.log(chalk_1.default.yellow('Cancelled'));
+                return;
+            }
+        }
+        console.log(chalk_1.default.blue(`Downloading skill "${skillId}"...`));
+        const skill = await (0, downloader_1.downloadSkill)(source, targetDir, skillId);
+        console.log(chalk_1.default.green(`✓ Downloaded to: ${skill.localPath}`));
+        if (options.link) {
+            for (const ide of linker_1.SUPPORTED_IDES) {
+                try {
+                    const link = await (0, linker_1.linkSkillToIDE)(skill.localPath, skillId, ide);
+                    console.log(chalk_1.default.green(`✓ Linked to ${ide}: ${link.targetPath}`));
+                }
+                catch (err) {
+                    console.error(chalk_1.default.red(`✗ Failed to link to ${ide}: ${err.message}`));
+                }
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+// Link command
+program
+    .command('link <skill-id>')
+    .description('Create symlinks for a skill')
+    .option('--claude', 'Link to .claude/skills')
+    .option('--trae', 'Link to .trae/skills')
+    .option('-a, --all', 'Link to all supported IDEs')
+    .action(async (skillId, options) => {
+    try {
+        const targetDir = path_1.default.join(process.cwd(), SKILLS_DIR);
+        const skillPath = path_1.default.join(targetDir, skillId);
+        if (!(await fs_extra_1.default.pathExists(skillPath))) {
+            console.error(chalk_1.default.red(`Skill "${skillId}" not found in ${SKILLS_DIR}/`));
+            process.exit(1);
+        }
+        let ides = [];
+        if (options.all) {
+            ides = [...linker_1.SUPPORTED_IDES];
+        }
+        else {
+            if (options.claude)
+                ides.push('claude');
+            if (options.trae)
+                ides.push('trae');
+        }
+        if (ides.length === 0) {
+            ides = [...linker_1.SUPPORTED_IDES]; // Default to all
+        }
+        for (const ide of ides) {
+            try {
+                const link = await (0, linker_1.linkSkillToIDE)(skillPath, skillId, ide);
+                console.log(chalk_1.default.green(`✓ Linked to ${ide}: ${link.targetPath}`));
+            }
+            catch (err) {
+                console.error(chalk_1.default.red(`✗ Failed to link to ${ide}: ${err.message}`));
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+// Unlink command
+program
+    .command('unlink <skill-id>')
+    .description('Remove symlinks for a skill')
+    .option('--claude', 'Unlink from .claude/skills')
+    .option('--trae', 'Unlink from .trae/skills')
+    .option('-a, --all', 'Unlink from all IDEs')
+    .action(async (skillId, options) => {
+    try {
+        let ides = [];
+        if (options.all) {
+            ides = [...linker_1.SUPPORTED_IDES];
+        }
+        else {
+            if (options.claude)
+                ides.push('claude');
+            if (options.trae)
+                ides.push('trae');
+        }
+        if (ides.length === 0) {
+            ides = [...linker_1.SUPPORTED_IDES];
+        }
+        for (const ide of ides) {
+            const status = await (0, linker_1.checkSymlinkStatus)(skillId, ide);
+            if (status.exists) {
+                await (0, linker_1.unlinkSkillFromIDE)(skillId, ide);
+                console.log(chalk_1.default.green(`✓ Unlinked from ${ide}`));
+            }
+            else {
+                console.log(chalk_1.default.gray(`  Not linked to ${ide}`));
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+// List command
+program
+    .command('list')
+    .alias('ls')
+    .description('List all skills and their links')
+    .action(async () => {
+    try {
+        const targetDir = path_1.default.join(process.cwd(), SKILLS_DIR);
+        const skills = await (0, downloader_1.listLocalSkills)(targetDir);
+        console.log(chalk_1.default.bold('\n📦 Local Skills:'));
+        if (skills.length === 0) {
+            console.log(chalk_1.default.gray('  No skills found'));
+        }
+        else {
+            for (const skillId of skills) {
+                console.log(`  - ${chalk_1.default.cyan(skillId)}`);
+                for (const ide of linker_1.SUPPORTED_IDES) {
+                    const status = await (0, linker_1.checkSymlinkStatus)(skillId, ide);
+                    if (status.exists) {
+                        const icon = status.valid ? chalk_1.default.green('✓') : chalk_1.default.red('✗');
+                        console.log(chalk_1.default.gray(`      ${icon} ${ide}`));
+                    }
+                }
+            }
+        }
+        console.log(chalk_1.default.bold('\n🔗 IDE Links:'));
+        for (const ide of linker_1.SUPPORTED_IDES) {
+            const linkedSkills = await (0, linker_1.getLinkedSkills)(ide);
+            console.log(chalk_1.default.cyan(`  ${ide}:`));
+            if (linkedSkills.length === 0) {
+                console.log(chalk_1.default.gray('    No skills linked'));
+            }
+            else {
+                for (const link of linkedSkills) {
+                    const valid = link.sourcePath && await fs_extra_1.default.pathExists(link.sourcePath);
+                    const icon = valid ? chalk_1.default.green('✓') : chalk_1.default.red('✗');
+                    console.log(`    ${icon} ${link.skillId}`);
+                }
+            }
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+// Remove command
+program
+    .command('remove <skill-id>')
+    .alias('rm')
+    .description('Remove a skill and its symlinks')
+    .option('-f, --force', 'Skip confirmation')
+    .action(async (skillId, options) => {
+    try {
+        const targetDir = path_1.default.join(process.cwd(), SKILLS_DIR);
+        if (!(await (0, downloader_1.skillExists)(targetDir, skillId))) {
+            console.error(chalk_1.default.red(`Skill "${skillId}" not found`));
+            process.exit(1);
+        }
+        if (!options.force) {
+            const { confirm } = await (0, prompts_1.default)({
+                type: 'confirm',
+                name: 'confirm',
+                message: `Remove skill "${skillId}" and its symlinks?`,
+                initial: false
+            });
+            if (!confirm) {
+                console.log(chalk_1.default.yellow('Cancelled'));
+                return;
+            }
+        }
+        // Remove symlinks
+        for (const ide of linker_1.SUPPORTED_IDES) {
+            const status = await (0, linker_1.checkSymlinkStatus)(skillId, ide);
+            if (status.exists) {
+                await (0, linker_1.unlinkSkillFromIDE)(skillId, ide);
+                console.log(chalk_1.default.gray(`  Unlinked from ${ide}`));
+            }
+        }
+        // Remove skill
+        await (0, downloader_1.removeSkill)(targetDir, skillId);
+        console.log(chalk_1.default.green(`✓ Removed skill "${skillId}"`));
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`Error: ${err.message}`));
+        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/lib/skill/downloader.d.ts

@@ -0,0 +1,5 @@
+import { SkillSource, SkillInfo } from './schema';
+export declare function downloadSkill(source: SkillSource, targetDir: string, skillId: string): Promise<SkillInfo>;
+export declare function skillExists(targetDir: string, skillId: string): Promise<boolean>;
+export declare function removeSkill(targetDir: string, skillId: string): Promise<void>;
+export declare function listLocalSkills(targetDir: string): Promise<string[]>;

package/dist/lib/skill/downloader.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadSkill = downloadSkill;
+exports.skillExists = skillExists;
+exports.removeSkill = removeSkill;
+exports.listLocalSkills = listLocalSkills;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const simple_git_1 = __importDefault(require("simple-git"));
+const git = (0, simple_git_1.default)();
+async function downloadSkill(source, targetDir, skillId) {
+    const skillPath = path_1.default.join(targetDir, skillId);
+    if (source.type === 'git') {
+        return downloadFromGit(source, skillPath, skillId);
+    }
+    else if (source.type === 'local') {
+        return copyFromLocal(source, skillPath, skillId);
+    }
+    else {
+        throw new Error(`Unsupported source type: ${source.type}`);
+    }
+}
+async function downloadFromGit(source, targetPath, skillId) {
+    // Ensure parent directory exists
+    await fs_extra_1.default.ensureDir(path_1.default.dirname(targetPath));
+    // Remove existing if present
+    if (await fs_extra_1.default.pathExists(targetPath)) {
+        await fs_extra_1.default.remove(targetPath);
+    }
+    // Clone repository
+    const cloneOptions = ['--depth', '1'];
+    if (source.branch) {
+        cloneOptions.push('--branch', source.branch);
+    }
+    await git.clone(source.url, targetPath, cloneOptions);
+    // If subdir specified, move contents up
+    if (source.subdir) {
+        const subdirPath = path_1.default.join(targetPath, source.subdir);
+        if (await fs_extra_1.default.pathExists(subdirPath)) {
+            const tempPath = `${targetPath}_temp`;
+            await fs_extra_1.default.move(subdirPath, tempPath);
+            await fs_extra_1.default.remove(targetPath);
+            await fs_extra_1.default.move(tempPath, targetPath);
+        }
+    }
+    // Remove .git folder to save space
+    const gitDir = path_1.default.join(targetPath, '.git');
+    if (await fs_extra_1.default.pathExists(gitDir)) {
+        await fs_extra_1.default.remove(gitDir);
+    }
+    return {
+        id: skillId,
+        name: skillId,
+        source,
+        localPath: targetPath
+    };
+}
+async function copyFromLocal(source, targetPath, skillId) {
+    const sourcePath = source.subdir
+        ? path_1.default.join(source.url, source.subdir)
+        : source.url;
+    if (!(await fs_extra_1.default.pathExists(sourcePath))) {
+        throw new Error(`Source path not found: ${sourcePath}`);
+    }
+    await fs_extra_1.default.ensureDir(path_1.default.dirname(targetPath));
+    if (await fs_extra_1.default.pathExists(targetPath)) {
+        await fs_extra_1.default.remove(targetPath);
+    }
+    await fs_extra_1.default.copy(sourcePath, targetPath);
+    return {
+        id: skillId,
+        name: skillId,
+        source,
+        localPath: targetPath
+    };
+}
+async function skillExists(targetDir, skillId) {
+    const skillPath = path_1.default.join(targetDir, skillId);
+    return fs_extra_1.default.pathExists(skillPath);
+}
+async function removeSkill(targetDir, skillId) {
+    const skillPath = path_1.default.join(targetDir, skillId);
+    if (await fs_extra_1.default.pathExists(skillPath)) {
+        await fs_extra_1.default.remove(skillPath);
+    }
+}
+async function listLocalSkills(targetDir) {
+    if (!(await fs_extra_1.default.pathExists(targetDir))) {
+        return [];
+    }
+    const entries = await fs_extra_1.default.readdir(targetDir, { withFileTypes: true });
+    return entries
+        .filter(entry => entry.isDirectory())
+        .map(entry => entry.name);
+}
+//# sourceMappingURL=downloader.js.map

package/dist/lib/skill/downloader.js.map

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

package/dist/lib/skill/explorer.d.ts

@@ -0,0 +1,31 @@
+export interface RemoteBranch {
+    name: string;
+    isDefault: boolean;
+}
+export interface SkillCandidate {
+    name: string;
+    path: string;
+    hasSkillFile: boolean;
+    description?: string;
+}
+export interface RepoExploreResult {
+    branches: RemoteBranch[];
+    skills: SkillCandidate[];
+    tempPath: string;
+}
+/**
+ * Get remote branches from a Git repository URL
+ */
+export declare function getRemoteBranches(url: string): Promise<RemoteBranch[]>;
+/**
+ * Clone repository to temp directory and explore its structure
+ */
+export declare function exploreRepository(url: string, branch?: string): Promise<RepoExploreResult>;
+/**
+ * Copy skill from temp explore directory to target
+ */
+export declare function copySkillFromExplore(tempPath: string, skillPath: string, targetDir: string, skillId: string): Promise<string>;
+/**
+ * Cleanup temp explore directory
+ */
+export declare function cleanupExplore(tempPath: string): Promise<void>;