sk-get 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.1] - 2026-01-31
+### Added
+- 初始化项目结构，实现基础架构和核心功能。

package/README.md

@@ -0,0 +1,96 @@
+# sk-get
+
+一个简单高效的 CLI 工具，用于从指定的 Git 仓库安装 AI Agent Skills 到 Cursor、Claude 和 VSCode 中。
+
+## 功能
+
+- **多平台支持**: 一键安装 Skill 到 Cursor (本地/全局)、Claude (本地) 和 VSCode。
+- **Git 同步**: 自动从远程仓库同步最新的 Skills。
+- **本地缓存**: 缓存仓库内容，提高运行效率。
+- **VSCode 集成**: 自动将 Skill 指令提取并追加到 `.github/copilot-instructions.md`。
+
+## 安装
+
+你可以通过 npm 直接运行：
+
+```bash
+npx sk-get <command>
+```
+
+或者全局安装：
+
+```bash
+npm install -g sk-get
+```
+
+安装后，你可以使用 `sk-get` 或简写 `sg` 命令。
+
+## 用法
+
+### 设置仓库地址
+
+在使用之前，你需要设置包含 Skills 的 Git 仓库地址：
+
+```bash
+sg config set-repo <repository-url>
+```
+
+查看当前配置的仓库：
+
+```bash
+sg config get-repo
+```
+
+### 列出所有 Skill
+
+```bash
+sg ls
+```
+
+### 安装 Skill
+
+```bash
+sg install <skill-name> <platform> [options]
+```
+
+**支持的平台 (`platform`):**
+
+- `cursor`: 安装到 Cursor 的 skills 目录。
+- `claude`: 安装到 Claude 的 skills 目录。
+- `vscode`: 将 Skill 内容追加到 `.github/copilot-instructions.md`。
+
+**选项:**
+
+- `-g, --global`: 安装到全局目录（仅支持 `cursor` 和 `claude`）。如果不加此参数，默认安装到当前项目目录下。
+
+**示例:**
+
+```bash
+# 将 git-commit 技能安装到当前项目的 Cursor 中
+sg install git-commit cursor
+
+# 将 git-commit 技能全局安装到 Cursor 中
+sg install git-commit cursor --global
+
+# 将 hello-world 技能安装到 VSCode 配置中
+sg install hello-world vscode
+```
+
+## 仓库结构要求
+
+你的 Skills 仓库应遵循以下结构：
+
+```text
+.
+└── skills/
+    ├── skill-name-1/
+    │   └── SKILL.md
+    └── skill-name-2/
+        └── SKILL.md
+```
+
+每个 Skill 文件夹必须包含一个 `SKILL.md` 文件。
+
+## 许可证
+
+MIT

package/bin/skill-get.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "sk-get",
+  "version": "1.0.1",
+  "type": "module",
+  "bin": {
+    "sk-get": "./bin/skill-get.js",
+    "sg": "./bin/skill-get.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node src/index.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "conf": "^15.0.2",
+    "fs-extra": "^11.3.3",
+    "simple-git": "^3.30.0"
+  },
+  "devDependencies": {
+    "@types/conf": "^2.1.0",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.1.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}

package/src/commands/install.ts

@@ -0,0 +1,96 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { syncRepo, getAvailableSkills } from '../utils/git.js';
+import {
+  getLocalCursorSkillsDir,
+  getGlobalCursorSkillsDir,
+  getLocalClaudeSkillsDir,
+  getGlobalClaudeSkillsDir,
+  getVscodeInstructionsPath,
+} from '../utils/paths.js';
+
+export async function installCommand(
+  skillName: string,
+  platform: string,
+  options: { global: boolean }
+) {
+  try {
+    const cacheDir = await syncRepo();
+    const availableSkills = await getAvailableSkills(cacheDir);
+
+    if (!availableSkills.includes(skillName)) {
+      console.error(chalk.red(`Error: Skill "${skillName}" not found.`));
+      return;
+    }
+
+    const sourceDir = path.join(cacheDir, 'skills', skillName);
+    let targetDir = '';
+    let isVscode = false;
+
+    switch (platform.toLowerCase()) {
+      case 'cursor':
+        targetDir = options.global
+          ? getGlobalCursorSkillsDir()
+          : getLocalCursorSkillsDir();
+        break;
+      case 'claude':
+        targetDir = options.global
+          ? getGlobalClaudeSkillsDir()
+          : getLocalClaudeSkillsDir();
+        break;
+      case 'vscode':
+        isVscode = true;
+        if (options.global) {
+          console.warn(
+            chalk.yellow(
+              'Warning: VSCode does not support global instructions via skill-get yet. Installing to local .github/copilot-instructions.md'
+            )
+          );
+        }
+        break;
+      default:
+        console.error(
+          chalk.red(
+            `Error: Unsupported platform "${platform}". Use cursor, claude, or vscode.`
+          )
+        );
+        return;
+    }
+
+    if (isVscode) {
+      const vscodePath = getVscodeInstructionsPath();
+      const skillMdPath = path.join(sourceDir, 'SKILL.md');
+      
+      if (!(await fs.pathExists(skillMdPath))) {
+        console.error(chalk.red(`Error: SKILL.md not found in skill "${skillName}".`));
+        return;
+      }
+
+      const skillContent = await fs.readFile(skillMdPath, 'utf8');
+      await fs.ensureDir(path.dirname(vscodePath));
+      
+      let existingContent = '';
+      if (await fs.pathExists(vscodePath)) {
+        existingContent = await fs.readFile(vscodePath, 'utf8');
+      }
+
+      if (existingContent.includes(skillContent)) {
+        console.log(chalk.yellow(`Skill "${skillName}" is already installed in VSCode instructions.`));
+      } else {
+        const newContent = existingContent 
+          ? `${existingContent}\n\n--- \n\n# Skill: ${skillName}\n${skillContent}`
+          : `# Skill: ${skillName}\n${skillContent}`;
+        await fs.writeFile(vscodePath, newContent);
+        console.log(chalk.green(`Successfully installed skill "${skillName}" to ${vscodePath}`));
+      }
+    } else {
+      const targetSkillDir = path.join(targetDir, skillName);
+      await fs.ensureDir(targetDir);
+      await fs.copy(sourceDir, targetSkillDir);
+      console.log(chalk.green(`Successfully installed skill "${skillName}" to ${targetSkillDir}`));
+    }
+  } catch (error: any) {
+    console.error(chalk.red(`Error: ${error.message}`));
+  }
+}

package/src/commands/list.ts

@@ -0,0 +1,21 @@
+import chalk from 'chalk';
+import { syncRepo, getAvailableSkills } from '../utils/git.js';
+
+export async function listCommand() {
+  try {
+    const cacheDir = await syncRepo();
+    const skills = await getAvailableSkills(cacheDir);
+
+    if (skills.length === 0) {
+      console.log(chalk.yellow('No skills found in the repository.'));
+      return;
+    }
+
+    console.log(chalk.green('Available skills:'));
+    skills.forEach((skill) => {
+      console.log(` - ${skill}`);
+    });
+  } catch (error: any) {
+    console.error(chalk.red(`Error: ${error.message}`));
+  }
+}

package/src/index.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { listCommand } from './commands/list.js';
+import { installCommand } from './commands/install.js';
+import { setRepoUrl, getRepoUrl } from './utils/config.js';
+import chalk from 'chalk';
+
+const program = new Command();
+
+program
+  .name('sk-get')
+  .description('CLI tool to manage AI Agent Skills')
+  .version('1.0.0');
+
+program
+  .command('ls')
+  .description('List all available skills from the repository')
+  .action(listCommand);
+
+program
+  .command('install')
+  .description('Install a skill to a specific platform')
+  .argument('<skill-name>', 'Name of the skill to install')
+  .argument('<platform>', 'Target platform (cursor, claude, vscode)')
+  .option('-g, --global', 'Install to global directory instead of local', false)
+  .action((skillName, platform, options) => {
+    installCommand(skillName, platform, options);
+  });
+
+program
+  .command('config')
+  .description('Manage configuration')
+  .command('set-repo')
+  .argument('<url>', 'Repository URL')
+  .action((url) => {
+    setRepoUrl(url);
+    console.log(chalk.green(`Repository URL set to: ${url}`));
+  });
+
+program
+  .command('get-repo')
+  .description('Show current repository URL')
+  .action(() => {
+    console.log(chalk.blue(`Current repository URL: ${getRepoUrl()}`));
+  });
+
+program.parse(process.argv);

package/src/utils/config.ts

@@ -0,0 +1,12 @@
+import Conf from 'conf';
+
+const config = new Conf({
+  projectName: 'sk-get',
+  defaults: {
+    repoUrl: 'https://github.com/yxl/skiil.git'
+  }
+});
+
+export const getRepoUrl = () => config.get('repoUrl') as string;
+export const setRepoUrl = (url: string) => config.set('repoUrl', url);
+export default config;

package/src/utils/git.ts

@@ -0,0 +1,42 @@
+import { simpleGit, SimpleGit } from 'simple-git';
+import fs from 'fs-extra';
+import { getCacheDir } from './paths.js';
+import { getRepoUrl } from './config.js';
+import chalk from 'chalk';
+
+export async function syncRepo(): Promise<string> {
+  const cacheDir = getCacheDir();
+  const repoUrl = getRepoUrl();
+
+  if (!repoUrl) {
+    throw new Error('Repository URL not configured. Use `skill-get config repoUrl <url>` to set it.');
+  }
+
+  if (!(await fs.pathExists(cacheDir))) {
+    console.log(chalk.blue(`Cloning repository ${repoUrl}...`));
+    await fs.ensureDir(cacheDir);
+    const git: SimpleGit = simpleGit();
+    await git.clone(repoUrl, cacheDir);
+  } else {
+    // console.log(chalk.blue('Updating repository...'));
+    const git: SimpleGit = simpleGit(cacheDir);
+    try {
+      await git.pull();
+    } catch (error) {
+      console.warn(chalk.yellow('Failed to pull updates, using cached version.'));
+    }
+  }
+
+  return cacheDir;
+}
+
+export async function getAvailableSkills(cacheDir: string): Promise<string[]> {
+  const skillsDir = `${cacheDir}/skills`;
+  if (!(await fs.pathExists(skillsDir))) {
+    return [];
+  }
+  const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+  return entries
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name);
+}

package/src/utils/paths.ts

@@ -0,0 +1,16 @@
+import path from 'path';
+import os from 'os';
+
+export const getHomeDir = () => os.homedir();
+
+export const getGlobalCursorSkillsDir = () => path.join(getHomeDir(), '.cursor', 'skills');
+
+export const getLocalCursorSkillsDir = (cwd: string = process.cwd()) => path.join(cwd, '.cursor', 'skills');
+
+export const getLocalClaudeSkillsDir = (cwd: string = process.cwd()) => path.join(cwd, '.claude', 'skills');
+
+export const getGlobalClaudeSkillsDir = () => path.join(getHomeDir(), '.claude', 'skills');
+
+export const getVscodeInstructionsPath = (cwd: string = process.cwd()) => path.join(cwd, '.github', 'copilot-instructions.md');
+
+export const getCacheDir = () => path.join(getHomeDir(), '.cache', 'sk-get');

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"]
+}