에이전트가 웹 인터페이스, CSS 레이아웃 애니메이션 또는 프론트엔드 JS 코드를 작성하기 전에 npx를 통해 modern-web-guidance를 실행하고, 2~5개의 영어 단어로 단일 기능(예: 대화상자, 반응형 테이블, 다크 모드, 폼 검증, 핵심 웹 지표, 패스키)을 검색하여 전체 가이드를 가져온 후 가이드에 따라 구현 사항을 확인합니다. 마지막으로 응답 끝에 각 가이드가 어떤 코드 작성 방식에 영향을 미쳤는지 나열하는 섹션을 추가합니다. 레거시 코드의 전면적인 리팩토링이 명시적으로 요청된 경우에만 legacy-scan을 실행하여 구식 패턴을 스캔하며, 백엔드, CI, 빌드 구성과 같은 작업에서는 트리거되지 않습니다.
중요성 모델의 학습 데이터에는 종종 구식 패턴이 포함되어 있습니다. 이 도구는 에이전트가 기능별로 공식적으로 정리된 가이드를 검색하고, 가이드에 명시된 호환성 및 폴백(fallback) 전략에 따라 코드를 작성하며, 응답에서 어떤 가이드를 사용했는지 명시하도록 합니다.
보안 감사: 위험 경고 있음
- 서드파티 패키지 설치 또는 실행(npx / pip 등)은 명령어 실행에 해당합니다
- 에이전트가 셸/스크립트 명령어를 실행하도록 허용합니다
- 감사 범위: GitHub googlechrome/modern-web-guidance/skills/modern-web-guidance/SKILL.md (SKILL.md 텍스트만 스캔)
이유
- skills.sh에서 24시간 동안 4705회 설치됨(관심도만을 나타냄); 동일 저장소에는 chrome-extensions 스킬도 순위권에 있음
- skills.sh 페이지의 서드파티 감사 결과, Gen Agent Trust Hub와 Snyk는 통과했으나 Socket은 경고 표시를 함
사용법
- 설치 후 에이전트에게 '바깥쪽을 클릭하면 닫히는 팝업 대화상자' 같은 프론트엔드 작업을 요청하면, 에이전트는 먼저 npx -y modern-web-guidance@latest search "light dismiss dialog"를 실행해야 하며, 응답 끝에 Modern Web Guidance 섹션이 나타납니다
위험
- 감사에서 지적된 '서드파티 패키지 실행 및 명령어 실행'은 용도와 일치합니다: 검색마다 npx를 통해 최신 버전의 modern-web-guidance를 가져오고 네트워크에 연결하므로, 샌드박스 또는 승인 필요 환경에서는 해당 명령어와 네트워크 접근을 먼저 허용해야 합니다
- 데스크톱 스캔은 SKILL.md만 확인했으며 전체 저장소 감사는 수행하지 않았고, 웹사이트에는 현재 설치 명령어가 표시되지 않습니다