@bhoon716/skill-forge 1.0.0 → 1.0.1

package/README.ko.md

@@ -9,6 +9,9 @@
 <p align="center">
   <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
 </p>
+<p align="center">
+  📦 <a href="https://www.npmjs.com/package/@bhoon716/skill-forge">NPM Package</a>
+</p>
 ---
 
 **정성껏 깎아낸 AI 에이전트 스킬(Agent Skill)들을 한데 모으고 스마트하게 배포하는 작업공간입니다.**
@@ -71,19 +74,19 @@ skill-forge/
 ### 💡 명령어 실물 예시
 ```bash
 # 1. 특정 스킬을 한국어로 Codex/Gemini 프로젝트 로컬에 설치 (기본값)
-$ skill-forge add ultra-grill-me --lang ko
+$ skill-forge install ultra-grill-me --lang ko
 
 # 2. 특정 스킬을 한국어로 Claude Code 로컬 경로에 설치
-$ skill-forge add ultra-grill-me --lang ko --agent claude
+$ skill-forge install ultra-grill-me --lang ko --agent claude
 
 # 3. 특정 스킬을 영어로 Cursor 프로젝트 로컬 경로에 설치
-$ skill-forge add ultra-grill-me --lang en --agent cursor
+$ skill-forge install ultra-grill-me --lang en --agent cursor
 
 # 4. 글로벌 환경에 한국어 스킬로 전역 설치 (모든 워크스페이스 공유)
-$ skill-forge add ultra-grill-me --lang ko --agent global
+$ skill-forge install ultra-grill-me --lang ko --agent global
 
 # 5. 전체 스킬을 한국어 버전으로 한 번에 로컬 설치
-$ skill-forge install-all --lang ko --agent codex
+$ skill-forge install all --lang ko --agent codex
 ```
 
 ### ⚙️ 옵션 요약

package/README.md

@@ -9,6 +9,9 @@
 <p align="center">
   <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
 </p>
+<p align="center">
+  📦 <a href="https://www.npmjs.com/package/@bhoon716/skill-forge">NPM Package</a>
+</p>
 ---
 
 **A dedicated, professional workspace to craft, test, and distribute sharp, reusable AI Agent Skills.**
@@ -71,19 +74,19 @@ A built-in installer tool that automatically maps localized skill source files a
 ### 💡 CLI Usage Examples
 ```bash
 # 1. Install Korean version locally to Codex/Gemini directory (Default)
-$ skill-forge add ultra-grill-me --lang ko
+$ skill-forge install ultra-grill-me --lang ko
 
 # 2. Install Korean version locally to Claude Code directory
-$ skill-forge add ultra-grill-me --lang ko --agent claude
+$ skill-forge install ultra-grill-me --lang ko --agent claude
 
 # 3. Install English version locally to Cursor directory
-$ skill-forge add ultra-grill-me --lang en --agent cursor
+$ skill-forge install ultra-grill-me --lang en --agent cursor
 
 # 4. Install globally for all workspaces (English default)
-$ skill-forge add ultra-grill-me --lang en --agent global
+$ skill-forge install ultra-grill-me --lang en --agent global
 
 # 5. Install all skills in the forge workspace at once in Korean
-$ skill-forge install-all --lang ko --agent codex
+$ skill-forge install all --lang ko --agent codex
 ```
 
 ### ⚙️ Options List

package/README.zh.md

@@ -9,6 +9,9 @@
 <p align="center">
   <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
 </p>
+<p align="center">
+  📦 <a href="https://www.npmjs.com/package/@bhoon716/skill-forge">NPM Package</a>
+</p>
 ---
 
 **精心打磨的 AI Agent Skill 设计与智能分发工作空间。**
@@ -56,37 +59,37 @@ skill-forge/
 
 ---
 
-## 🚀 3. CLI 快速部署工具 (`skf` 或 `npx @bhoon716/skill-forge`)
+## 🚀 3. CLI 快速部署工具 (`skill-forge` 或 `npx @bhoon716/skill-forge`)
 
 通过轻量化 CLI 可以自动根据语言选项映射，并将 Skill 复制部署到对应的 Agent 本地或全局配置路径中。
 
 > [!TIP]
-> **只需 3 个字符即可轻松运行 (`skf`)**：
-> 您可以全局安装此工具，以便使用快捷命令 `skf` 立即启动交互式安装模式。
+> **全局命令更轻松运行 (`skill-forge`)**：
+> 您可以全局安装此工具，以便直接运行 `skill-forge` 启动交互式安装模式。
 > ```bash
 > # 1. 全局安装 (仅需一次)
 > $ npm install -g @bhoon716/skill-forge
 > 
 > # 2. 快捷运行交互式安装模式
-> $ skf
+> $ skill-forge
 > ```
 
 ### 💡 命令行实例
 ```bash
 # 1. 以中文版部署到本地默认项目路径 (Codex/Gemini)
-$ skf add ultra-grill-me --lang zh
+$ skill-forge install ultra-grill-me --lang zh
 
 # 2. 以中文版部署到本地 Claude Code 路径
-$ skf add ultra-grill-me --lang zh --agent claude
+$ skill-forge install ultra-grill-me --lang zh --agent claude
 
 # 3. 以英文版部署到本地 Cursor 路径
-$ skf add ultra-grill-me --lang en --agent cursor
+$ skill-forge install ultra-grill-me --lang en --agent cursor
 
 # 4. 以中文版全局部署到用户主目录 (全局生效)
-$ skf add ultra-grill-me --lang zh --agent global
+$ skill-forge install ultra-grill-me --lang zh --agent global
 
 # 5. 一键中文部署工作空间内的所有 Skill
-$ skf install-all --lang zh --agent codex
+$ skill-forge install all --lang zh --agent codex
 ```
 
 ### ⚙️ 选项说明

package/bin/cli.js

@@ -11,13 +11,14 @@ const sourceSkillsDir = path.join(__dirname, '..', 'skills');
 const def_usage = () => {
   console.log(`
 Usage: npx @bhoon716/skill-forge [command] [options]
+       (or use "skill-forge" globally after npm install -g)
 
 If run without arguments, launches Interactive Setup Mode.
 
 Commands:
   list                 List all available skills and their descriptions.
-  add <skill-name>     Install a specific skill from the forge workspace.
-  install-all          Install all available skills from the forge workspace.
+  install <name>       Install a specific skill from the forge workspace.
+                       Use "install all" to install all available skills.
 
 Options:
   -l, --lang <lang>    Specify localization language (e.g., en, ko, zh). (Default: en)
@@ -27,9 +28,9 @@ Options:
   -h, --help           Display help message.
 
 Examples:
-  npx @bhoon716/skill-forge list --lang ko
-  npx @bhoon716/skill-forge add ultra-grill-me --lang ko
-  npx @bhoon716/skill-forge add ultra-grill-me --lang zh --agent claude
+  skill-forge list --lang ko
+  skill-forge install ultra-grill-me --lang ko
+  skill-forge install all --lang zh --agent claude
 `);
 };
 
@@ -65,17 +66,14 @@ const listSkillsLogic = (selectedLang = 'en') => {
   }
 
   skills.forEach(skill => {
-    // Try to find localized SKILL file
     let skillFile = path.join(sourceSkillsDir, skill, `SKILL.${selectedLang}.md`);
     if (!fs.existsSync(skillFile)) {
-      skillFile = path.join(sourceSkillsDir, skill, 'SKILL.md'); // Fallback to default
+      skillFile = path.join(sourceSkillsDir, skill, 'SKILL.md');
     }
 
     let description = 'No description provided.';
     if (fs.existsSync(skillFile)) {
       const content = fs.readFileSync(skillFile, 'utf8');
-      
-      // Parse description from frontmatter
       const descMatch = content.match(/description:\s*(.*)/);
       if (descMatch && descMatch[1]) {
         description = descMatch[1].trim();
@@ -84,7 +82,7 @@ const listSkillsLogic = (selectedLang = 'en') => {
 
     console.log(`* ${skill.padEnd(20)} - ${description}`);
   });
-  console.log('\nUse "skill-forge add <skill-name>" to install a specific skill.\n');
+  console.log('\nUse "skill-forge install <skill-name>" to install a specific skill.\n');
 };
 
 // Interactive Mode Prompt
@@ -115,36 +113,51 @@ const runInteractiveMode = async () => {
   const question = (query) => new Promise((resolve) => rl.question(query, resolve));
 
   try {
-    // 1. Select Skill
-    console.log('Available Skills in Forge:');
-    skills.forEach((s, idx) => console.log(`  [${idx + 1}] ${s}`));
-    console.log(`  [${skills.length + 1}] (Install All Available Skills)`);
-    
-    let skillChoiceIdx = -1;
-    while (true) {
-      const ans = await question(`\nSelect a skill to install [1-${skills.length + 1}]: `);
-      const val = parseInt(ans.trim());
-      if (val >= 1 && val <= skills.length + 1) {
-        skillChoiceIdx = val - 1;
-        break;
+    let selectedSkill = null;
+    let installAll = false;
+
+    // 1. Select Skill (Skip if only 1 skill exists)
+    if (skills.length === 1) {
+      selectedSkill = skills[0];
+      console.log(`[Auto-selected Skill] Only 1 skill found: "${selectedSkill}"`);
+    } else {
+      console.log('Available Skills in Forge:');
+      skills.forEach((s, idx) => console.log(`  [${idx + 1}] ${s}`));
+      console.log(`  [${skills.length + 1}] (Install All Available Skills)`);
+      
+      while (true) {
+        const ans = await question(`\nSelect a skill to install [1-${skills.length + 1}]: `);
+        const val = parseInt(ans.trim());
+        if (val >= 1 && val <= skills.length + 1) {
+          if (val === skills.length + 1) {
+            installAll = true;
+          } else {
+            selectedSkill = skills[val - 1];
+          }
+          break;
+        }
+        console.log('Invalid choice. Please select a valid option number.');
       }
-      console.log('Invalid choice. Please select a valid option number.');
     }
 
-    const installAll = skillChoiceIdx === skills.length;
-    const selectedSkill = installAll ? null : skills[skillChoiceIdx];
+    // 2. Select Language (Detect OS language environment)
+    const envLang = process.env.LANG || '';
+    const isKoreanEnv = envLang.toLowerCase().includes('ko') || envLang.toLowerCase().includes('korean');
+    const defaultLangCode = isKoreanEnv ? 'ko' : 'en';
 
-    // 2. Select Language
     console.log('\nSelect localization language:');
-    console.log('  [1] English (en) - Default');
-    console.log('  [2] 한국어 (ko)');
+    console.log(`  [1] English (en) ${!isKoreanEnv ? '- Default' : ''}`);
+    console.log(`  [2] 한국어 (ko) ${isKoreanEnv ? '- Default' : ''}`);
     console.log('  [3] 简体中文 (zh)');
     
-    let selectedLang = 'en';
+    let selectedLang = defaultLangCode;
     while (true) {
-      const ans = await question('\nSelect language option [1-3, Default 1]: ');
+      const ans = await question(`\nSelect language option [1-3, Default ${isKoreanEnv ? '2' : '1'}]: `);
       const val = ans.trim();
-      if (val === '' || val === '1') {
+      if (val === '') {
+        selectedLang = defaultLangCode;
+        break;
+      } else if (val === '1') {
         selectedLang = 'en';
         break;
       } else if (val === '2') {
@@ -157,7 +170,7 @@ const runInteractiveMode = async () => {
       console.log('Invalid choice. Please select 1, 2, or 3.');
     }
 
-    // 3. Select Agent Target
+    // 3. Select Agent Target (Smart default if detected)
     const detected = detectAgents();
     console.log('\nSelect target AI Agent environment:');
     
@@ -169,18 +182,22 @@ const runInteractiveMode = async () => {
       { name: 'Global User Setting (~/.gemini/config/)', value: 'global' }
     ];
 
+    let defaultAgentIdx = 1;
     agentsList.forEach((ag, idx) => {
       const isDetected = detected.some(d => d.value === ag.value);
+      if (isDetected && detected.length === 1) {
+        defaultAgentIdx = idx + 1;
+      }
       const label = isDetected ? '⭐ (Detected in Project)' : '';
       console.log(`  [${idx + 1}] ${ag.name} ${label}`);
     });
 
-    let selectedAgent = 'codex';
+    let selectedAgent = agentsList[defaultAgentIdx - 1].value;
     while (true) {
-      const ans = await question('\nSelect agent option [1-5, Default 1]: ');
+      const ans = await question(`\nSelect agent option [1-5, Default ${defaultAgentIdx}]: `);
       const val = ans.trim();
       if (val === '') {
-        selectedAgent = 'codex';
+        selectedAgent = agentsList[defaultAgentIdx - 1].value;
         break;
       }
       const idx = parseInt(val);
@@ -201,7 +218,6 @@ const runInteractiveMode = async () => {
     console.log(`   - Target Agent: ${selectedAgent}`);
     console.log('---------------------------------------------------\n');
 
-    // Run installation logic
     const targetBaseDir = getTargetBaseDir(selectedAgent);
     if (installAll) {
       console.log(`Installing all ${skills.length} skills to target path: ${targetBaseDir}...\n`);
@@ -245,14 +261,19 @@ if (args.includes('-h') || args.includes('--help')) {
   process.exit(0);
 }
 
-// If no arguments, launch Interactive Mode
 if (args.length === 0) {
   runInteractiveMode();
 } else {
   // Command line parameters parsing mode
-  const command = args[0];
-  if (command !== 'add' && command !== 'install-all' && command !== 'list') {
-    console.error(`Error: Unknown command "${command}"`);
+  const rawCommand = args[0];
+  
+  // Normalize command for backward compatibility
+  let command = rawCommand;
+  if (rawCommand === 'add') command = 'install';
+  if (rawCommand === 'install-all') command = 'install-all';
+
+  if (command !== 'install' && command !== 'install-all' && command !== 'list') {
+    console.error(`Error: Unknown command "${rawCommand}"`);
     def_usage();
     process.exit(1);
   }
@@ -261,17 +282,21 @@ if (args.length === 0) {
   let lang = 'en';
   let agent = 'codex';
   let dryRun = false;
+  let isAllTarget = false;
 
-  if (command === 'add') {
+  if (command === 'install') {
     targetSkill = args[1];
     if (!targetSkill || targetSkill.startsWith('-')) {
-      console.error('Error: Please specify a skill name to add.');
+      console.error('Error: Please specify a skill name to install (e.g. skill-forge install ultra-grill-me).');
       process.exit(1);
     }
+    // "install all" format compatibility
+    if (targetSkill.toLowerCase() === 'all') {
+      isAllTarget = true;
+    }
   }
 
-  // Parse command flags
-  const parseStartIdx = command === 'add' ? 2 : 1;
+  const parseStartIdx = command === 'install' ? 2 : 1;
   for (let i = parseStartIdx; i < args.length; i++) {
     const arg = args[i];
     if (arg === '-l' || arg === '--lang') {
@@ -288,9 +313,7 @@ if (args.length === 0) {
   } else {
     const targetBaseDir = getTargetBaseDir(agent);
 
-    if (command === 'add') {
-      installSkillLogic(targetSkill, lang, agent, targetBaseDir, dryRun);
-    } else if (command === 'install-all') {
+    if (isAllTarget || command === 'install-all') {
       if (!fs.existsSync(sourceSkillsDir)) {
         console.error(`Error: Skills source directory not found at ${sourceSkillsDir}`);
         process.exit(1);
@@ -299,6 +322,8 @@ if (args.length === 0) {
         return fs.statSync(path.join(sourceSkillsDir, file)).isDirectory();
       });
       skills.forEach(s => installSkillLogic(s, lang, agent, targetBaseDir, dryRun));
+    } else {
+      installSkillLogic(targetSkill, lang, agent, targetBaseDir, dryRun);
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bhoon716/skill-forge",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Agent Skill Authoring & Distribution CLI Workspace",
   "main": "bin/cli.js",
   "bin": {

package/skills/ultra-grill-me/README.ko.md

@@ -79,7 +79,7 @@ graph TD
 
 ---
 
-## 4. `npx @bhoon716/skill-forge` CLI 설치 가이드
+## 4. `skill-forge` CLI 설치 가이드
 
 저장소 공통 CLI 도구를 사용하여 원하는 에이전트 도구 환경에 지정된 언어 버전으로 즉시 이식합니다. 
 
@@ -88,16 +88,16 @@ graph TD
 
 ```bash
 # 1. Codex/Gemini에 한국어 버전으로 로컬 설치 (기본값)
-npx @bhoon716/skill-forge add ultra-grill-me --lang ko
+skill-forge install ultra-grill-me --lang ko
 
 # 2. Claude Code에 한국어 버전으로 로컬 설치
-npx @bhoon716/skill-forge add ultra-grill-me --lang ko --agent claude
+skill-forge install ultra-grill-me --lang ko --agent claude
 
 # 3. Cursor 프로젝트 로컬에 영어 버전으로 설치
-npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent cursor
+skill-forge install ultra-grill-me --lang en --agent cursor
 
 # 4. 글로벌 스킬 디렉토리에 한국어 버전 전역 설치 (모든 워크스페이스 공유)
-npx @bhoon716/skill-forge add ultra-grill-me --lang ko --agent global
+skill-forge install ultra-grill-me --lang ko --agent global
 ```
 
 ---

package/skills/ultra-grill-me/README.md

@@ -79,7 +79,7 @@ Please select a number, ask for more options, or answer directly.
 
 ---
 
-## 4. `npx @bhoon716/skill-forge` CLI Installer
+## 4. `skill-forge` CLI Installer
 
 Use the workspace CLI to deploy the skill to your target agent directory.
 
@@ -88,16 +88,16 @@ Use the workspace CLI to deploy the skill to your target agent directory.
 
 ```bash
 # 1. Install Korean translation locally to Codex/Gemini (Default)
-npx @bhoon716/skill-forge add ultra-grill-me --lang ko
+skill-forge install ultra-grill-me --lang ko
 
 # 2. Install English version locally to Claude Code
-npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent claude
+skill-forge install ultra-grill-me --lang en --agent claude
 
 # 3. Install English version locally to Cursor
-npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent cursor
+skill-forge install ultra-grill-me --lang en --agent cursor
 
 # 4. Install globally for all workspaces (English default)
-npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent global
+skill-forge install ultra-grill-me --lang en --agent global
 ```
 
 ---

package/skills/ultra-grill-me/README.zh.md

@@ -79,7 +79,7 @@ graph TD
 
 ---
 
-## 4. `npx @bhoon716/skill-forge` CLI 部署工具
+## 4. `skill-forge` CLI 部署工具
 
 使用内置 CLI 将本地化翻译自动部署到对应的本地或全局 Agent 配置路径。
 
@@ -88,16 +88,16 @@ graph TD
 
 ```bash
 # 1. 部署中文版到本地默认项目路径 (Codex/Gemini)
-$ npx @bhoon716/skill-forge add ultra-grill-me --lang zh
+$ skill-forge install ultra-grill-me --lang zh
 
 # 2. 部署中文版到 Claude Code 路径
-$ npx @bhoon716/skill-forge add ultra-grill-me --lang zh --agent claude
+$ skill-forge install ultra-grill-me --lang zh --agent claude
 
 # 3. 部署英文版到 Cursor 路径
-$ npx @bhoon716/skill-forge add ultra-grill-me --lang en --agent cursor
+$ skill-forge install ultra-grill-me --lang en --agent cursor
 
 # 4. 全局部署中文版至用户根路径
-$ npx @bhoon716/skill-forge add ultra-grill-me --lang zh --agent global
+$ skill-forge install ultra-grill-me --lang zh --agent global
 ```
 
 ---