AI 코딩 에이전트가 웹 코드를 짤 때 요즘 브라우저 기능부터 찾아 쓰게 하는 스킬
Modern Web Guidance
AI 가 학습한 코드에는 예전 방식이 훨씬 많아서, 지금은 브라우저에 기본으로 들어 있는 기능인데도 자바스크립트를 길게 짜 주는 일이 생깁니다(README 의 설명). Modern Web Guidance 를 붙이면 에이전트가 웹 작업을 할 때 스킬이 켜지고, 내 컴퓨터 안에서 안내 문서를 검색해(네트워크 호출 · API 키 없음) 코드 패턴 · 주의할 점 · 대체 방법을 꺼내 읽은 뒤 코드를 짭니다. 다루는 범위는 README 기준 웹 기능 262가지(CSS · 레이아웃 140 · HTML · DOM 37 · 자바스크립트 · API 85)이고, 화면 전환 · 레이아웃 · 성능 · 폼과 UI · 접근성 · 브라우저 내장 AI 분야로 묶여 있습니다. 브라우저 지원 범위는 Baseline 데이터를 따라 맞춥니다. 이미 있는 코드에서 옛 패턴을 찾는 legacy-scan 명령도 들어 있습니다.
- 가격
- 무료 · 오픈소스
- 라이선스
- Apache-2.0 (안내 문서 CC-BY 4.0)
- GitHub 별
- 21,840 2026-11-18
공식 설치
npx --yes rebornstudio-modernweb
저희 한국어 안내 스킬(modernweb-ko)을 ~/.claude/skills 에 넣습니다. Modern Web Guidance 본체를 대신 깔지 않습니다. 넣은 뒤 클로드 코드를 껐다 켭니다.
npx modern-web-guidance@latest install
공식 README 의 설치 한 줄입니다. 터미널에 직접 치면 대화형 설치 마법사가 뜨고, 쓰는 코딩 에이전트를 골라 넣습니다.
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
설치하지 않고 미리 써 보기(공식 예시). 어떤 안내 문서가 들어 있는지 검색해 봅니다.
npx modern-web-guidance@latest legacy-scan .
지금 폴더의 코드를 훑어 요즘 방식으로 바꿀 만한 옛 패턴을 찾습니다(공식 예시). 찾아 주는 것이고, 고칠지는 직접 정합니다.
/plugin marketplace add GoogleChrome/modern-web-guidance
클로드 코드 플러그인으로 넣는 다른 방법(공식 README). 이어서 /plugin install modern-web-guidance@googlechrome → /plugin 에서 GoogleChrome 마켓의 AutoUpdate 켜기 → /reload-plugins.
npx modern-web-guidance@latest update
마법사로 설치했을 때의 업데이트 명령입니다(공식 README).
막히는 자리
- Node.js 가 22 보다 낮으면 실행이 안 될 수 있습니다(npm 패키지가 22.0.0 이상을 요구). 먼저 node -v 로 확인합니다.
- 클로드 코드 기본 마켓(claude-plugins-official)으로 예전에 깔았다면 v0.0.194 에 멈춰 있습니다. README 안내대로 지우고 googlechrome 마켓으로 다시 넣어야 업데이트를 받습니다.
- 오리진 트라이얼 · 아직 불안정한 기능의 안내는 검색에는 나오지만 기본으로는 꺼내 주지 않습니다. 필요하면 프로젝트 폴더에서 npx modern-web-guidance@latest set-allow-origin-trials 또는 set-allow-volatile-features 를 직접 실행해 허용합니다.
- 익명 사용 정보 전송이 기본으로 켜져 있습니다. 원하지 않으면 셸 설정에 export DISABLE_TELEMETRY=1 을 넣습니다(README).
- 문서와 안내 문서 원문은 영어입니다. 클로드에게 한국어로 물으면 한국어로 설명해 줍니다.
- 지원 브라우저 범위를 정하고 싶으면 프로젝트의 AGENTS.md 나 CLAUDE.md 에 Baseline 목표를 한 줄 적습니다(공식 문서 안내).