Heymark

For the Korean version, see README.ko.md.

Heymark is a hub system that converts and syncs one Skill repository into multiple AI Tool formats.

1. Overview
2. Features
3. Supported Tools
4. How to Use
5. 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.

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

How to Use

Prepare Skill Repository

You can organize your Skill repository like this:

my-skills-repository/
  ai-behavior.md
  code-conventions.md
  api-skills.md

Each Skill Markdown file should include frontmatter:

---
description: "AI coding behavior guidelines"
globs: "**/*.ts,**/*.tsx"
alwaysApply: true
---

# Skill Title

Skill content...

Quick Start

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.

Commands

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

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