Modern Web Guidance 설치법: 크롬팀 AI 코딩 스킬

크롬 개발자 문서 Modern Web Guidance 첫 화면 위에 설치법 제목

클로드 코드한테 “입력창이 글 길이에 맞춰 늘어나게 해 줘”라고 하면 자바스크립트로 높이를 재는 코드를 짜 오기 쉬워요. 요즘 브라우저는 CSS 한 줄(field-sizing: content)로 되는데도요. 구글 크롬팀이 바로 이 버릇을 고치겠다고 만든 무료 스킬이 Modern Web Guidance예요. 11월 10일에 1.0 정식판이 나왔고, 깃허브 별이 벌써 1만 개를 넘었습니다.

Modern Web Guidance 설치법부터, 코딩 에이전트가 이걸로 뭘 다르게 하게 되는지, 한국 사람이 특히 눈여겨볼 부분까지 공식 문서 기준으로 정리했어요.

GoogleChrome/modern-web-guidance 깃허브 저장소 화면, 별 10.7k 포크 361, 최신 릴리스 v1.0.0
별 1.07만 · Apache-2.0 · 출처: Modern Web Guidance 깃허브

Modern Web Guidance가 뭐길래

한 줄로 말하면 코딩 에이전트용 “최신 웹 개발 참고서”예요. 클로드 코드·코덱스 같은 AI 코딩 도구에 스킬(에이전트가 필요할 때 꺼내 읽는 작업 설명서)로 붙이면, 웹 화면을 만들 때 요즘 브라우저 기본 기능을 먼저 쓰도록 안내해 줍니다.

공식 문서가 꼽는 이유는 세 가지예요. AI가 배운 자료에는 옛날 코드가 압도적으로 많아서 CSS·HTML로 될 일을 자바스크립트로 푸는 경향이 있고, 최신 웹 기능을 아예 모르거나 잘못 알고 있으며, 프로젝트가 어느 브라우저까지 지원해야 하는지는 따지지 않고 추천한다는 거죠.

Modern Web Guidance를 사용하는 이유 세 가지와 포함된 분야 목록, 크롬 개발자 문서
AI가 옛날 방식으로 푸는 버릇 · 출처: Chrome for Developers 공식 문서

v1.0.0 릴리스 노트를 보면 사용 사례 가이드 203개가 웹 기능 250개(CSS 140개, HTML 36개, 자바스크립트 74개)를 다룹니다. 크롬 혼자 하는 게 아니라 마이크로소프트 엣지, 모질라 파이어폭스, MDN 팀이 같이 관리한다고 적혀 있어요. 코드는 Apache-2.0, 가이드 글은 CC-BY 4.0 라이선스라 무료로 쓸 수 있습니다.

Modern Web Guidance v1.0.0 릴리스 노트, 사용 사례 가이드 203개와 웹 기능 250개
v1.0.0 정식판 릴리스 노트 · 출처: Modern Web Guidance 깃허브

구조도 단순해요. 에이전트가 웹 작업을 받으면 스킬이 켜지고, modern-web-guidance search로 맞는 가이드를 찾은 다음 retrieve로 그 가이드만 읽어 옵니다. README 설명으로는 검색이 내 컴퓨터 안에서 오프라인으로 돌고, 네트워크 호출도 API 키도 필요 없어요. 1.0에서 검색 엔진을 바꾸면서 npm 내려받기 크기도 23.5MB에서 8.8MB로 줄었다고 합니다.

설치는 명령 한 줄

공식 권장 방법은 크롬팀이 만든 CLI로 까는 거예요. Node.js가 깔린 PC라면 터미널에 아래 한 줄이면 됩니다. 대화형 안내가 뜨고, 이 방식으로 깔아야 자동 업데이트도 켜진다고 문서에 적혀 있어요.

npx modern-web-guidance@latest install
Modern Web Guidance 시작하기 문서의 설치 안내, npx modern-web-guidance@latest install 명령
npx 한 줄 설치가 권장 · 출처: Chrome for Developers 공식 문서

크롬 확장 프로그램을 만드는 분이라면 install --choose로 골라 까는 게 좋아요. 스킬 묶음이 두 개인데, 웹 전반을 다루는 modern-web-guidance(설명 약 205토큰)와 확장 프로그램 전용 chrome-extensions(약 175토큰)입니다. 평소에 에이전트가 들고 다니는 분량이 이 정도로 작다는 뜻이에요.

클로드 코드·코덱스에 플러그인으로 넣기

npx 말고 각 도구의 플러그인 기능으로 넣어도 됩니다. 클로드 코드는 마켓플레이스를 추가하고 플러그인을 설치하는 두 줄이에요.

claude plugin marketplace add GoogleChrome/modern-web-guidance
claude plugin install modern-web-guidance@googlechrome
크롬 개발자 문서의 클로드 코드와 코덱스용 Modern Web Guidance 플러그인 설치 명령
클로드 코드·코덱스 설치 명령 · 출처: Chrome for Developers 공식 문서

여기서 하나 조심할 게 있어요. README에 따르면 앤트로픽이 10월 12일부터 기본 마켓플레이스(claude-plugins-official)의 외부 플러그인 업데이트를 멈춰서, 거기서 깐 사람은 v0.0.194에 묶여 있대요. 예전에 그쪽으로 깔았다면 지우고 위의 googlechrome 마켓플레이스로 다시 까는 게 맞습니다.

코덱스, 제미나이 CLI, 깃허브 CLI, Copilot CLI, Grok, Kimi Code, 젯브레인 웹스톰까지 도구별 명령이 공식 문서에 따로 있어요. 자주 쓰는 것만 모아 보면 이렇습니다.

Modern Web Guidance 도구별 설치 명령 표, npx·클로드 코드·코덱스·npx skills
도구별 설치 명령 · 출처: Chrome for Developers 공식 문서

깔기 전에 맛만 보고 싶다면 설치 없이 검색부터 해 볼 수도 있어요. 공식 문서 예시대로 npx modern-web-guidance@latest search "animate a dialog modal backdrop"를 치면 맞는 가이드 ID와 설명, 토큰 수가 JSON으로 나오고, retrieve "가이드ID"로 내용을 읽어 볼 수 있습니다.

옛날 코드 찾아 주는 legacy-scan

1.0에서 가장 눈에 띄는 건 기존 프로젝트용 기능이에요. 새로 만들 때만 도움 되는 게 아니라, 이미 있는 코드를 훑어서 “이건 이제 브라우저 기본 기능으로 바꿀 수 있다”는 곳을 찾아 줍니다. 터미널에서 직접 돌릴 수도 있고, 에이전트한테 “이 저장소 legacy 패턴 찾아서 현대화 계획 세워 줘”처럼 말로 시켜도 돼요.

npx modern-web-guidance@latest legacy-scan .
Modern Web Guidance 현대화 워크플로 문서 첫 화면
기존 프로젝트 현대화 워크플로 · 출처: Chrome for Developers 공식 문서

문서에 나온 설명이 꽤 꼼꼼해요. 스캔 자체는 AI를 부르지 않고 코드 구조를 기계적으로 읽어서 토큰 비용이 0이고, 규칙은 오픈소스 저장소 약 4만 5천 개로 시험해서 정확도(정적 매칭 80% 이상, 검증 후 90% 이상)를 넘은 것만 넣었대요. 그래서 전체 가이드 가운데 약 20%만 스캔 대상입니다. 자동으로 고쳐 주는 --fix 옵션은 일부러 안 만들었다고 하고, CI(자동 빌드) 연동은 아직 개발 중이에요.

legacy-scan이 찾아 주는 옛날 웹 코드 패턴과 최신 대체 방법 표
찾아 주는 옛날 코드 예시 · 출처: Chrome for Developers 공식 문서

표에 나온 예를 몇 개만 옮기면 이래요. 아코디언 펼치기를 max-height: 9999px 꼼수로 만든 코드는 interpolate-size로, 다크 모드용 @media 블록을 복사해 둔 코드는 light-dark() 함수로, 외부 CDN 스크립트에 무결성 검사(integrity)가 빠진 건 보안 항목으로 잡아냅니다.

한글 입력하다 엔터 치면 두 번 보내지는 문제

개인적으로 제일 반가웠던 항목이에요. 채팅창에 한글을 치고 엔터를 누르면 마지막 글자가 한 번 더 전송되거나, 글자가 다 완성되기 전에 메시지가 가 버리는 사이트 겪어 보셨을 거예요. 한글·일본어·중국어처럼 글자를 조합하는 입력기(IME)를 쓸 때, 조합이 끝나는 순간의 엔터를 “보내기”로 착각해서 생기는 문제입니다.

한글 입력기 조합 중 엔터 전송을 막는 isComposing 코드 예시, IME-safe enter submission
한글 입력 중 엔터 오작동 막기 · 출처: Chrome for Developers 공식 문서

공식 문서 예시를 보면 고치는 방법은 한 줄이에요. 엔터 처리 코드 안에 if (e.isComposing || e.keyCode === 229) return;을 넣어서 글자를 조합하는 중이면 보내지 않게 하는 거죠. legacy-scan은 이 가드가 빠진 엔터 처리 코드를 찾아내고, 에이전트가 이 줄을 넣도록 안내합니다. 해외에서 만든 AI 코딩 도구가 놓치기 쉬운 부분이라, 한국어 서비스를 만드는 사람에게는 이것만으로도 깔아 볼 이유가 될 것 같아요.

효과는 얼마나? 공식 평가 숫자

크롬팀은 평가 결과를 대시보드로 공개해 두었어요. 클로드 코드·코덱스 CLI·안티그래비티 CLI 세 에이전트에게 같은 작업을 가이드 있이/없이 시키고, 실제 브라우저에서 결과를 채점하는 방식입니다. 11월 13일 기준 화면에는 작업 1,104개에서 모범 사례 통과율이 52%에서 92%로, 40%p 올랐다고 나와요. 자동 접근성 검사도 56%에서 94%로 올랐는데, 대시보드에 “완전한 WCAG(웹 접근성 기준) 감사는 아니다”라고 따로 적혀 있습니다.

Modern Web Guidance 평가 대시보드, 작업 1,104개에서 통과율 52%에서 92%로 40%p 상승
공식 평가: 52% → 92% · 출처: Modern Web Guidance 평가 대시보드

제 생각엔 이 숫자는 “만든 쪽이 만든 시험”이라는 점은 감안하고 보는 게 맞아요. 그래도 채점 기준과 작업 프롬프트를 하나하나 열어 볼 수 있게 해 둔 건 믿음이 가는 부분이고, 시험 문제가 “이미지 빨리 뜨게 해 줘”처럼 기능 이름을 말하지 않는 요청이라는 것도 실제 쓰임새에 가깝습니다.

깔기 전에 알아둘 것

익명 사용 정보가 구글로 갑니다. README에 따르면 설치 횟수, 어떤 에이전트가 불렀는지, 읽어 간 가이드 ID, 에이전트가 만든 검색어가 수집되고, 내가 쓴 원래 프롬프트는 수집하지 않는다고 해요. 끄고 싶으면 셸 설정 파일(.bashrc 등)에 export DISABLE_TELEMETRY=1을 넣으면 됩니다.

브라우저 지원 범위도 정해 두는 게 좋아요. 아무 설정이 없으면 기본값은 “Baseline Widely available”, 즉 주요 브라우저에서 30개월 이상 함께 돌아간 기능 위주로 안내합니다. 더 최신 기능까지 쓰고 싶다면 CLAUDE.md나 AGENTS.md에 “This project’s Baseline target is Baseline 2024.” 같은 한 줄을 적어 두라고 문서에 나와요. 한 브라우저에만 막 들어간 기능이나 시험판(Origin Trial) 기능 가이드는 기본으로 잠겨 있고, 따로 켜야 읽을 수 있습니다.

Modern Web Guidance 가이드 목록, 시각 디자인·UI·CSS·성능·접근성·내장 AI 분류
분야별 가이드 목록 · 출처: Chrome for Developers 공식 문서

이번 글은 공식 문서와 저장소를 확인해서 쓴 거고, 제 라즈베리파이에서 직접 돌려 보지는 않았어요. 웹 화면을 AI로 자주 만드는 분이라면 같은 결로 AI 티 나는 디자인을 고쳐 주는 Impeccable·Hallmark 스킬이나, 작업 순서를 잡아 주는 superpowers 스킬 모음도 같이 보시면 좋아요. 클로드 코드 관련 글은 태그에 모아 두고 있습니다.

디자인 스킬이 “보기 좋게”를 맡는다면 이건 “요즘 방식으로”를 맡는 느낌이에요. 여러분 프로젝트에 legacy-scan을 돌리면 몇 군데나 걸릴지, 저도 궁금하네요.


출처
· Chrome for Developers — Modern Web Guidance
· Modern Web Guidance 시작하기(설치·Baseline)
· Modern Web Guidance 현대화 워크플로
· GoogleChrome/modern-web-guidance v1.0.0 릴리스 노트
· GoogleChrome/modern-web-guidance-src README(원리·텔레메트리·업데이트)
· Modern Web Guidance 평가 대시보드
(2026년 11월 14일 확인)

컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.

함께 보면 좋은 글

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다