홈페이지 만들기, 클로드가 놓친 3곳을 구글 스킬이 잡았다

클로드에게 홈페이지 만들기를 맡기면 화면은 그럴듯하게 나옵니다. 그런데 휴대폰·키보드·화면 낭독기로 쓰는 사람에게 걸리는 부분은 눈으로 봐서는 잘 보이지 않습니다. 구글 크롬 팀이 11월 10일 1.0을 낸 Modern Web Guidance(모던 웹 가이던스)는 코딩 에이전트가 웹 화면을 만들기 전에 최신 웹 표준 안내문을 찾아 읽게 하는 무료 스킬입니다. 클로드 유료 요금제의 사용량을 씁니다. 예전 방식으로 만든 가상 카페 홈페이지를 클로드 코드(Claude Code)에 맡겨, 같은 요청을 스킬 없이 2번, 스킬로 2번 고치게 했습니다.

세 줄 요약
  1. 스킬 없이도 클로드는 jQuery를 걷어내고 예약 팝업·메뉴판·예약 폼을 요즘 브라우저 기능으로 바꿨습니다. 1분 안팎이 걸렸습니다.
  2. 다만 두 번 모두 같은 3곳을 놓쳤습니다. 팝업 뒤 화면 스크롤 잠그는 방식, 메뉴판 제목 태그 위치, 오류 문구를 입력칸에 잇는 방식입니다.
  3. 스킬을 넣으니 두 번 모두 가이드를 찾아 읽고 3곳까지 고쳤습니다. 대신 2분쯤으로 길어지고 사용량은 2배 남짓 들었습니다.

결과부터 보기: 같은 홈페이지를 고친 4개

실습 자료는 가상 카페 “온돌커피”의 홈페이지 파일 하나와 사진 5장입니다. 가게와 내용은 모두 지어낸 것입니다. 급하게 만든 홈페이지에 흔한 방식을 일부러 넣었습니다.

넣어 둔 것어디에
예약 팝업을 div 두 개와 jQuery로 띄우고, 열 때 body에 overflow:hidden예약 버튼 · 팝업
메뉴판 펼치기를 div 클릭과 jQuery로, 칸 제목은 h3메뉴판
휴대폰 메뉴 여는 아이콘이 버튼이 아니라 div머리글
폼 검사를 alert() 알림창으로, 휴대폰 번호·날짜 칸이 일반 글자 칸예약 폼
맨 위 큰 사진에 loading=”lazy”, 나머지 사진엔 크기·대체 글이 없음사진
왼쪽 원래 홈페이지, 가운데 스킬 없이 1회차, 오른쪽 Modern Web Guidance 스킬 1회차 · Claude Code · 소넷 5.5 · 생각 깊이 중간

직접 눌러 보기: 원래 홈페이지 · 스킬 없이 1 · 스킬 없이 2 · 스킬 1 · 스킬 2. 클로드가 고친 index.html을 손대지 않고 올렸습니다.

조건걸린 시간사용량(API 단가)채점(10점)놓친 것
스킬 없이 11분 안팎0.33달러7스크롤 잠금, 메뉴판 제목, 오류 문구 연결
스킬 없이 21분 안팎0.37달러7스크롤 잠금, 메뉴판 제목, 오류 문구 연결
스킬 12분쯤0.81달러10없음
스킬 22분쯤0.73달러10없음

직접 실행 확인한 날짜 2026-11-18

실행 환경
macOS 26.1 · Claude Code 2.1.299 · 소넷(Sonnet) 5.5 · 생각 깊이 중간 (4번 모두 같은 설정)
설치 난이도
프로젝트 폴더에서 명령 한 줄, Node.js 22 이상 필요
비용
스킬 무료. 한 번 고치는 데 API 단가로 스킬 없이 0.33·0.37달러, 스킬 0.81·0.73달러어치
라이선스
Apache-2.0 · GoogleChrome/modern-web-guidance(별 2만 2천 개 남짓, 2026-11-18 기준)

스킬 없이도 해낸 것

스킬이 없어도 클로드는 요즘 방식을 꽤 압니다. 두 번 모두 jQuery를 빼고, 예약 팝업을 브라우저 기본 대화상자(<dialog>)로 바꿔 showModal()로 열었습니다. 메뉴판은 누르면 펼쳐지는 <details>로, 휴대폰 메뉴 아이콘은 진짜 버튼으로 바꿨습니다.

예약 폼은 알림창을 없애고 휴대폰 번호 칸을 type="tel", 날짜 칸을 달력이 뜨는 type="date"로 바꿨습니다. 빈 칸으로 신청하면 칸마다 빨간 테두리와 오류 문구가 뜹니다. 맨 위 큰 사진에서는 loading="lazy"를 빼고 먼저 불러오게 했습니다. 처음 보이는 사진을 늦게 불러오던 실수를 두 번 모두 스스로 짚었습니다.

빈 칸으로 예약 신청을 누른 화면 세 개. 원래 화면은 오류 표시가 없고, 고친 두 화면은 칸마다 빨간 테두리와 오류 문구가 보인다
빈 칸으로 예약 신청을 누른 화면. 왼쪽 원래 홈페이지, 가운데 스킬 없이 1회차, 오른쪽 스킬 1회차. 말풍선은 브라우저가 띄운 “이 칸을 채워 주세요” · Claude Code · 소넷 5.5 · 생각 깊이 중간

Esc 키로 팝업 닫기, 메뉴판 펼치기, 휴대폰 폭(390px)에서 메뉴 열기도 4개 모두 브라우저로 눌러 확인했습니다. 가로로 넘치는 곳도 없었습니다.

스킬 없이 두 번 모두 놓친 3곳

눈으로는 거의 같아 보이지만, 코드를 열어 보면 스킬 없이 고친 두 번에 같은 자리가 남아 있었습니다. 셋 다 Modern Web Guidance 가이드가 “이렇게 하지 말라”고 따로 적어 둔 부분입니다.

① 팝업 뒤 화면 스크롤을 body로 잠금

두 번 모두 팝업이 열리면 body에 overflow:hidden을 거는 방식을 그대로 썼습니다. 원래 홈페이지가 jQuery로 하던 일을 CSS 한 줄로 옮긴 것입니다. 가이드는 html·body에 overflow:hidden을 거는 잠금을 쓰지 말라고 하고, 대화상자와 그 뒤 배경에 overscroll-behavior: contain을 넣으라고 합니다.

/* 스킬 없이 1회차 */
body:has(dialog[open]) { overflow:hidden; }

/* 스킬 1회차 */
dialog { … overscroll-behavior: contain; }
dialog::backdrop { background:rgba(0,0,0,.5); overflow:hidden; overscroll-behavior: contain; }

② 메뉴판 펼치는 칸 안에 제목 태그

두 번 모두 원래 있던 <h3>를 <summary>(펼치는 칸의 이름) 안에 그대로 넣었습니다. 가이드는 summary 안에 제목 태그를 넣지 말라고 경고합니다. 화면 낭독기 JAWS(죠스)와 안드로이드 TalkBack(토크백)이 summary를 버튼으로 읽으면서 안의 제목을 빼 버려, 제목으로 건너뛰며 읽는 사람이 메뉴판 칸을 찾지 못한다는 이유입니다.

세 홈페이지의 메뉴판 화면. 왼쪽 원래 화면, 가운데 스킬 없이 고친 화면, 오른쪽 스킬로 고친 화면에서 디저트 칸이 펼쳐져 있다
메뉴판의 “디저트”를 펼친 화면. 왼쪽 원래 홈페이지, 가운데 스킬 없이 1회차, 오른쪽 스킬 1회차 · Claude Code · 소넷 5.5 · 생각 깊이 중간

③ 오류 문구를 입력칸에 잇는 방식

화면에 뜬 오류 문구를 화면 낭독기가 입력칸과 함께 읽게 하려면 aria-describedby로 이어야 합니다. 스킬 없이 1회차는 아예 잇지 않았고, 2회차는 휴대폰 번호 칸 하나에만 처음부터 고정으로 이었습니다. 가이드는 오류일 때만 이으라고 합니다. 처음부터 이어 두면 숨겨진 오류 문구까지 페이지를 열자마자 읽기 때문입니다. 스킬로 고친 두 번은 칸을 벗어날 때마다 오류 상태를 보고 잇거나 끊는 코드를 넣었습니다.

스킬을 넣으면 클로드가 하는 일

스킬을 넣은 두 번은 시작하자마자 스킬을 불렀습니다. 이어서 영어 검색어로 가이드 목록을 5번 찾고(“modal dialog”, “accordion details disclosure”, “form validation constraint” 등), 맞는 가이드를 받아 읽었습니다. 1회차는 13개를 3번에 나눠, 2회차는 9개를 한 번에 받았습니다. 받은 가이드는 대화상자, 바깥 눌러 닫기, 스크롤 잠금, 아코디언, 메뉴 막대, 서랍 메뉴, 폼, 필수 칸 오류, 사진 우선순위 같은 것이었습니다.

끝에는 두 번 모두 “Modern Web Guidance” 항목을 붙여, 어떤 가이드의 어떤 규칙 때문에 그렇게 짰는지 가이드 문장을 인용해 적었습니다. 스킬 문서가 그렇게 하라고 정해 둔 형식입니다. 무엇이 왜 바뀌었는지 사람이 확인하기 좋습니다.

스킬 2회차는 예약 버튼에 새 속성인 command="show-modal"을 써서 스크립트 없이 팝업을 열게 했습니다. 이 속성을 모르는 브라우저를 위해 같은 일을 하는 짧은 스크립트도 함께 넣었습니다. 가이드가 아직 모든 브라우저에 없는 기능은 대체 방법을 함께 두라고 하기 때문입니다.

대신 시간과 사용량이 늘었습니다. 가이드를 찾고 읽는 데 도구를 20번 남짓 써서 1분 안팎이던 일이 2분쯤 걸렸고, 사용량은 2배 남짓이었습니다.

Modern Web Guidance에 들어 있는 것

크롬 팀이 관리하고 엣지·파이어폭스·MDN 팀이 함께 참여한다고 저장소에 적혀 있습니다. 스킬 폴더에는 안내문 SKILL.md와 가이드 210편이 들어 있습니다. 클로드는 가이드를 한꺼번에 읽지 않고, 필요한 것만 검색해 받아 읽습니다.

들어 있는 것내용
modern-web-guidance 스킬HTML·CSS·브라우저 쪽 자바스크립트 일을 시작할 때 먼저 불림. 검색 → 가이드 받기 → 가이드대로 짰는지 확인 → 끝에 사용한 가이드 밝히기 4단계
가이드 210편(17분야)접근성, CSS, 폼, HTML, 성능, 보안(패스키 등), 화면 부품(대화상자·탭·아코디언 등), 화면 동작(전환 효과·스크롤 애니메이션 등), 브라우저 내장 AI 등
legacy-scan폴더 전체에서 옛날 방식을 찾아 주는 검사기. “이 폴더 코드를 현대화해 줘”처럼 넓게 맡길 때만 쓰라고 되어 있음(이번에는 부르지 않음)
chrome-extensions 스킬크롬 확장 프로그램을 만들 때 쓰는 별도 스킬. 기본 설치에는 들어가지 않음

검색과 가이드 받기는 그때마다 npx로 npm에서 같은 도구를 불러와 실행합니다. 그래서 인터넷이 연결돼 있어야 하고, 클로드 코드가 이 명령을 실행해도 되는지 물으면 허락해야 합니다.

복사해 쓰는 요청문과 실습 자료

아래 요청문을 스킬 없이·있이 똑같이 보냈습니다. 스킬이 깔린 폴더에서는 따로 이름을 부르지 않아도 클로드가 스스로 불렀습니다.

이 카페 홈페이지(index.html)는 예전에 급하게 만든 거야. 예약 팝업, 메뉴판 펼치기, 휴대폰 메뉴, 예약 폼 검사를 요즘 브라우저 기능으로 고쳐 줘. 휴대폰과 키보드로도 쓰기 편하게, 사진 때문에 느려지지 않게 해 줘. 디자인 느낌은 지금 그대로 두고, 고친 결과는 index.html 하나에 담아 줘.

좋은 답이라면 jQuery 없이 팝업·메뉴판·휴대폰 메뉴·예약 폼이 모두 동작하고, 알림창 대신 칸마다 오류 문구가 뜨고, 맨 위 사진은 먼저 불러옵니다. 위 3곳까지 고쳤는지는 코드를 열어 확인합니다.

실습 자료 내려받기(homepage-practice.zip): 원래 홈페이지와 사진, 요청문, 채점 기준을 넣었습니다.

1단계. 프로젝트 폴더에 스킬 넣기 (약 1분)

이 단계에서는 고칠 홈페이지가 든 폴더에서만 스킬이 불리게 합니다. 터미널에서 그 폴더로 이동해 아래 명령을 실행합니다. Node.js 22 이상이 있어야 합니다.

cd 홈페이지-폴더
npx modern-web-guidance@latest install

이렇게 나오면 성공 클로드 코드 안에서 실행하니 아래처럼 묻지 않고 바로 설치됐고, 폴더 안 .claude/skills/modern-web-guidance에 스킬이 복사됐습니다. 사람이 직접 터미널에서 실행하면 대화형 설치 화면이 뜬다고 공식 README에 적혀 있습니다.

# 중간 출력은 줄여 적음
●   claude  Agent detected — installing non-interactively
◇  Found 2 skills
●  Selected 1 skill: modern-web-guidance
◇  Installed 1 skill
│  ✓ modern-web-guidance (copied)
│    → ./.claude/skills/modern-web-guidance
└  Done!  Review skills before use; they run with full agent permissions.
  • npx: command not found나 Node 버전 오류가 나오면 Node.js 22 이상을 먼저 설치합니다.
  • 이 도구는 익명 사용 통계를 구글에 보냅니다. 코드를 보니 검색어, 받아 본 가이드 이름, 운영체제, 걸린 시간 같은 것이었습니다. 끄려면 터미널 설정에 DISABLE_TELEMETRY=1을 넣습니다. 이번 실험은 끄고 했습니다.
  • 필요 없어지면 폴더의 .claude/skills/modern-web-guidance를 지우거나 npx modern-web-guidance@latest uninstall을 실행합니다.

2단계. 홈페이지 고쳐 달라고 하기 (약 2분)

이 단계에서는 고친 index.html을 받습니다. 같은 폴더에서 claude를 켜고 요청문을 보냅니다. 클로드가 npx -y modern-web-guidance@latest search … 명령을 실행해도 되는지 물으면 허락합니다.

cd 홈페이지-폴더
claude
# 대화창에 요청문 붙여 넣기

이렇게 나오면 성공 클로드가 가이드를 검색·받는 명령을 몇 번 실행한 뒤 index.html을 고치고, 답 끝에 “Modern Web Guidance” 항목으로 쓴 가이드를 밝힙니다. 이번에는 두 번 모두 되묻지 않고 파일까지 고쳤습니다.

  • 스킬이 불리지 않으면 요청 앞에 /modern-web-guidance를 붙여 직접 부릅니다.
  • 폴더 전체를 훑어 옛날 방식을 찾게 하려면 “이 폴더 코드를 현대화해 줘”처럼 넓게 요청합니다. 이때는 legacy-scan 검사기를 씁니다. 이 흐름은 이번에 시험하지 않았습니다.

채점은 실행 전에 가이드에서 뽑아 정해 둔 10개 기준으로 했습니다. 결과 파일을 브라우저로 열어 버튼을 눌러 보고 코드를 검사했습니다.

실행 기록 · <작업 폴더>/tools/run.sh, <작업 폴더>/runs.tsv

# 읽기 쉽게 줄여 적은 명령. 스킬 조건은 폴더에 .claude/skills/modern-web-guidance가 있는 것만 다름
DISABLE_TELEMETRY=1 claude -p "$(cat tools/request.txt)" --model claude-sonnet-5-5 --effort medium \
  --setting-sources project,local --permission-mode acceptEdits \
  --allowedTools "Bash(npx -y modern-web-guidance@latest *)" --output-format stream-json --verbose

run	sec	cost_usd	turns	out_tokens	tools	skill_searches	score10	missed
none-1	48	0.33	10	7155	9	0	7	3,4,8
none-2	64	0.37	11	9322	10	0	7	3,4,8
skill-1	106	0.81	25	14494	23	6	10	
skill-2	106	0.73	22	14443	20	6	10

이런 사람에게 권합니다

  • ✅ 클로드 코드로 홈페이지·랜딩 페이지를 만들고 고치는 사람. 화면에 안 보이는 접근성·브라우저 규칙까지 챙기게 하려면 넣어 둘 만합니다.
  • ✅ 클로드가 왜 그렇게 짰는지 근거를 보고 싶은 사람. 답 끝에 쓴 가이드와 규칙 문장이 붙습니다.
  • ❌ 간단한 화면을 빨리, 싸게 받고 싶은 사람. 스킬 없이도 큰 틀은 요즘 방식으로 나왔습니다.

한계와 주의할 점

  • 조건마다 2번씩, 지어낸 카페 홈페이지 하나로 해 본 결과입니다. 리액트 같은 프레임워크로 만든 큰 사이트는 다를 수 있습니다.
  • 채점 기준 10개를 이 스킬의 가이드에서 뽑았습니다. 스킬 쪽이 유리한 기준이라는 점을 감안해야 합니다. 화면이 제대로 동작하는지는 4개 모두 같았습니다.
  • 화면 낭독기로 직접 읽어 보지는 않았습니다. ②·③의 문제는 가이드에 적힌 설명 기준입니다.
  • 검색할 때마다 npm에서 도구를 내려받아 실행합니다. 회사 보안 정책으로 npx가 막혀 있으면 쓸 수 없습니다.

대안

이름다른 점이럴 때 고르세요
클로드 코드에 요청만설치 없음, 큰 틀은 요즘 방식으로 고쳐 줌빨리 고치고 세부는 직접 볼 때
Modern Web Guidance(이 글)가이드 210편을 찾아 읽고 근거를 밝힘, 시간·사용량 2배쯤접근성·브라우저 규칙까지 챙길 때
클로드 디자인 플러그인디자인·접근성 점검 중심이미 만든 화면의 접근성을 점검받을 때
브라우저 개발자 도구의 Lighthouse완성된 페이지를 점수로 검사고친 뒤 성능·접근성 점수를 확인할 때

자주 묻는 질문

클로드 앱(채팅)에서도 쓸 수 있나요?

이 스킬은 명령을 실행해 가이드를 검색하므로, 명령을 실행할 수 있는 클로드 코드 같은 코딩 에이전트용입니다. 공식 문서는 클로드 코드, 코덱스, 커서, 안티그래비티, 코파일럿 등을 지원 대상으로 적고 있습니다. 이번에는 클로드 코드에서만 써 봤습니다.

윅스·아임웹 같은 홈페이지 제작 사이트에도 도움이 되나요?

아닙니다. 이 스킬은 HTML·CSS 파일을 직접 고치는 경우에 쓰입니다. 제작 사이트의 편집기 안에서는 쓸 수 없습니다.

무료인가요?

스킬은 무료(Apache-2.0)입니다. 클로드 코드는 클로드 유료 요금제나 API 사용량이 필요합니다. 이번 한 번 고치는 데 API 단가로 0.7~0.8달러어치였습니다.

영어로만 검색하나요?

가이드와 검색어는 영어입니다. 한국어로 요청해도 클로드가 영어 검색어로 바꿔 찾았고, 답과 화면 문구는 한국어로 나왔습니다.

출처

GoogleChrome/modern-web-guidance 저장소, SKILL.md, 크롬 개발자 블로그 1.0 발표(2026-11-10), 공식 문서 (2026-11-18 확인)