codeskill 1.0.2

package/README.md

@@ -0,0 +1,82 @@
+# codeskill
+
+CLI tool to initialize and manage skill packages.
+
+## Installation
+
+```bash
+npm install -g codeskill
+```
+
+Or use directly with npx:
+
+```bash
+npx codeskill --help
+```
+
+## Usage
+
+```
+Usage: codeskill <command> [options]
+
+Commands:
+  init [name]       Initialize a skill (creates <name>/SKILL.md or ./SKILL.md)
+  add <package>     Add a skill package
+  get <package>     Alias for add
+  install <package> Alias for add
+                    e.g. anthropics/skills
+                         https://github.com/anthropics/skills
+
+Options:
+  --help, -h        Show this help message
+  --version, -v     Show version number
+```
+
+## Commands
+
+### init
+
+Initialize a new skill with a `SKILL.md` template.
+
+```bash
+# Create SKILL.md in current directory
+codeskill init
+
+# Create my-skill/SKILL.md
+codeskill init my-skill
+```
+
+### add / get / install
+
+Add a skill package from GitHub. The package will be cloned into the `skills/` directory.
+
+`get` and `install` are aliases for `add`.
+
+```bash
+# Using shorthand format
+codeskill add anthropics/skills
+codeskill get anthropics/skills
+codeskill install anthropics/skills
+
+# Using full URL
+codeskill add https://github.com/anthropics/skills
+```
+
+## Examples
+
+```bash
+# Initialize a new skill project
+$ codeskill init my-awesome-skill
+✓ Created directory: my-awesome-skill/
+✓ Created my-awesome-skill/SKILL.md
+
+# Add an existing skill package
+$ codeskill add anthropics/skills
+Adding skill package: anthropics/skills
+Cloning from: https://github.com/anthropics/skills.git
+✓ Added skill package to: skills/agent-skills
+```
+
+## License
+
+MIT

package/bin/codeskill.js

@@ -0,0 +1,691 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const { writeFileSync, existsSync, mkdirSync, rmSync, cpSync, readdirSync, readFileSync } = require('fs');
+const { basename, join, dirname, relative } = require('path');
+const os = require('os');
+const prompts = require('prompts');
+
+const VERSION = '1.0.0';
+
+// Detect system language
+function getSystemLanguage() {
+  // Method 1: Check environment variables (Unix/Linux/macOS)
+  const envLang = process.env.LANG || process.env.LC_ALL || process.env.LC_MESSAGES || '';
+  if (envLang.toLowerCase().includes('zh') || envLang.toLowerCase().includes('cn')) {
+    return 'zh';
+  }
+  
+  // Method 2: Check Intl API (works on all platforms)
+  try {
+    const locale = Intl.DateTimeFormat().resolvedOptions().locale;
+    if (locale.toLowerCase().startsWith('zh')) {
+      return 'zh';
+    }
+  } catch (e) {
+    // Fallback if Intl is not available
+  }
+  
+  // Method 3: Check Windows locale (Windows specific)
+  if (process.platform === 'win32') {
+    const userLang = process.env.LANG || process.env.LANGUAGE || '';
+    if (userLang.toLowerCase().includes('zh') || userLang.toLowerCase().includes('cn')) {
+      return 'zh';
+    }
+  }
+  
+  return 'en';
+}
+
+const isChinese = getSystemLanguage() === 'zh';
+
+// Translations
+const t = {
+  banner: {
+    ecosystem: isChinese ? 'Share skills. Build together.' : 'Share skills. Build together.',
+    try: isChinese ? '试试：' : 'try:',
+    discover: isChinese ? '在以下地址发现更多技能：' : 'Discover more skills at'
+  },
+  help: {
+    usage: isChinese ? '用法' : 'Usage',
+    commands: isChinese ? '命令' : 'Commands',
+    options: isChinese ? '选项' : 'Options',
+    examples: isChinese ? '示例' : 'Examples',
+    initDesc: isChinese ? '初始化一个技能（创建 <name>/SKILL.md 或 ./SKILL.md）' : 'Initialize a skill (creates <name>/SKILL.md or ./SKILL.md)',
+    addDesc: isChinese ? '添加技能包' : 'Add a skill package',
+    skillDesc: isChinese ? '指定要安装的技能（逗号分隔，跳过选择）' : 'Specify skill(s) to install (comma-separated, skip selection)',
+    pathDesc: isChinese ? '指定安装目录（用于 init）' : 'Specify installation directory (for init)',
+    helpDesc: isChinese ? '显示此帮助信息' : 'Show this help message',
+    versionDesc: isChinese ? '显示版本号' : 'Show version number'
+  },
+  skills: {
+    foundOne: isChinese ? '发现 1 个技能：' : 'Found 1 skill:',
+    foundMany: isChinese ? '在此仓库中发现' : 'Found',
+    skillsInRepo: isChinese ? '个技能' : 'skills in this repository',
+    selectSkills: isChinese ? '选择要安装的技能' : 'Select skills to install',
+    noSkillsSelected: isChinese ? '未选择技能。退出。' : 'No skills selected. Exiting.',
+    noSkillsFound: isChinese ? '在此仓库中未找到 SKILL.md 文件' : 'No SKILL.md files found in this repository',
+    installAsSingle: isChinese ? '整个仓库将作为单个技能安装。' : 'The entire repository will be installed as a single skill.',
+    noMatching: isChinese ? '未找到匹配的技能：' : 'No matching skills found for:',
+    availableSkills: isChinese ? '可用技能：' : 'Available skills:',
+    selected: isChinese ? '已选择' : 'Selected',
+    skill: isChinese ? '个技能：' : 'skill(s):'
+  },
+  agents: {
+    selectAgents: isChinese ? '选择要安装技能的 AI 助手' : 'Select agents to install skills to',
+    noAgentsSelected: isChinese ? '未选择 AI 助手。退出。' : 'No agents selected. Exiting.'
+  },
+  add: {
+    invalidFormat: isChinese ? '错误：无效的包格式：' : 'Error: Invalid package format:',
+    expectedFormats: isChinese ? '预期格式：' : 'Expected formats:',
+    fetching: isChinese ? '正在获取' : 'Fetching',
+    failedToClone: isChinese ? '错误：克隆仓库失败' : 'Error: Failed to clone repository',
+    makeSureAccessible: isChinese ? '请确保仓库存在且可访问。' : 'Make sure the repository exists and is accessible.',
+    skipped: isChinese ? '已跳过' : 'Skipped',
+    alreadyExists: isChinese ? '：已存在' : ': already exists',
+    installed: isChinese ? '已安装' : 'Installed',
+    to: isChinese ? '到' : 'to',
+    successfullyInstalled: isChinese ? '成功安装' : 'Successfully installed',
+    skill: isChinese ? '个技能到' : 'skill(s) to',
+    agent: isChinese ? '个 AI 助手' : 'agent(s)',
+    noNewInstallations: isChinese ? '没有新安装。技能可能已存在。' : 'No new installations. Skills may already exist.',
+    viewSkill: isChinese ? '查看技能：' : 'View the skill at',
+    discoverMore: isChinese ? '发现更多技能：' : 'Discover more skills at'
+  },
+  init: {
+    alreadyExists: isChinese ? '技能已存在于' : 'Skill already exists at',
+    initialized: isChinese ? '已初始化技能：' : 'Initialized skill:',
+    created: isChinese ? '已创建：' : 'Created:',
+    nextSteps: isChinese ? '下一步：' : 'Next steps:',
+    editToDefine: isChinese ? '编辑' : 'Edit',
+    toDefineInstructions: isChinese ? '以定义你的技能说明' : 'to define your skill instructions',
+    updateFrontmatter: isChinese ? '更新 frontmatter 中的' : 'Update the',
+    and: isChinese ? '和' : 'and',
+    inFrontmatter: isChinese ? '在 frontmatter 中' : 'in the frontmatter',
+    publishing: isChinese ? '发布：' : 'Publishing:',
+    pushToRepo: isChinese ? '推送到仓库，然后' : 'Push to a repo, then',
+    hostFile: isChinese ? '托管文件，然后' : 'Host the file, then',
+    browseForInspiration: isChinese ? '浏览现有技能以获取灵感：' : 'Browse existing skills for inspiration at'
+  },
+  error: {
+    specifyPackage: isChinese ? '错误：请指定要添加的包' : 'Error: Please specify a package to add',
+    example: isChinese ? '示例：' : 'Example:',
+    unknownCommand: isChinese ? '未知命令：' : 'Unknown command:',
+    runHelp: isChinese ? '运行' : 'Run',
+    forUsage: isChinese ? '查看用法。' : 'for usage.'
+  }
+};
+
+// Colors
+const RESET = '\x1B[0m';
+const BOLD = '\x1B[1m';
+const DIM = '\x1B[38;5;102m';
+const TEXT = '\x1B[38;5;145m';
+const GREEN = '\x1B[38;5;82m';
+const CYAN = '\x1B[38;5;87m';
+const YELLOW = '\x1B[38;5;220m';
+
+const LOGO_LINES = [
+  ' ██████  ██████  ██████  ███████ ███████ ██   ██ ██ ██      ██      ',
+  '██       ██   ██ ██   ██ ██      ██      ██  ██  ██ ██      ██      ',
+  '██       ██   ██ ██   ██ █████   ███████ █████   ██ ██      ██      ',
+  '██       ██   ██ ██   ██ ██           ██ ██  ██  ██ ██      ██      ',
+  ' ██████  ██████  ██████  ███████ ███████ ██   ██ ██ ███████ ███████ '
+];
+
+const GRAYS = [
+  '\x1B[38;5;250m',
+  '\x1B[38;5;248m',
+  '\x1B[38;5;245m',
+  '\x1B[38;5;243m',
+  '\x1B[38;5;240m'
+];
+
+// Platform detection
+const isWindows = process.platform === 'win32';
+const isMac = process.platform === 'darwin';
+const isLinux = process.platform === 'linux';
+
+// Get platform-specific path for an agent
+function getAgentSkillsPath(agentId) {
+  const home = os.homedir();
+  const appData = process.env.APPDATA || join(home, 'AppData', 'Roaming');
+  const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+  
+  const paths = {
+    claude: {
+      win32: join(home, '.claude', 'skills'),
+      darwin: join(home, '.claude', 'skills'),
+      linux: join(home, '.claude', 'skills')
+    },
+    cursor: {
+      win32: join(home, '.cursor', 'skills'),
+      darwin: join(home, '.cursor', 'skills'),
+      linux: join(home, '.cursor', 'skills')
+    },
+    opencode: {
+      win32: join(home, '.opencode', 'skills'),
+      darwin: join(home, '.opencode', 'skills'),
+      linux: join(home, '.opencode', 'skills')
+    },
+    trae: {
+      win32: join(localAppData, 'Trae', 'skills'),
+      darwin: join(home, '.trae', 'skills'),
+      linux: join(home, '.trae', 'skills')
+    },
+    windsurf: {
+      win32: join(home, '.windsurf', 'skills'),
+      darwin: join(home, '.windsurf', 'skills'),
+      linux: join(home, '.windsurf', 'skills')
+    }
+  };
+  
+  return paths[agentId]?.[process.platform] || join(home, `.${agentId}`, 'skills');
+}
+
+// Get display path (for showing to user)
+function getDisplayPath(agentId) {
+  const fullPath = getAgentSkillsPath(agentId);
+  const home = os.homedir();
+  
+  // Replace home directory with ~ for display
+  if (fullPath.startsWith(home)) {
+    return '~' + fullPath.slice(home.length).replace(/\\/g, '/');
+  }
+  return fullPath;
+}
+
+// AI Agent targets
+const AGENT_TARGETS = [
+  {
+    title: 'Claude Code',
+    value: 'claude'
+  },
+  {
+    title: 'Cursor',
+    value: 'cursor'
+  },
+  {
+    title: 'OpenCode',
+    value: 'opencode'
+  },
+  {
+    title: 'Trae',
+    value: 'trae'
+  },
+  {
+    title: 'Windsurf',
+    value: 'windsurf'
+  }
+];
+
+function showLogo() {
+  console.log();
+  LOGO_LINES.forEach((line, i) => {
+    console.log(`${GRAYS[i]}${line}${RESET}`);
+  });
+}
+
+function showBanner() {
+  showLogo();
+  console.log();
+  console.log(`${DIM}${t.banner.ecosystem}${RESET}`);
+  console.log();
+  console.log(`  ${DIM}$${RESET} ${TEXT}npx codeskill --help${RESET}`);
+  console.log(`  ${DIM}$${RESET} ${TEXT}npx codeskill init ${DIM}[name]${RESET}`);
+  console.log(`  ${DIM}$${RESET} ${TEXT}npx codeskill add ${DIM}[package]${RESET}`);
+  console.log();
+  console.log(`${DIM}${t.banner.try}${RESET} npx codeskill add anthropics/skills`);
+  console.log();
+  console.log(`${t.banner.discover} ${TEXT}https://codeskill.ai/${RESET}`);
+  console.log();
+}
+
+function showHelp() {
+  console.log(`
+${BOLD}${t.help.usage}${RESET}: codeskill <command> [options]
+
+${BOLD}${t.help.commands}${RESET}:
+  init [name]       ${t.help.initDesc}
+  add <package>     ${t.help.addDesc}
+  get <package>     ${isChinese ? 'add 的别名' : 'Alias for add'}
+  install <package> ${isChinese ? 'add 的别名' : 'Alias for add'}
+                    ${isChinese ? '例如：' : 'e.g.'} anthropics/skills
+                         https://github.com/anthropics/skills
+
+${BOLD}${t.help.options}${RESET}:
+  --skill, -s <name>  ${t.help.skillDesc}
+  --path, -p <dir>    ${t.help.pathDesc}
+  --help, -h          ${t.help.helpDesc}
+  --version, -v       ${t.help.versionDesc}
+
+${BOLD}${t.help.examples}${RESET}:
+  ${DIM}$${RESET} codeskill init my-skill
+  ${DIM}$${RESET} codeskill init my-skill --path ./custom/path
+  ${DIM}$${RESET} codeskill add anthropics/skills
+  ${DIM}$${RESET} codeskill add anthropics/skills --skill web-search
+  ${DIM}$${RESET} codeskill add anthropics/skills -s web-search,code-review
+
+${t.banner.discover} ${TEXT}https://codeskill.ai/${RESET}
+`);
+}
+
+function getOwnerRepo(pkg) {
+  const repoMatch = pkg.match(/^([^\/]+)\/([^\/]+)$/);
+  if (repoMatch && repoMatch[1] && repoMatch[2]) {
+    return { owner: repoMatch[1], repo: repoMatch[2] };
+  }
+  const githubMatch = pkg.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+  if (githubMatch && githubMatch[1] && githubMatch[2]) {
+    return { owner: githubMatch[1], repo: githubMatch[2].replace(/\.git$/, '') };
+  }
+  return null;
+}
+
+async function isRepoPublic(owner, repo) {
+  try {
+    const res = await fetch(`https://api.github.com/repos/${owner}/${repo}`);
+    if (!res.ok) return false;
+    const data = await res.json();
+    return data.private === false;
+  } catch {
+    return false;
+  }
+}
+
+// Parse skill name from SKILL.md frontmatter
+function parseSkillName(skillMdPath) {
+  try {
+    const content = readFileSync(skillMdPath, 'utf-8');
+    const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (frontmatterMatch) {
+      const nameMatch = frontmatterMatch[1].match(/^name:\s*(.+)$/m);
+      if (nameMatch) {
+        return nameMatch[1].trim();
+      }
+    }
+    // Fallback to directory name
+    return basename(dirname(skillMdPath));
+  } catch {
+    return basename(dirname(skillMdPath));
+  }
+}
+
+// Discover all skills (SKILL.md files) in a directory
+function discoverSkills(repoDir) {
+  const skills = [];
+  
+  function scan(dir, depth = 0) {
+    if (depth > 5) return; // Max depth to prevent infinite loops
+    
+    try {
+      const items = readdirSync(dir, { withFileTypes: true });
+      
+      for (const item of items) {
+        if (item.name === 'node_modules' || item.name === '.git' || item.name.startsWith('.')) {
+          continue;
+        }
+        
+        const fullPath = join(dir, item.name);
+        
+        if (item.isDirectory()) {
+          // Check if this directory has a SKILL.md
+          const skillMd = join(fullPath, 'SKILL.md');
+          if (existsSync(skillMd)) {
+            const skillName = parseSkillName(skillMd);
+            skills.push({
+              name: skillName,
+              dirName: item.name,
+              path: fullPath,
+              relativePath: relative(repoDir, fullPath)
+            });
+          }
+          // Continue scanning subdirectories
+          scan(fullPath, depth + 1);
+        }
+      }
+    } catch (e) {
+      // Ignore errors
+    }
+  }
+  
+  // Check if root directory has SKILL.md
+  const rootSkillMd = join(repoDir, 'SKILL.md');
+  if (existsSync(rootSkillMd)) {
+    const skillName = parseSkillName(rootSkillMd);
+    skills.push({
+      name: skillName,
+      dirName: basename(repoDir),
+      path: repoDir,
+      relativePath: '.',
+      isRoot: true
+    });
+  }
+  
+  scan(repoDir);
+  return skills;
+}
+
+// Prompt user to select which skills to install
+async function selectSkills(skills) {
+  if (skills.length === 0) {
+    return [];
+  }
+  
+  if (skills.length === 1) {
+    console.log(`${TEXT}${t.skills.foundOne} ${CYAN}${skills[0].name}${RESET}`);
+    return skills;
+  }
+  
+  console.log(`${TEXT}${t.skills.foundMany} ${YELLOW}${skills.length}${TEXT} ${t.skills.skillsInRepo}${RESET}`);
+  console.log();
+  
+  const response = await prompts({
+    type: 'multiselect',
+    name: 'skills',
+    message: t.skills.selectSkills,
+    choices: skills.map(skill => ({
+      title: `${skill.name} ${DIM}(${skill.relativePath})${RESET}`,
+      value: skill,
+      selected: true // Default select all
+    })),
+    hint: '- Space to select. Return to submit',
+    instructions: false,
+    min: 1
+  });
+
+  if (!response.skills || response.skills.length === 0) {
+    console.log(`${DIM}${t.skills.noSkillsSelected}${RESET}`);
+    process.exit(0);
+  }
+
+  return response.skills;
+}
+
+// Prompt user to select which agents to install skills to
+async function selectAgents() {
+  console.log();
+  
+  const response = await prompts({
+    type: 'multiselect',
+    name: 'agents',
+    message: t.agents.selectAgents,
+    choices: AGENT_TARGETS.map(agent => ({
+      title: `${agent.title} ${DIM}(${getDisplayPath(agent.value)})${RESET}`,
+      value: agent,
+      selected: agent.value === 'cursor' || agent.value === 'claude' // Default select Cursor and Claude
+    })),
+    hint: '- Space to select. Return to submit',
+    instructions: false,
+    min: 1
+  });
+
+  if (!response.agents || response.agents.length === 0) {
+    console.log(`${DIM}${t.agents.noAgentsSelected}${RESET}`);
+    process.exit(0);
+  }
+
+  return response.agents;
+}
+
+async function runAddSkill(pkg, specifiedSkills) {
+  const info = getOwnerRepo(pkg);
+  if (!info) {
+    console.log(`${RESET}${t.add.invalidFormat} ${pkg}`);
+    console.log();
+    console.log(`${DIM}${t.add.expectedFormats}${RESET}`);
+    console.log(`  owner/repo`);
+    console.log(`  https://github.com/owner/repo`);
+    process.exit(1);
+  }
+
+  const { owner, repo } = info;
+  const url = `https://github.com/${owner}/${repo}.git`;
+
+  // 1. Clone to temp directory first
+  const tempDir = join(os.tmpdir(), `codeskill-${repo}-${Date.now()}`);
+  
+  console.log(`${TEXT}${t.add.fetching} ${DIM}${owner}/${repo}${TEXT}...${RESET}`);
+  
+  try {
+    execSync(`git clone --depth 1 ${url} "${tempDir}"`, { stdio: 'pipe' });
+  } catch (error) {
+    console.log(`${RESET}${t.add.failedToClone}${RESET}`);
+    console.log(`${DIM}${t.add.makeSureAccessible}${RESET}`);
+    process.exit(1);
+  }
+
+  // Remove .git directory from cloned repo
+  const gitDir = join(tempDir, '.git');
+  if (existsSync(gitDir)) {
+    rmSync(gitDir, { recursive: true, force: true });
+  }
+
+  console.log();
+
+  // 2. Discover all skills in the repo
+  const allSkills = discoverSkills(tempDir);
+  
+  if (allSkills.length === 0) {
+    console.log(`${YELLOW}⚠${RESET} ${TEXT}${t.skills.noSkillsFound}${RESET}`);
+    console.log(`${DIM}${t.skills.installAsSingle}${RESET}`);
+    // Treat the whole repo as a single skill
+    allSkills.push({
+      name: repo,
+      dirName: repo,
+      path: tempDir,
+      relativePath: '.',
+      isRoot: true
+    });
+  }
+
+  // 3. Select skills (via --skill flag or interactive)
+  let selectedSkills;
+  
+  if (specifiedSkills && specifiedSkills.length > 0) {
+    // Filter skills by specified names
+    selectedSkills = allSkills.filter(skill => 
+      specifiedSkills.some(s => 
+        s.toLowerCase() === skill.name.toLowerCase() || 
+        s.toLowerCase() === skill.dirName.toLowerCase()
+      )
+    );
+    
+      if (selectedSkills.length === 0) {
+        console.log(`${YELLOW}⚠${RESET} ${TEXT}${t.skills.noMatching} ${specifiedSkills.join(', ')}${RESET}`);
+        console.log();
+        console.log(`${DIM}${t.skills.availableSkills}${RESET}`);
+        allSkills.forEach(s => console.log(`  - ${s.name} (${s.relativePath})`));
+        rmSync(tempDir, { recursive: true, force: true });
+        process.exit(1);
+      }
+      
+      console.log(`${TEXT}${t.skills.selected} ${selectedSkills.length} ${t.skills.skill} ${selectedSkills.map(s => s.name).join(', ')}${RESET}`);
+  } else {
+    // Interactive selection
+    selectedSkills = await selectSkills(allSkills);
+  }
+
+  // 4. Select agents
+  const selectedAgents = await selectAgents();
+  
+  console.log();
+
+  // 5. Copy selected skills to each selected agent's skills directory
+  let installedCount = 0;
+  
+  for (const agent of selectedAgents) {
+    const agentSkillsDir = getAgentSkillsPath(agent.value);
+    const displayBasePath = getDisplayPath(agent.value);
+
+    // Create skills directory if it doesn't exist
+    if (!existsSync(agentSkillsDir)) {
+      mkdirSync(agentSkillsDir, { recursive: true });
+    }
+
+    for (const skill of selectedSkills) {
+      const skillDirName = skill.isRoot ? repo : skill.dirName;
+      const targetDir = join(agentSkillsDir, skillDirName);
+
+      if (existsSync(targetDir)) {
+        console.log(`${DIM}⚠ ${t.add.skipped} ${agent.title}/${skill.name}${t.add.alreadyExists}${RESET}`);
+        continue;
+      }
+
+      // Copy the skill
+      cpSync(skill.path, targetDir, { recursive: true });
+      console.log(`${GREEN}✓${RESET} ${TEXT}${t.add.installed} ${CYAN}${skill.name}${RESET} ${t.add.to} ${CYAN}${agent.title}${RESET} ${DIM}(${displayBasePath}/${skillDirName})${RESET}`);
+      installedCount++;
+    }
+  }
+
+  // 6. Clean up temp directory
+  rmSync(tempDir, { recursive: true, force: true });
+
+  // 7. Show summary
+  console.log();
+  if (installedCount > 0) {
+    console.log(`${GREEN}✓${RESET} ${TEXT}${t.add.successfullyInstalled} ${BOLD}${selectedSkills.length}${RESET}${TEXT} ${t.add.skill} ${BOLD}${selectedAgents.length}${RESET}${TEXT} ${t.add.agent}${RESET}`);
+  } else {
+    console.log(`${DIM}${t.add.noNewInstallations}${RESET}`);
+  }
+
+  console.log();
+  if (await isRepoPublic(owner, repo)) {
+    console.log(`${DIM}${t.add.viewSkill}${RESET} ${TEXT}https://codeskill.ai/${owner}/${repo}${RESET}`);
+  } else {
+    console.log(`${DIM}${t.add.discoverMore}${RESET} ${TEXT}https://codeskill.ai/${RESET}`);
+  }
+  console.log();
+}
+
+function runInit(name, customPath) {
+  const baseDir = customPath ? join(process.cwd(), customPath) : process.cwd();
+  const skillName = name || basename(baseDir);
+  const hasName = name !== undefined;
+  const skillDir = hasName ? join(baseDir, skillName) : baseDir;
+  const skillFile = join(skillDir, 'SKILL.md');
+  
+  // Calculate display path relative to cwd
+  const relativePath = customPath 
+    ? (hasName ? join(customPath, skillName, 'SKILL.md') : join(customPath, 'SKILL.md'))
+    : (hasName ? `${skillName}/SKILL.md` : 'SKILL.md');
+  const displayPath = relativePath;
+
+  if (existsSync(skillFile)) {
+    console.log(`${TEXT}${t.init.alreadyExists} ${DIM}${displayPath}${RESET}`);
+    return;
+  }
+
+  // Create directory if needed (either custom path or named skill)
+  if (hasName || customPath) {
+    mkdirSync(skillDir, { recursive: true });
+  }
+
+  const skillContent = `---
+name: ${skillName}
+description: A brief description of what this skill does
+---
+
+# ${skillName}
+
+Instructions for the agent to follow when this skill is activated.
+
+## When to use
+
+Describe when this skill should be used.
+
+## Instructions
+`;
+
+  writeFileSync(skillFile, skillContent);
+  console.log(`${TEXT}${t.init.initialized} ${DIM}${skillName}${RESET}`);
+  console.log();
+  console.log(`${DIM}${t.init.created}${RESET}`);
+  console.log(`  ${displayPath}`);
+  console.log();
+  console.log(`${DIM}${t.init.nextSteps}${RESET}`);
+  console.log(`  1. ${t.init.editToDefine} ${TEXT}${displayPath}${RESET} ${t.init.toDefineInstructions}`);
+  console.log(`  2. ${t.init.updateFrontmatter} ${TEXT}name${RESET} ${t.init.and} ${TEXT}description${RESET} ${t.init.inFrontmatter}`);
+  console.log();
+  console.log(`${DIM}${t.init.publishing}${RESET}`);
+  console.log(`  ${DIM}GitHub:${RESET}  ${t.init.pushToRepo} ${TEXT}npx codeskill add <owner>/<repo>${RESET}`);
+  console.log(`  ${DIM}URL:${RESET}     ${t.init.hostFile} ${TEXT}npx codeskill add https://example.com/${displayPath}${RESET}`);
+  console.log();
+  console.log(`${t.init.browseForInspiration} ${TEXT}https://codeskill.ai/${RESET}`);
+  console.log();
+}
+
+function parseArgs(args) {
+  const result = {
+    positional: [],
+    path: null,
+    skills: null
+  };
+  
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--path' || args[i] === '-p') {
+      result.path = args[i + 1];
+      i++; // skip next arg
+    } else if (args[i] === '--skill' || args[i] === '-s') {
+      // Support comma-separated skills
+      const skillArg = args[i + 1];
+      if (skillArg) {
+        result.skills = skillArg.split(',').map(s => s.trim()).filter(Boolean);
+      }
+      i++; // skip next arg
+    } else if (!args[i].startsWith('-')) {
+      result.positional.push(args[i]);
+    }
+  }
+  
+  return result;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    showBanner();
+    return;
+  }
+
+  const command = args[0];
+  const restArgs = args.slice(1);
+  const parsed = parseArgs(restArgs);
+
+  switch (command) {
+    case 'init':
+      showLogo();
+      console.log();
+      runInit(parsed.positional[0], parsed.path);
+      break;
+    case 'i':
+    case 'install':
+    case 'a':
+    case 'add':
+    case 'get':
+      showLogo();
+      console.log();
+      if (!parsed.positional[0]) {
+        console.log(`${TEXT}${t.error.specifyPackage}${RESET}`);
+        console.log(`${DIM}${t.error.example} codeskill add anthropics/skills${RESET}`);
+        process.exit(1);
+      }
+      await runAddSkill(parsed.positional[0], parsed.skills);
+      break;
+    case '--help':
+    case '-h':
+      showHelp();
+      break;
+    case '--version':
+    case '-v':
+      console.log(VERSION);
+      break;
+    default:
+      console.log(`${t.error.unknownCommand} ${command}`);
+      console.log(`${t.error.runHelp} ${BOLD}codeskill --help${RESET} ${t.error.forUsage}`);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "codeskill",
+  "version": "1.0.2",
+  "description": "CLI tool to initialize and manage skill packages",
+  "bin": {
+    "codeskill": "./bin/codeskill.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "keywords": [
+    "cli",
+    "skill",
+    "agent",
+    "ai"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2"
+  }
+}