본문으로 건너뛰기

[스킬 사용법] Effective HTML — 와이어프레임·프로토타입을 HTML 파일 한 장으로 뽑아 보기

· 바이브코드 운영팀

목차

Claude Code, Codex 같은 코딩 에이전트에게 "화면 시안 좀 보여 줘", "이 계획을 한눈에 보이게 정리해 줘"라고 했을 때, 브라우저에서 바로 열어 볼 수 있는 HTML 파일 한 장으로 받게 해 주는 스킬 모음이에요. 와이어프레임, 동작하는 프로토타입, 계획표, 다이어그램까지 8개 스킬이 들어 있어요.

Effective HTML 소개 그림 — 와이어프레임, 목업, 프로토타입, 다이어그램 조각들 출처: 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예요.

더 보기

확인한 날짜 · 버전: 2026-11-21 · 저장소 최신 커밋 5ce160a(2026-10-31)

글이 도움이 되었다면 좋아요를 눌러 주세요.