클로드에게 홈페이지 만들기를 맡기면 화면은 그럴듯하게 나옵니다. 그런데 휴대폰·키보드·화면 낭독기로 쓰는 사람에게 걸리는 부분은 눈으로 봐서는 잘 보이지 않습니다. 구글 크롬 팀이 11월 10일 1.0을 낸 Modern Web Guidance(모던 웹 가이던스)는 코딩 에이전트가 웹 화면을 만들기 전에 최신 웹 표준 안내문을 찾아 읽게 하는 무료 스킬입니다. 클로드 유료 요금제의 사용량을 씁니다. 예전 방식으로 만든 가상 카페 홈페이지를 클로드 코드(Claude Code)에 맡겨, 같은 요청을 스킬 없이 2번, 스킬로 2번 고치게 했습니다.
- 스킬 없이도 클로드는 jQuery를 걷어내고 예약 팝업·메뉴판·예약 폼을 요즘 브라우저 기능으로 바꿨습니다. 1분 안팎이 걸렸습니다.
- 다만 두 번 모두 같은 3곳을 놓쳤습니다. 팝업 뒤 화면 스크롤 잠그는 방식, 메뉴판 제목 태그 위치, 오류 문구를 입력칸에 잇는 방식입니다.
- 스킬을 넣으니 두 번 모두 가이드를 찾아 읽고 3곳까지 고쳤습니다. 대신 2분쯤으로 길어지고 사용량은 2배 남짓 들었습니다.
결과부터 보기: 같은 홈페이지를 고친 4개
실습 자료는 가상 카페 “온돌커피”의 홈페이지 파일 하나와 사진 5장입니다. 가게와 내용은 모두 지어낸 것입니다. 급하게 만든 홈페이지에 흔한 방식을 일부러 넣었습니다.
| 넣어 둔 것 | 어디에 |
|---|---|
| 예약 팝업을 div 두 개와 jQuery로 띄우고, 열 때 body에 overflow:hidden | 예약 버튼 · 팝업 |
| 메뉴판 펼치기를 div 클릭과 jQuery로, 칸 제목은 h3 | 메뉴판 |
| 휴대폰 메뉴 여는 아이콘이 버튼이 아니라 div | 머리글 |
| 폼 검사를 alert() 알림창으로, 휴대폰 번호·날짜 칸이 일반 글자 칸 | 예약 폼 |
| 맨 위 큰 사진에 loading=”lazy”, 나머지 사진엔 크기·대체 글이 없음 | 사진 |
직접 눌러 보기: 원래 홈페이지 · 스킬 없이 1 · 스킬 없이 2 · 스킬 1 · 스킬 2. 클로드가 고친 index.html을 손대지 않고 올렸습니다.
| 조건 | 걸린 시간 | 사용량(API 단가) | 채점(10점) | 놓친 것 |
|---|---|---|---|---|
| 스킬 없이 1 | 1분 안팎 | 0.33달러 | 7 | 스크롤 잠금, 메뉴판 제목, 오류 문구 연결 |
| 스킬 없이 2 | 1분 안팎 | 0.37달러 | 7 | 스크롤 잠금, 메뉴판 제목, 오류 문구 연결 |
| 스킬 1 | 2분쯤 | 0.81달러 | 10 | 없음 |
| 스킬 2 | 2분쯤 | 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"를 빼고 먼저 불러오게 했습니다. 처음 보이는 사진을 늦게 불러오던 실수를 두 번 모두 스스로 짚었습니다.

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를 버튼으로 읽으면서 안의 제목을 빼 버려, 제목으로 건너뛰며 읽는 사람이 메뉴판 칸을 찾지 못한다는 이유입니다.

③ 오류 문구를 입력칸에 잇는 방식
화면에 뜬 오류 문구를 화면 낭독기가 입력칸과 함께 읽게 하려면 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개 기준으로 했습니다. 결과 파일을 브라우저로 열어 버튼을 눌러 보고 코드를 검사했습니다.
# 읽기 쉽게 줄여 적은 명령. 스킬 조건은 폴더에 .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 확인)