@bhoon716/skill-forge 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [bhoon716]
+
+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.ko.md

@@ -0,0 +1,112 @@
+# 🛠️ skill-forge (에이전트 스킬 공방)
+
+<p align="center">
+  <img src="https://img.shields.io/badge/node-%3E%3D16.0.0-blue.svg" alt="Node Version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/format-SKILL.md-orange.svg" alt="Format Compatibility">
+  <img src="https://img.shields.io/badge/agent-Codex%20%7C%20Gemini%20%7C%20Claude-red.svg" alt="Supported Agents">
+</p>
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
+</p>
+---
+
+**정성껏 깎아낸 AI 에이전트 스킬(Agent Skill)들을 한데 모으고 스마트하게 배포하는 작업공간입니다.**
+
+`skill-forge`는 Codex, Gemini, Claude Code, Cursor 등 `SKILL.md` 포펙을 호환하는 모든 자율형 코딩 에이전트 환경에 스크립트 하나로 즉시 이식 가능한 고품질 스킬 패키지를 제작합니다.
+
+---
+
+## 📂 1. 저장소 구조
+
+```txt
+skill-forge/
+├── README.md
+├── README.ko.md             (본 대문 문서)
+├── package.json             (CLI 패키지 설정)
+├── bin/
+│   └── cli.js               (스킬 설치 및 번역용 CLI 도구)
+├── skills/
+│   └── ultra-grill-me/      (Socratic 압박 검증 스킬)
+│       ├── SKILL.md
+│       ├── SKILL.ko.md
+│       ├── README.md
+│       ├── README.ko.md
+│       ├── references/      (도메인별 세부 질문 리스트)
+│       ├── examples/        (Trigger 테스트 케이스)
+│       └── evals/           (품질 Grader 채점기)
+├── templates/
+│   └── skill-template/      (새로운 스킬 제작용 템플릿)
+└── docs/
+    ├── authoring-guide.md   (스킬 작성 표준 매뉴얼)
+    ├── naming.md            (명명 규칙)
+    └── testing.md           (테스트 및 검증 가이드)
+```
+
+---
+
+## 🏆 2. 릴리즈 스킬 목록
+
+| 스킬 명칭 | 목적 및 한 줄 설명 | 상태 |
+| :--- | :--- | :--- |
+| **`ultra-grill-me`** | 사용자의 기획, 아키텍처 ADR, 개인 고민 등을 Socratic 역질문으로 털어 빈틈과 리스크를 정교하게 깎아내는 검증 엔진 스킬 | **Released (v1.0.0) 🎯** |
+
+---
+
+## 🚀 3. 스킬 설치 CLI 사용법 (`skill-forge` 또는 `npx @bhoon716/skill-forge`)
+
+이 워크스페이스의 스킬들을 자신의 로컬 프로젝트나 전역 환경으로 손쉽게 배포할 수 있는 **다국어 지원 지향형 CLI 도구**입니다.
+
+> [!TIP]
+> **글로벌 전역 명령어로 간편하게 실행하기 (`skill-forge`)**:
+> 이 패키지를 시스템 전역에 설치하면 `npx` 입력 없이 단 한 단어 `skill-forge` 명령어로 즉시 대화형 설치 모드를 실행할 수 있습니다.
+> ```bash
+> # 1. 글로벌 설치 (최초 1회)
+> $ npm install -g @bhoon716/skill-forge
+> 
+> # 2. 대화형 셋업 모드 즉시 실행
+> $ skill-forge
+> ```
+
+### 💡 명령어 실물 예시
+```bash
+# 1. 특정 스킬을 한국어로 Codex/Gemini 프로젝트 로컬에 설치 (기본값)
+$ skill-forge add ultra-grill-me --lang ko
+
+# 2. 특정 스킬을 한국어로 Claude Code 로컬 경로에 설치
+$ skill-forge add ultra-grill-me --lang ko --agent claude
+
+# 3. 특정 스킬을 영어로 Cursor 프로젝트 로컬 경로에 설치
+$ skill-forge add ultra-grill-me --lang en --agent cursor
+
+# 4. 글로벌 환경에 한국어 스킬로 전역 설치 (모든 워크스페이스 공유)
+$ skill-forge add ultra-grill-me --lang ko --agent global
+
+# 5. 전체 스킬을 한국어 버전으로 한 번에 로컬 설치
+$ skill-forge install-all --lang ko --agent codex
+```
+
+### ⚙️ 옵션 요약
+- `-l, --lang <en|ko|zh>`: 설치할 다국어 번역본 코드 선택 (기본값: `en`)
+- `-a, --agent <codex|gemini|claude|cursor|copilot|global>`: 대상 도구의 설정 위치 지정 (기본값: `codex`)
+- `--dry-run`: 실제 복사를 수행하지 않고 파일 매핑 결과만 가상 시뮬레이션 출력
+
+---
+
+## ✍️ 4. 기여 및 유지보수 규칙
+
+> [!IMPORTANT]
+> **이 저장소에 기여할 때 지켜야 할 3대 원칙:**
+>
+> 1. 🎯 **단일 책임의 법칙 (Single Responsibility)**:
+>    새로운 스킬을 설계할 때는 오직 하나의 좁고 반복적인 작업에만 특화되도록 `docs/authoring-guide.md`에 맞춰 깎아냅니다.
+> 2. 🌐 **다국어 확장성 (Localization Suffices)**:
+>    스킬 본문과 레퍼런스 문서는 반드시 언어별 접미사 파일(`.ko.md`, `.md` [디폴트 영어], `.zh.md`)을 병행 작성하여 번역 매핑이 깨지지 않도록 유지합니다.
+> 3. 🧪 **회귀 테스트 수행 (Regression Testing)**:
+>    수정 시에는 `evals/check_evals.py` 채점기를 돌려 F1 Score 및 Process Adherence가 깨지지 않는지 검증한 뒤 릴리즈합니다.
+
+---
+
+## 📄 라이선스
+
+MIT License. 자유롭게 가져다 사용하거나 팀 내부의 전용 AI 스킬 공유 허브로 활용하시기 바랍니다.

package/README.md

@@ -0,0 +1,112 @@
+# 🛠️ skill-forge (Agent Skill Workspace)
+
+<p align="center">
+  <img src="https://img.shields.io/badge/node-%3E%3D16.0.0-blue.svg" alt="Node Version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/format-SKILL.md-orange.svg" alt="Format Compatibility">
+  <img src="https://img.shields.io/badge/agent-Codex%20%7C%20Gemini%20%7C%20Claude-red.svg" alt="Supported Agents">
+</p>
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
+</p>
+---
+
+**A dedicated, professional workspace to craft, test, and distribute sharp, reusable AI Agent Skills.**
+
+`skill-forge` provides high-quality, structured skill packages compatible with Codex, Gemini, Claude Code, Cursor, and any agent supporting the `SKILL.md` format.
+
+---
+
+## 📂 1. Directory Structure
+
+```txt
+skill-forge/
+├── README.md                (This dashboard guide)
+├── README.ko.md             (Korean dashboard guide)
+├── package.json             (CLI package configuration)
+├── bin/
+│   └── cli.js               (Built-in skill localization & installer CLI)
+├── skills/
+│   └── ultra-grill-me/      (Socratic plan verification skill)
+│       ├── SKILL.md
+│       ├── SKILL.ko.md
+│       ├── README.md
+│       ├── README.ko.md
+│       ├── references/      (Domain taxonomy markdown sheets)
+│       ├── examples/        (Trigger evaluation suites)
+│       └── evals/           (Deterministic process graders)
+├── templates/
+│   └── skill-template/      (Boilerplate templates to build new skills)
+└── docs/
+    ├── authoring-guide.md   (Standard authoring manual)
+    ├── naming.md            (Naming conventions)
+    └── testing.md           (Verification & evals guide)
+```
+
+---
+
+## 🏆 2. Released Skills
+
+| Skill Name | Purpose & Pitch | Status |
+| :--- | :--- | :--- |
+| **`ultra-grill-me`** | A Socratic questioning agent engine that challenges your plans, system designs, GTM strategies, and personal choices to remove ambiguity before coding. | **Released (v1.0.0) 🎯** |
+
+---
+
+## 🚀 3. Skill Installer CLI Usage (`skill-forge` or `npx @bhoon716/skill-forge`)
+
+A built-in installer tool that automatically maps localized skill source files and deploys them to target agent configuration directories.
+
+> [!TIP]
+> **Run with global command (`skill-forge`)**:
+> You can install this tool globally to run the interactive mode using the simple `skill-forge` command.
+> ```bash
+> # 1. Install globally (Once)
+> $ npm install -g @bhoon716/skill-forge
+> 
+> # 2. Run interactive setup mode instantly
+> $ skill-forge
+> ```
+
+### 💡 CLI Usage Examples
+```bash
+# 1. Install Korean version locally to Codex/Gemini directory (Default)
+$ skill-forge add ultra-grill-me --lang ko
+
+# 2. Install Korean version locally to Claude Code directory
+$ skill-forge add 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
+
+# 4. Install globally for all workspaces (English default)
+$ skill-forge add 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
+```
+
+### ⚙️ Options List
+- `-l, --lang <en|ko|zh>`: Set target language translation (Default: `en`)
+- `-a, --agent <codex|gemini|claude|cursor|copilot|global>`: Map destination tool path (Default: `codex`)
+- `--dry-run`: Simulate mappings and file copy plans without modification
+
+---
+
+## ✍️ 4. Contributing Rules
+
+> [!IMPORTANT]
+> **Keep these three core principles when contributing to this repository:**
+>
+> 1. 🎯 **Single Responsibility Principle**:
+>    Each skill must address exactly one repeatable bottleneck described in `docs/authoring-guide.md`.
+> 2. 🌐 **Translation Suffixes**:
+>    Always keep suffix pairs (e.g., `SKILL.ko.md` and `SKILL.md`) intact to support the installer parser.
+> 3. 🧪 **Regression Verification**:
+>    Run `evals/check_evals.py` to assert F1 precision and process adherence metrics before merging changes.
+
+---
+
+## 📄 License
+
+MIT License. Feel free to adopt this workspace schema for your team's custom AI skills hub.

package/README.zh.md

@@ -0,0 +1,115 @@
+# 🛠️ skill-forge (AI Agent Skill 工作空间)
+
+<p align="center">
+  <img src="https://img.shields.io/badge/node-%3E%3D16.0.0-blue.svg" alt="Node Version">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+  <img src="https://img.shields.io/badge/format-SKILL.md-orange.svg" alt="Format Compatibility">
+  <img src="https://img.shields.io/badge/agent-Codex%20%7C%20Gemini%20%7C%20Claude-red.svg" alt="Supported Agents">
+</p>
+<p align="center">
+  <a href="./README.md">English</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.zh.md">简体中文</a>
+</p>
+---
+
+**精心打磨的 AI Agent Skill 设计与智能分发工作空间。**
+
+`skill-forge` 提供了一套标准化工具，使您可以轻松编写兼容 Codex, Gemini, Claude Code, Cursor 等支持 `SKILL.md` 规范的 AI Agent 并在不同项目中一键部署。
+
+---
+
+## 📂 1. 目录结构
+
+```txt
+skill-forge/
+├── README.md                (英文主指南)
+├── README.ko.md             (韩文主指南)
+├── README.zh.md             (本中文主指南)
+├── package.json             (CLI 依赖配置)
+├── bin/
+│   └── cli.js               (Skill 部署与本地化 CLI 工具)
+├── skills/
+│   └── ultra-grill-me/      (Socratic 提问施压验证 Skill)
+│       ├── SKILL.md
+│       ├── SKILL.ko.md
+│       ├── SKILL.zh.md
+│       ├── README.md
+│       ├── README.ko.md
+│       ├── README.zh.md
+│       ├── references/      (细分领域提问参考库)
+│       ├── examples/        (Trigger 测试用例)
+│       └── evals/           (提问规范自动化 Grader)
+├── templates/
+│   └── skill-template/      (新 Skill 创建模板)
+└── docs/
+    ├── authoring-guide.md   (Skill 编写指南)
+    ├── naming.md            (命名规范)
+    └── testing.md           (测试与 Evals 验证指南)
+```
+
+---
+
+## 🏆 2. 已发布 Skill 列表
+
+| Skill 名称 | 核心目的与简介 | 状态 |
+| :--- | :--- | :--- |
+| **`ultra-grill-me`** | 通过苏格拉底式提问（一次只问一个问题）压力测试用户的开发计划、系统设计、商业策略和个人决策，从而在代码编写前消除模糊性。 | **Released (v1.0.0) 🎯** |
+
+---
+
+## 🚀 3. CLI 快速部署工具 (`skf` 或 `npx @bhoon716/skill-forge`)
+
+通过轻量化 CLI 可以自动根据语言选项映射，并将 Skill 复制部署到对应的 Agent 本地或全局配置路径中。
+
+> [!TIP]
+> **只需 3 个字符即可轻松运行 (`skf`)**：
+> 您可以全局安装此工具，以便使用快捷命令 `skf` 立即启动交互式安装模式。
+> ```bash
+> # 1. 全局安装 (仅需一次)
+> $ npm install -g @bhoon716/skill-forge
+> 
+> # 2. 快捷运行交互式安装模式
+> $ skf
+> ```
+
+### 💡 命令行实例
+```bash
+# 1. 以中文版部署到本地默认项目路径 (Codex/Gemini)
+$ skf add ultra-grill-me --lang zh
+
+# 2. 以中文版部署到本地 Claude Code 路径
+$ skf add ultra-grill-me --lang zh --agent claude
+
+# 3. 以英文版部署到本地 Cursor 路径
+$ skf add ultra-grill-me --lang en --agent cursor
+
+# 4. 以中文版全局部署到用户主目录 (全局生效)
+$ skf add ultra-grill-me --lang zh --agent global
+
+# 5. 一键中文部署工作空间内的所有 Skill
+$ skf install-all --lang zh --agent codex
+```
+
+### ⚙️ 选项说明
+- `-l, --lang <en|ko|zh>`: 选择部署的翻译语系 (默认值: `en`)
+- `-a, --agent <codex|gemini|claude|cursor|copilot|global>`: 目标工具的环境路径映射 (默认值: `codex`)
+- `--dry-run`: 仅模拟复制映射过程，不实际写入文件
+
+---
+
+## ✍️ 4. 协作开发规范
+
+> [!IMPORTANT]
+> **在此仓库贡献新 Skill 时，请务必遵守以下三条原则:**
+>
+> 1. 🎯 **单一职责原则 (Single Responsibility)**:
+>    每个 Skill 的设计必须专注于解决 `docs/authoring-guide.md` 中定义的一个具体的、高价值的重复工作流。
+> 2. 🌐 **翻译后缀规范 (Localization Suffixes)**:
+>    必须同时提供对应语言的后缀文件（例如：`SKILL.zh.md`, `SKILL.ko.md` 以及英文默认版的 `SKILL.md`），以支撑 CLI 解析。
+> 3. 🧪 **运行回归测试 (Regression Proof)**:
+>    进行任何修改后，必须运行 `evals/check_evals.py` 自动化评测，以确保提问结构和 Process Adherence 指标没有退化。
+
+---
+
+## 📄 开源协议
+
+MIT License. 欢迎将此项目框架用于您团队的内部自定义 Agent Skills 分发枢纽。