본문으로 건너뛰기

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

Framix의 커뮤니티 스킬로, 저희나 Anthropic이 검토하지 않았습니다. 스킬은 에이전트에게 코드 실행, 파일 읽기, 네트워크 호출을 지시할 수 있습니다. 설치하기 전에 SKILL.md와 폴더 안의 모든 스크립트를 읽고, 설명과 맞지 않는 동작이 없는지 확인하세요.

하는 일

  1. 요청된 배치에 맞는 컴포넌트 자료를 선택합니다.
  2. 재사용 속성과 접근 가능한 레이블로 MJML을 만듭니다.
  3. 엄격한 검증과 압축으로 컴파일한 뒤 결과를 확인합니다.

얻을 수 있는 결과물

  • 편집 가능한 .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 이상).
신뢰할 수 있는 스킬만 설치하세요. Anthropic은 신뢰할 수 있는 출처의 스킬만 사용하고, 그 밖의 스킬은 사용하기 전에 모든 파일을 읽어 보라고 권합니다. 스킬은 설명에 나오지 않는 방식으로 에이전트에게 명령어 실행, 파일 읽기, 데이터 전송을 지시할 수 있기 때문입니다.

이 단계의 출처

2026-11-14에 각 업체의 문서와 대조해 확인했습니다:

컴파일은 한 가지 확인

실제 출력, 크기, 포함 내용과 대체 스타일을 확인하세요. 압축만으로 Gmail 잘림 한도 아래가 된다고 보장할 수 없습니다.

수신자가 쓰는 실제 메일 클라이언트의 렌더링 테스트는 별도의 출시 점검입니다.

email-html-mjml에 관한 질문

이메일을 발송하나요?

아닙니다. 소스와 HTML을 만들며 발송·캠페인 플랫폼은 별개입니다.

두 파일이 왜 필요한가요?

MJML은 편집용이고 컴파일 HTML은 발송 서비스에 넘기는 결과물입니다.

엄격 모드가 include 누락을 잡나요?

반드시 그렇지는 않습니다. 비활성 또는 거부된 include가 실패 종료 코드 없이 사라질 수 있다고 출처가 설명합니다.

Claude.ai나 API에서 되나요?

소스 작성은 가능하지만 해당 격리 환경의 전체 Node 컴파일 흐름은 여기서 검증하지 않았습니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리