MJML HTML 이메일 스킬
엄격한 검증과 클라이언트별 확인으로 MJML 이메일 소스와 컴파일된 HTML을 만듭니다.
커뮤니티 · Framix| 작성자 | Framix |
|---|---|
| 라이선스 | MIT |
| 소스 | framix-team/skill-email-html-mjml · GitHub의 SKILL.md |
| 프로젝트 웹사이트 | documentation.mjml.io |
| 작동 환경 | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| 소스 확인 날짜 |
email-html-mjml은 MJML 5.x로 반응형 메일을 만들고 MJML 소스와 컴파일 HTML을 함께 제공합니다.
Outlook 대체 표시, Gmail 잘림, 접근성과 안전한 include를 다룹니다. 컴파일 성공이 모든 메일 클라이언트의 표시를 입증하지는 않습니다.
스킬의 SKILL.md에서: # email-html-mjml — Responsive Email Developer
하는 일
- 요청된 배치에 맞는 컴포넌트 자료를 선택합니다.
- 재사용 속성과 접근 가능한 레이블로 MJML을 만듭니다.
- 엄격한 검증과 압축으로 컴파일한 뒤 결과를 확인합니다.
얻을 수 있는 결과물
- 편집 가능한 .mjml과 컴파일된 .html.
- 클라이언트 호환성과 컴파일 설명.
이럴 때 사용하세요
- 거래 이메일, 뉴스레터와 홍보 템플릿 제작.
- include 누락이나 Outlook 배경 대체 표시 조사.
이럴 때는 맞지 않습니다
- 캠페인 발송이나 실제로 하지 않은 클라이언트 테스트를 했다는 주장.
필요한 것
- Node.js 20 이상과 프로젝트 내 MJML 5.x 설치.
- 이메일 테스트 서비스는 선택이며 유료일 수 있습니다. 파일 생성에는 발송 계정이 필요하지 않습니다.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | 메일 배치, 접근성과 호환성 규칙. |
compilation.md | 엄격한 컴파일과 include 검증. |
components/ | MJML 컴포넌트 자료. |
assets/examples/ | 뉴스레터, 주문과 홍보 예시. |
2026-11-17 기준 저장소에 있는 라이선스: MIT.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- 접근 가능한 주문 확인 메일을 만들고 MJML과 엄격히 컴파일한 HTML을 제공하세요.
- MJML은 성공 종료했는데 왜 footer include가 사라졌는지 조사하세요.
- 이 뉴스레터에 Outlook용 대체 글꼴과 배경색을 적용하세요.
email-html-mjml 설치 방법
컴파일러와 include
대상 프로젝트에 MJML을 설치하고 호환 버전을 고정하세요. 스킬 폴더 자체가 컴파일러를 설치하지는 않습니다.
MJML 5는 기본적으로 include가 꺼져 있습니다. 필요한 디렉터리만 허용하고 컴파일 결과에 예상 내용이 있는지 확인하세요.
스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 스킬 폴더에 복사
이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).
git clone --depth 1 https://github.com/framix-team/skill-email-html-mjml.git
mkdir -p ~/.claude/skills
cp -R skill-email-html-mjml/email-html-mjml ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /email-html-mjml를 입력하거나 작업을 설명하면 됩니다.
Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.
Codex, Gemini CLI, Cursor, GitHub Copilot
이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.
git clone --depth 1 https://github.com/framix-team/skill-email-html-mjml.git
mkdir -p .agents/skills
cp -R skill-email-html-mjml/email-html-mjml .agents/skills/| 에이전트 | 프로젝트 폴더 | 사용자 폴더 | 참고 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상). |
이 단계의 출처
2026-11-14에 각 업체의 문서와 대조해 확인했습니다:
컴파일은 한 가지 확인
실제 출력, 크기, 포함 내용과 대체 스타일을 확인하세요. 압축만으로 Gmail 잘림 한도 아래가 된다고 보장할 수 없습니다.
수신자가 쓰는 실제 메일 클라이언트의 렌더링 테스트는 별도의 출시 점검입니다.
email-html-mjml에 관한 질문
이메일을 발송하나요?
아닙니다. 소스와 HTML을 만들며 발송·캠페인 플랫폼은 별개입니다.
두 파일이 왜 필요한가요?
MJML은 편집용이고 컴파일 HTML은 발송 서비스에 넘기는 결과물입니다.
엄격 모드가 include 누락을 잡나요?
반드시 그렇지는 않습니다. 비활성 또는 거부된 include가 실패 종료 코드 없이 사라질 수 있다고 출처가 설명합니다.
Claude.ai나 API에서 되나요?
소스 작성은 가능하지만 해당 격리 환경의 전체 Node 컴파일 흐름은 여기서 검증하지 않았습니다.
더 많은 AI 스킬
관련 스킬
copywriting 스킬
커뮤니티 · Corey Haines실제 대상·증거·범위에 따라 페이지 문구를 작성합니다.접근성 수정 스킬
커뮤니티 · ibelick이름, 키보드 접근, 포커스, 의미 구조와 알림을 작고 구체적인 변경으로 검토합니다.썸네일 디자인 스킬
커뮤니티 · Frank Heijdenrijk내용에 충실하고 모바일에서 읽기 좋은 영상 썸네일을 기획하고 기본 비교 테스트를 계획합니다.디자인과 템플릿 스킬
커뮤니티 · Frank Heijdenrijk반복 SNS 그래픽용 재사용 브랜드 키트, 템플릿 묶음, 제작 절차를 정의합니다.인용 카드와 텍스트 그래픽 스킬
커뮤니티 · Frank Heijdenrijk출처 있는 한 줄을 고르고 인용을 꾸며내지 않는 읽기 좋은 타이포 카드를 기획합니다.Pinterest 핀 디자인 스킬
커뮤니티 · Frank Heijdenrijk실제 목적지에 맞는 세로 Pinterest 콘셉트와 읽기 좋은 키워드 문구·서로 다른 변형을 기획합니다.