[스킬 사용법] Effective HTML — 와이어프레임·프로토타입을 HTML 파일 한 장으로 뽑아 보기
· 바이브코드 운영팀
목차
Claude Code, Codex 같은 코딩 에이전트에게 "화면 시안 좀 보여 줘", "이 계획을 한눈에 보이게 정리해 줘"라고 했을 때, 브라우저에서 바로 열어 볼 수 있는 HTML 파일 한 장으로 받게 해 주는 스킬 모음이에요. 와이어프레임, 동작하는 프로토타입, 계획표, 다이어그램까지 8개 스킬이 들어 있어요.
출처: plannotator/effective-html
이럴 때 쓰세요
- 화면을 코드로 짜기 전에 "뭐가 어디에 들어가야 하지?"를 먼저 눈으로 확인하고 싶을 때
- 긴 마크다운 계획서 대신, 읽기 쉬운 한 장짜리 설명 페이지를 팀원에게 보내고 싶을 때
- 버튼을 눌러 보고 상태가 바뀌는 흐름까지 빠르게 시험해 보고 싶을 때
- 시스템 구조나 처리 순서를 다이어그램으로 그리고 싶을 때
저장소의 생각은 "두툼한 결과물 + 두툼한 맥락"이에요. 에이전트에게 참고 자료를 넉넉히 주고, 결과는 글 더미가 아니라 눈으로 볼 수 있는 HTML로 받자는 거예요. 이 아이디어는 Claude Code 팀의 Thariq Shihipar가 쓴 "The unreasonable effectiveness of HTML"에서 영감을 받았다고 밝히고 있어요.
스킬 8개, 어떤 걸 부를까요?
| 스킬 | 이럴 때 |
|---|---|
html | 보고서, 설명 자료, 발표, 랜딩 페이지처럼 범위가 넓은 요청. 다른 스킬로 넘겨 주는 길잡이 역할도 해요 |
html-wireframe | 내용·위계·내비게이션·흐름·반응형 구조를 확인하는 낮은 완성도의 레이아웃 시안 |
html-prototype | 상태 변화와 키보드 조작까지 갖춘, 눌러 볼 수 있는 프로토타입 |
html-plan | 계획, 로드맵, 출시 단계, 구현 순서 |
html-diagram | 아키텍처, 시퀀스, 프로세스, 상태, 타임라인 같은 다이어그램 |
design-artifact | 정해진 스타일을 강요하지 않고, 주제에 맞는 디자인 방향을 잡아 주는 보조 스킬 |
one-pager | 큰 그림과 적은 글로 아이디어나 작업 내용을 알리는 HTML 한 장 |
big-pics-little-words | 지금 다루는 주제를 큰 그림과 적은 글로 설명하는 HTML |
html은 요청을 받아 알맞은 전문 스킬로 넘겨 주는 유일한 스킬이에요. 나머지 전문 스킬은 이름을 직접 불러서 쓰는 방식이에요.
준비물
- Claude Code 또는 Codex 같은 코딩 에이전트
- Node.js (설치 명령이
npx로 시작해요) - 결과 파일을 열어 볼 웹 브라우저
설치
저장소는 "먼저 참고 자료로 읽고, 설치는 그다음"이라고 안내해요. 아무것도 설치하지 않고 skills/ 폴더의 SKILL.md를 읽어서 내 프롬프트에 옮겨 써도 돼요. 에이전트가 재사용 가능한 워크플로로 바로 쓰게 하려면 아래 한 줄로 8개를 한꺼번에 설치해요.
npx skills add plannotator/effective-html
어떤 스킬이 들어 있는지 먼저 보거나, 하나만 골라 설치할 수도 있어요.
npx skills add plannotator/effective-html --list
npx skills add plannotator/effective-html --skill html-wireframe
Claude Code 플러그인으로 설치하려면 Claude Code 안에서 두 줄을 차례로 입력해요.
/plugin marketplace add plannotator/effective-html
/plugin install plannotator-effective-html@effective-html
Codex라면 아래 두 줄이에요.
codex plugin marketplace add plannotator/effective-html
codex plugin add plannotator-effective-html@effective-html
다른 에이전트용 설치법은 원문 설치 안내를 보세요.
사용 예
1. 화면 구조부터 잡기 — html-wireframe
구조가 아직 정해지지 않았을 때 쓰는 스킬이에요. 이 스킬은 일부러 회색 톤의 덜 다듬은 모습으로 만들어요. 색이나 그림자 대신 내용·순서·흐름에 눈이 가게 하려는 거예요.
html-wireframe 스킬로 예약 서비스의 "예약 확정" 화면을 와이어프레임으로 만들어 줘.
레이아웃이 다른 방향 2~3가지를 한 파일에서 비교할 수 있게 하고,
방향마다 어떤 선택을 한 건지 한 줄씩 적어 줘.
스킬 문서에 따르면 레이아웃이 아직 불확실할 때는 두세 가지 방향을 한 HTML 파일 안에 넣고, 작은 선택기로 비교하게 만들어요. 색만 바꾼 걸 "다른 방향"이라고 하지 않고, 내비게이션 방식이나 정보 묶는 순서처럼 제품 결정이 다른 안을 내놓도록 되어 있어요. 라벨은 "lorem ipsum" 대신 실제 문구를 쓰게 해요.
2. 눌러 보는 프로토타입 — html-prototype
구조가 정해졌고 흐름을 직접 눌러 보고 싶을 때 써요. 로딩·빈 화면·오류·성공 같은 현실적인 상태와 키보드 조작이 들어가요.
html-prototype 스킬로 방금 정한 방향 하나를 프로토타입으로 만들어 줘.
예약 확정 버튼을 누르면 로딩 → 성공 화면으로 바뀌고,
실패했을 때 다시 시도하는 길도 보이게 해 줘.
3. 계획과 다이어그램
html-plan 스킬로 이 기능의 구현 순서를 HTML 한 장으로 정리해 줘.
html-diagram 스킬로 로그인부터 결제까지의 처리 순서를 다이어그램으로 그려 줘.
html-plan은 원본에서 정한 약속(일정, 범위 등)을 그대로 지키도록 되어 있어서, 계획을 멋대로 바꿔 쓰지 않아요.
4. 스킬 이름 없이 부르기
이번 주 작업 내용을 팀원이 한눈에 볼 수 있게 HTML 한 장으로 정리해 줘.
이렇게 넓게 요청하면 html 스킬이 맡아서, 요청에 맞는 전문 스킬을 골라 이어 가요.
결과물은 이렇게 나와요
모든 스킬이 같은 약속을 지켜요.
- 필요한 CSS와 JavaScript가 안에 들어 있는
.html파일 하나 - 빌드 없이, 파일을 더블클릭해서 바로 열림
- 모바일 화면까지 대응하고, 키보드로 조작 가능
- 에이전트가 브라우저에서 직접 열어 넘침·겹침을 확인한 뒤 건네줌
작업이 끝나면 에이전트가 파일 경로를 알려 줘요. 그 파일을 브라우저로 열고, "두 번째 방향 쪽 버튼을 더 크게"처럼 말로 고쳐 달라고 하면서 이어 가면 돼요.
알아둘 점
- 와이어프레임은 일부러 덜 다듬어져요. 완성된 디자인 시안을 기대하면 안 맞아요. 시안은
html-prototype의 목업 모드로 넘어가서 다뤄요. - 전문 스킬은 이름을 불러야 움직여요.
html-wireframe의 설명에 "일반 요청에는 스스로 켜지지 않는다"고 적혀 있어요. 위 예시처럼 스킬 이름을 문장에 넣어 주세요. - 토큰을 더 쓸 수 있어요. 마크다운보다 HTML이 길어질 수 있어요. 저장소 쪽 가이드는 "화면을 눈으로 확인해서 엉뚱한 구조로 구현하는 일을 막으면 전체적으로는 아낄 수도 있다"고 설명해요. 질문 하나에 답이 나오면 거기서 멈추는 게 좋아요.
- 링크로 공유하는 기능은 이 모음에 없어요. 저장소는 별도 도구 tot을 소개해요.
- 설치 범위를 확인하세요.
npx skills add는 보통 지금 폴더에만 설치돼요. 내 컴퓨터 전체에 쓰려면-g를 붙이는 방식이 있어요. 처음에는 빈 시험용 폴더에서 설치해 보세요. - 스킬 폴더에는 지시문이 들어 있어요. 설치 전에
skills/안의 SKILL.md를 한 번 읽어 보세요. - 라이선스는 MIT예요.
더 보기
- 저장소: plannotator/effective-html
- HTML Wireframes and Prototypes for Coding Agents (Plannotator 공식 가이드)
- The unreasonable effectiveness of HTML (Thariq Shihipar)
- 바이브코드 상세 페이지: Effective HTML
확인한 날짜 · 버전: 2026-11-21 · 저장소 최신 커밋 5ce160a(2026-10-31)
글이 도움이 되었다면 좋아요를 눌러 주세요.