heymark 2.0.0 → 2.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Mossland Open Source
-
-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.
+MIT License
+
+Copyright (c) 2026 Mossland Open Source
+
+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

@@ -1,123 +1,121 @@
-# Heymark
-
-Heymark는 하나의 Skill 저장소를 여러 AI Tool 형식으로 변환하고 동기화하는 허브 시스템입니다.
-
-1. [Overview](#overview)
-2. [Features](#features)
-3. [Supported Tools](#supported-tools)
-4. [How to Use](#how-to-use)
-5. [How to Dev](#how-to-dev)
-
-## Overview
-
-AI Tool은 프롬프트 문맥에 맞는 Skill을 로드해 반복적인 지시문 입력을 줄이는 기능을 지원합니다.
-이 기능을 사용하면 공통 작업을 표준화하고, 팀 내에서 일관된 작업 기준을 유지할 수 있다는 장점이 있습니다.
-하지만 프로젝트마다 Skill을 개별적으로 연결하고 관리해야 하며, AI Tool마다 요구하는 Skill 파일 형식도 달라
-같은 내용을 여러 형식으로 반복 관리해야 하는 불편이 있습니다.
-Heymark는 단일 Skill 저장소(Single Source of Truth)를 중심으로 도구별 형식 변환과 동기화를 자동화해,
-반복 운영 비용을 줄이고 AI 활용 효율을 극대화합니다.
-
-<img width="600" alt="image" src="https://github.com/user-attachments/assets/3819f0d7-9bb2-474f-a58a-da3d1344207d" />
-
-_프롬프트 문맥에 맞는 Skill을 자동 로드하는 모습입니다._
-
-## Features
-
-- 단일 소스 관리: Markdown 기반 Skill을 한 곳에서 관리
-- 자동 형식 변환: 도구별 형식으로 Skill 자동 생성
-- 선택 동기화: 전체 또는 특정 도구만 동기화
-- 샘플 Skill 즉시 사용: Skill 저장소 준비 없이 `npx heymark link --samples`로 바로 시작
-
-## Supported Tools
-
-| Tool           | Output Format                            |
-| :------------- | :--------------------------------------- |
-| Cursor         | `.cursor/rules/*.mdc`                    |
-| Claude Code    | `.claude/skills/*/SKILL.md`              |
-| GitHub Copilot | `.github/instructions/*.instructions.md` |
-| OpenAI Codex   | `.agents/skills/*/SKILL.md`              |
-| Antigravity    | `.agent/skills/*/SKILL.md`               |
-
-## How to Use
-
-### Prepare Skill Repository
-
-Skill 저장소는 아래처럼 구성하면 됩니다.
-
-```text
-my-skills-repository/
-  ai-behavior.md
-  code-conventions.md
-  api-skills.md
-```
-
-각 Skill Markdown에는 frontmatter를 포함합니다.
-
-```markdown
----
-description: "AI coding behavior guidelines"
-globs: "**/*.ts,**/*.tsx"
-alwaysApply: true
----
-
-# Skill Title
-
-Skill content...
-```
-
-### Quick Start
-
-```bash
-npx heymark link --samples # 샘플 Skill 바로 연결
-npx heymark sync .
-```
-
-_`link`와 `sync` 실행 후, 각 도구가 요구하는 디렉터리에 Skill 파일이 생성됩니다._
-
-<img width="250" alt="image" src="https://github.com/user-attachments/assets/0e5bc974-12d6-4aab-b0aa-16ca5659f973" />
-
-### Commands
-
-```bash
-npx heymark link --samples # 샘플 Skill 바로 연결
-
-npx heymark link <GitHub-저장소-URL> # Skill 저장소 연결
-npx heymark link <GitHub-저장소-URL> --folder <folder-name> # 하위 폴더 사용 시
-npx heymark link <GitHub-저장소-URL> --branch <branch-name> # 다른 브랜치 사용 시
-
-npx heymark sync . # 전체 동기화
-npx heymark sync cursor claude # 일부 도구만 동기화
-
-npx heymark clean . # 전체 정리
-npx heymark clean cursor claude # 일부 도구만 정리
-
-npx heymark status # 상태 확인 (status 생략 가능)
-npx heymark help # 명령어 확인
-```
-
-## How to Dev
-
-### Tech Stack
-
-- Runtime: Node.js
-- Language: JavaScript
-- Core: File system API, YAML frontmatter parsing
-
-### Local Development
-
-`How to Use` 섹션의 `npx heymark`를 `node scripts/cli.js`로 바꿔 실행하면 됩니다.
-
-### Release
-
-```bash
-npm login
-npm version patch  # 또는 minor, major
-git push --follow-tags
-npm publish
-```
-
-### Versioning
-
-- `patch` (1.0.0 -> 1.0.1): 버그 수정, 오타 수정
-- `minor` (1.0.0 -> 1.1.0): 새 Skill 추가, 기능 개선
-- `major` (1.0.0 -> 2.0.0): 호환성 깨지는 변경
+# Heymark
+
+Heymark는 하나의 Skill 저장소를 여러 AI Tool 형식으로 변환하고 동기화하는 허브 시스템입니다.
+
+1. [Overview](#overview)
+2. [Features](#features)
+3. [Supported Tools](#supported-tools)
+4. [How to Use](#how-to-use)
+5. [How to Dev](#how-to-dev)
+
+## Overview
+
+AI Tool은 프롬프트 문맥에 맞는 Skill을 로드해 반복적인 지시문 입력을 줄이는 기능을 지원합니다.
+이 기능을 사용하면 공통 작업을 표준화하고, 팀 내에서 일관된 작업 기준을 유지할 수 있다는 장점이 있습니다.
+하지만 프로젝트마다 Skill을 개별적으로 연결하고 관리해야 하며, AI Tool마다 요구하는 Skill 파일 형식도 달라
+같은 내용을 여러 형식으로 반복 관리해야 하는 불편이 있습니다.
+Heymark는 단일 Skill 저장소(Single Source of Truth)를 중심으로 도구별 형식 변환과 동기화를 자동화해,
+반복 운영 비용을 줄이고 AI 활용 효율을 극대화합니다.
+
+<img width="600" alt="image" src="https://github.com/user-attachments/assets/3819f0d7-9bb2-474f-a58a-da3d1344207d" />
+
+_프롬프트 문맥에 맞는 Skill을 자동 로드하는 모습입니다._
+
+## Features
+
+- 단일 소스 관리: Markdown 기반 Skill을 한 곳에서 관리
+- 자동 형식 변환: 도구별 형식으로 Skill 자동 생성
+- 선택 동기화: 전체 또는 특정 도구만 동기화
+- 샘플 Skill 즉시 사용: heymark 샘플 Skill 저장소로 바로 시작
+
+## Supported Tools
+
+| Tool        | CLI usage     | Output Format                            |
+| :---------- | :------------ | :--------------------------------------- |
+| Cursor      | `cursor`      | `.cursor/rules/*.mdc`                    |
+| Claude Code | `claude-code` | `.claude/skills/*/SKILL.md`              |
+| Copilot     | `copilot`     | `.github/instructions/*.instructions.md` |
+| Codex       | `codex`       | `.agents/skills/*/SKILL.md`              |
+| Antigravity | `antigravity` | `.agent/skills/*/SKILL.md`               |
+| OpenClaw    | `openclaw`    | `~/.openclaw/skills/*/SKILL.md`          |
+
+## How to Use
+
+### Prepare Skill Repository
+
+Skill 저장소는 아래처럼 구성하면 됩니다.
+
+```text
+my-skills-repository/
+  ai-behavior.md
+  code-conventions.md
+  api-skills.md
+```
+
+각 Skill Markdown에는 frontmatter를 포함합니다.
+
+```markdown
+---
+description: "AI coding behavior guidelines"
+globs: "**/*.ts,**/*.tsx"
+alwaysApply: true
+---
+
+# Skill Title
+
+Skill content...
+```
+
+### Quick Start
+
+```bash
+npx heymark link https://github.com/MosslandOpenDevs/heymark.git --folder skill-samples
+npx heymark sync .
+```
+
+_`link`와 `sync` 실행 후, 각 도구가 요구하는 디렉터리에 Skill 파일이 생성됩니다._
+
+<img width="250" alt="image" src="https://github.com/user-attachments/assets/0e5bc974-12d6-4aab-b0aa-16ca5659f973" />
+
+### Commands
+
+```bash
+npx heymark link <GitHub-저장소-URL>
+npx heymark link <GitHub-저장소-URL> --folder <folder-name>  # 하위 폴더 사용 시
+npx heymark link <GitHub-저장소-URL> --branch <branch-name>  # 다른 브랜치 사용 시
+
+npx heymark sync .                        # 전체 동기화
+npx heymark sync cursor claude-code       # 일부 도구만 동기화
+
+npx heymark clean .                       # 전체 정리
+npx heymark clean cursor claude-code      # 일부 도구만 정리
+
+npx heymark help
+```
+
+## How to Dev
+
+### Tech Stack
+
+- Runtime: Node.js
+- Language: JavaScript
+- Core: File system API, YAML frontmatter parsing
+
+### Local Development
+
+`How to Use` 섹션의 `npx heymark`를 `node src/index.js`로 바꿔 실행하면 됩니다.
+
+### Release
+
+```bash
+npm login
+npm version patch  # 또는 minor, major
+git push --follow-tags
+npm publish
+```
+
+### Versioning
+
+- `patch` (1.0.0 -> 1.0.1): 버그 수정, 오타 수정
+- `minor` (1.0.0 -> 1.1.0): 새 Skill 추가, 기능 개선
+- `major` (1.0.0 -> 2.0.0): 호환성 깨지는 변경

package/README.md

@@ -1,125 +1,123 @@
-# Heymark
-
-For the Korean version, see [README.ko.md](README.ko.md).
-
-Heymark is a hub system that converts and syncs one Skill repository into multiple AI Tool formats.
-
-1. [Overview](#overview)
-2. [Features](#features)
-3. [Supported Tools](#supported-tools)
-4. [How to Use](#how-to-use)
-5. [How to Dev](#how-to-dev)
-
-## Overview
-
-AI Tools support loading context-aware Skills to reduce repetitive instruction typing.
-This helps standardize common tasks and keeps team workflows consistent.
-However, each project still needs separate Skill linking and management, and each AI Tool requires a
-different Skill file format, so the same content is often maintained multiple times.
-Heymark automates format conversion and sync around a single Skill repository (Single Source of Truth),
-reducing repetitive operational work and maximizing AI workflow efficiency.
-
-<img width="600" alt="image" src="https://github.com/user-attachments/assets/3819f0d7-9bb2-474f-a58a-da3d1344207d" />
-
-_This shows Skills being automatically loaded based on prompt context._
-
-## Features
-
-- Single source management: Manage Markdown-based Skills in one place
-- Automatic format conversion: Generate Skill outputs in each tool's required format
-- Selective sync: Sync all tools or only selected tools
-- Instant sample usage: Start immediately with `npx heymark link --samples` without preparing a Skill repo
-
-## Supported Tools
-
-| Tool           | Output Format                            |
-| :------------- | :--------------------------------------- |
-| Cursor         | `.cursor/rules/*.mdc`                    |
-| Claude Code    | `.claude/skills/*/SKILL.md`              |
-| GitHub Copilot | `.github/instructions/*.instructions.md` |
-| OpenAI Codex   | `.agents/skills/*/SKILL.md`              |
-| Antigravity    | `.agent/skills/*/SKILL.md`               |
-
-## How to Use
-
-### Prepare Skill Repository
-
-You can organize your Skill repository like this:
-
-```text
-my-skills-repository/
-  ai-behavior.md
-  code-conventions.md
-  api-skills.md
-```
-
-Each Skill Markdown file should include frontmatter:
-
-```markdown
----
-description: "AI coding behavior guidelines"
-globs: "**/*.ts,**/*.tsx"
-alwaysApply: true
----
-
-# Skill Title
-
-Skill content...
-```
-
-### Quick Start
-
-```bash
-npx heymark link --samples # quickly link sample Skills
-npx heymark sync .
-```
-
-_After `link` and `sync`, Skill files are generated in each tool's expected directory._
-
-<img width="250" alt="image" src="https://github.com/user-attachments/assets/0e5bc974-12d6-4aab-b0aa-16ca5659f973" />
-
-### Commands
-
-```bash
-npx heymark link --samples # quickly link sample Skills
-
-npx heymark link <GitHub-Repository-URL> # link a Skill repository
-npx heymark link <GitHub-Repository-URL> --folder <folder-name> # when using a subfolder
-npx heymark link <GitHub-Repository-URL> --branch <branch-name> # when using another branch
-
-npx heymark sync . # sync all tools
-npx heymark sync cursor claude # sync selected tools
-
-npx heymark clean . # clean all generated outputs
-npx heymark clean cursor claude # clean selected tool outputs
-
-npx heymark status # check status (same as running npx heymark)
-npx heymark help # show command help
-```
-
-## How to Dev
-
-### Tech Stack
-
-- Runtime: Node.js
-- Language: JavaScript
-- Core: File system API, YAML frontmatter parsing
-
-### Local Development
-
-Replace `npx heymark` in the `How to Use` section with `node scripts/cli.js` for local runs.
-
-### Release
-
-```bash
-npm login
-npm version patch  # or minor, major
-git push --follow-tags
-npm publish
-```
-
-### Versioning
-
-- `patch` (1.0.0 -> 1.0.1): Bug fixes, typo fixes
-- `minor` (1.0.0 -> 1.1.0): New Skills, feature improvements
-- `major` (1.0.0 -> 2.0.0): Breaking changes
+# Heymark
+
+For the Korean version, see [README.ko.md](README.ko.md).
+
+Heymark is a hub system that converts and syncs one Skill repository into multiple AI Tool formats.
+
+1. [Overview](#overview)
+2. [Features](#features)
+3. [Supported Tools](#supported-tools)
+4. [How to Use](#how-to-use)
+5. [How to Dev](#how-to-dev)
+
+## Overview
+
+AI Tools support loading context-aware Skills to reduce repetitive instruction typing.
+This helps standardize common tasks and keeps team workflows consistent.
+However, each project still needs separate Skill linking and management, and each AI Tool requires a
+different Skill file format, so the same content is often maintained multiple times.
+Heymark automates format conversion and sync around a single Skill repository (Single Source of Truth),
+reducing repetitive operational work and maximizing AI workflow efficiency.
+
+<img width="600" alt="image" src="https://github.com/user-attachments/assets/3819f0d7-9bb2-474f-a58a-da3d1344207d" />
+
+_This shows Skills being automatically loaded based on prompt context._
+
+## Features
+
+- Single source management: Manage Markdown-based Skills in one place
+- Automatic format conversion: Generate Skill outputs in each tool's required format
+- Selective sync: Sync all tools or only selected tools
+- Sample skills: Try instantly with the heymark sample skill repo
+
+## Supported Tools
+
+| Tool        | CLI usage     | Output Format                            |
+| :---------- | :------------ | :--------------------------------------- |
+| Cursor      | `cursor`      | `.cursor/rules/*.mdc`                    |
+| Claude Code | `claude-code` | `.claude/skills/*/SKILL.md`              |
+| Copilot     | `copilot`     | `.github/instructions/*.instructions.md` |
+| Codex       | `codex`       | `.agents/skills/*/SKILL.md`              |
+| Antigravity | `antigravity` | `.agent/skills/*/SKILL.md`               |
+| OpenClaw    | `openclaw`    | `~/.openclaw/skills/*/SKILL.md`          |
+
+## How to Use
+
+### Prepare Skill Repository
+
+You can organize your Skill repository like this:
+
+```text
+my-skills-repository/
+  ai-behavior.md
+  code-conventions.md
+  api-skills.md
+```
+
+Each Skill Markdown file should include frontmatter:
+
+```markdown
+---
+description: "AI coding behavior guidelines"
+globs: "**/*.ts,**/*.tsx"
+alwaysApply: true
+---
+
+# Skill Title
+
+Skill content...
+```
+
+### Quick Start
+
+```bash
+npx heymark link https://github.com/MosslandOpenDevs/heymark.git --folder skill-samples
+npx heymark sync .
+```
+
+_After `link` and `sync`, Skill files are generated in each tool's expected directory._
+
+<img width="250" alt="image" src="https://github.com/user-attachments/assets/0e5bc974-12d6-4aab-b0aa-16ca5659f973" />
+
+### Commands
+
+```bash
+npx heymark link <GitHub-Repository-URL>
+npx heymark link <GitHub-Repository-URL> --folder <folder-name>
+npx heymark link <GitHub-Repository-URL> --branch <branch-name>
+
+npx heymark sync .                        # sync all tools
+npx heymark sync cursor claude-code       # sync selected tools
+
+npx heymark clean .                       # clean all generated outputs
+npx heymark clean cursor claude-code      # clean selected tool outputs
+
+npx heymark help
+```
+
+## How to Dev
+
+### Tech Stack
+
+- Runtime: Node.js
+- Language: JavaScript
+- Core: File system API, YAML frontmatter parsing
+
+### Local Development
+
+Replace `npx heymark` in the `How to Use` section with `node src/index.js` for local runs.
+
+### Release
+
+```bash
+npm login
+npm version patch  # or minor, major
+git push --follow-tags
+npm publish
+```
+
+### Versioning
+
+- `patch` (1.0.0 -> 1.0.1): Bug fixes, typo fixes
+- `minor` (1.0.0 -> 1.1.0): New Skills, feature improvements
+- `major` (1.0.0 -> 2.0.0): Breaking changes

package/package.json

@@ -1,56 +1,57 @@
-{
-    "name": "heymark",
-    "version": "2.0.0",
-    "description": "Rules & Skills Hub for AI Coding Assistants",
-    "type": "commonjs",
-    "main": "scripts/cli.js",
-    "bin": "scripts/cli.js",
-    "keywords": [
-        "ai-coding-assistant",
-        "ai-agent",
-        "ai-skill",
-        "ai-rule",
-        "skill-management",
-        "cursor",
-        "claude-code",
-        "copilot",
-        "codex",
-        "antigravity"
-    ],
-    "homepage": "https://github.com/MosslandOpenDevs/heymark#readme",
-    "bugs": {
-        "url": "https://github.com/MosslandOpenDevs/heymark/issues",
-        "email": "yena@moss.land"
-    },
-    "license": "MIT",
-    "author": {
-        "name": "i-2na",
-        "email": "yena@moss.land",
-        "url": "https://github.com/i2na"
-    },
-    "contributors": [
-        {
-            "name": "i-2na",
-            "email": "yena@moss.land",
-            "url": "https://github.com/i2na"
-        },
-        {
-            "name": "yezzero",
-            "email": "yeyeonggim06@gmail.com",
-            "url": "https://github.com/yezzero"
-        }
-    ],
-    "engines": {
-        "node": ">=14.0.0"
-    },
-    "files": [
-        "scripts/"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/MosslandOpenDevs/heymark.git"
-    },
-    "publishConfig": {
-        "access": "public"
-    }
-}
+{
+    "name": "heymark",
+    "version": "2.1.0",
+    "description": "Rules & Skills Hub for AI Coding Assistants",
+    "type": "commonjs",
+    "main": "src/index.js",
+    "bin": "src/index.js",
+    "keywords": [
+        "ai-coding-assistant",
+        "ai-agent",
+        "ai-skill",
+        "ai-rule",
+        "skill-management",
+        "cursor",
+        "claude-code",
+        "copilot",
+        "codex",
+        "antigravity",
+        "openclaw"
+    ],
+    "homepage": "https://github.com/MosslandOpenDevs/heymark#readme",
+    "bugs": {
+        "url": "https://github.com/MosslandOpenDevs/heymark/issues",
+        "email": "yena@moss.land"
+    },
+    "license": "MIT",
+    "author": {
+        "name": "i-2na",
+        "email": "yena@moss.land",
+        "url": "https://github.com/i2na"
+    },
+    "contributors": [
+        {
+            "name": "i-2na",
+            "email": "yena@moss.land",
+            "url": "https://github.com/i2na"
+        },
+        {
+            "name": "yezzero",
+            "email": "yeyeonggim06@gmail.com",
+            "url": "https://github.com/yezzero"
+        }
+    ],
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "files": [
+        "src/"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/MosslandOpenDevs/heymark.git"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}