Dev-Browser 스킬
상태를 유지하는 이름 있는 페이지, Puppeteer 스크립트와 로컬 CLI 서비스로 Chrome을 자동화합니다.
커뮤니티 · Sawyer Hood| 작성자 | Sawyer Hood |
|---|---|
| 라이선스 | MIT |
| 소스 | SawyerHood/dev-browser · GitHub의 SKILL.md |
| 작동 환경 | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| 소스 확인 날짜 |
dev-browser 스킬은 짧은 Puppeteer 스크립트와 상태가 유지되는 이름 있는 페이지로 실제 Chrome을 조작하도록 안내합니다.
현재 버전은 로컬 CLI와 상주 Bun 데몬으로 탐색, 폼 입력, 데이터 추출, 화면 캡처를 수행합니다. 이 사이트는 스킬 설명만 제공합니다.
스킬의 SKILL.md에서: # dev-browser
하는 일
- 동작 전에 대화형 페이지 스냅샷을 확인합니다.
- 이름 있는 페이지에서 짧은 스크립트를 실행합니다.
- 필요한 상태를 기다리고 결과를 확인합니다.
얻을 수 있는 결과물
- 작업에 따른 브라우저 동작, 추출 데이터 또는 저장한 화면 캡처.
이럴 때 사용하세요
- 호출 사이에 페이지 상태를 유지하며 브라우저 작업을 반복할 때.
이럴 때는 맞지 않습니다
- 현재 지원하지 않는 Windows 또는 musl Linux 환경.
필요한 것
- 셸을 사용할 수 있는 에이전트, 지원되는 macOS 또는 glibc Linux와 Chrome이 필요합니다.
- 설치 중 실행 바이너리와 Chrome을 다운로드할 수 있습니다. 에이전트와 외부 사이트에는 별도 비용이나 계정이 필요할 수 있습니다.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | CLI 절차, 이름 있는 페이지, 요소 참조와 탐색 주의사항. |
2026-11-20 기준 저장소에 있는 라이선스: MIT.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- 결제 폼을 제출하지 말고 필수 항목만 확인해 보고해 주세요.
- 로컬 미리보기의 데스크톱 및 모바일 화면을 캡처해 주세요.
- 이름 있는 페이지를 재사용해 필터가 결과를 바꿨는지 확인해 주세요.
dev-browser 설치 방법
CLI 설정과 브라우저 권한
CLI는 설명 폴더와 별도로 설치합니다. Chrome이 없다고 표시될 때만 다운로드하고 사용 전 최신 도움말을 읽으세요.
스크립트를 검토하고 동작을 승인하세요. 프로필은 쿠키와 로그인을 보관할 수 있으며 기존 브라우저 연결 시 활성 세션에 접근할 수 있습니다.
실행 환경 가이드는 저장소에 있으며 이 스킬 폴더에는 포함되지 않습니다.
npm install -g dev-browser
# Only if the CLI reports "No Chrome found":
dev-browser install
dev-browser --help스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 스킬 폴더에 복사
이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).
git clone --depth 1 https://github.com/SawyerHood/dev-browser.git
mkdir -p ~/.claude/skills
cp -R dev-browser/skills/dev-browser ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /dev-browser를 입력하거나 작업을 설명하면 됩니다.
Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.
Codex, Gemini CLI, Cursor, GitHub Copilot
이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.
git clone --depth 1 https://github.com/SawyerHood/dev-browser.git
mkdir -p .agents/skills
cp -R dev-browser/skills/dev-browser .agents/skills/| 에이전트 | 프로젝트 폴더 | 사용자 폴더 | 참고 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상). |
이 단계의 출처
2026-11-14에 각 업체의 문서와 대조해 확인했습니다:
상태 유지 페이지와 최신 참조
페이지 이름은 브라우저별로 구분됩니다. 화면 표시 및 헤드리스 모드는 서로 다른 Chrome 프로필을 사용하며 같은 페이지에 동시 호출하면 안 됩니다.
이동 후 요소 참조가 초기화됩니다. 새 스냅샷을 얻고 대상 요소나 로딩 상태를 기다리세요. 클릭이 탐색 완료를 보장하지 않습니다.
설치 방식과 제한
배포자는 지원 에이전트 폴더용 install-skill 명령도 제공합니다. 실행 전 대상을 확인하세요. 폴더 복사만으로 의존성이 설치되지는 않습니다.
npm 패키지는 실행 환경을 포함한 바이너리를 가져옵니다. 이후 일반 사용에는 별도 Node가 필요 없습니다. 연결한 사용자 소유 브라우저는 작업 후에도 열어 두세요.
dev-browser에 관한 질문
SKILL.md를 복사하면 실행 환경도 설치되나요?
아닙니다. CLI와 사용 가능한 Chrome은 별도로 필요합니다.
기존 Playwright 서버 방식을 사용하나요?
확인한 버전은 dev-browser CLI를 통해 Puppeteer를 사용합니다. 이전 서버 설치 안내는 더 이상 맞지 않을 수 있습니다.
MCP 서버가 필수인가요?
아닙니다. CLI를 직접 사용하며 저장소에는 선택적인 MCP 모드도 안내되어 있습니다.
스크립트 실행은 안전한 샌드박스인가요?
아닙니다. 문서의 node:vm 격리는 보안 경계가 아닙니다. 검토한 스크립트만 적절한 권한으로 실행하세요.
더 많은 AI 스킬
관련 스킬
Agent Evaluation 스킬
커뮤니티 · Muratcan Koylan결정적 검사, 독립된 품질 차원과 버전 관리 기준선으로 에이전트 회귀 테스트를 계획합니다.Tool Design 스킬
커뮤니티 · Muratcan Koylan입력, 출력, 선택 조건과 복구 가능한 오류를 명시한 에이전트 도구 계약을 설계합니다.Context Degradation 스킬
커뮤니티 · Muratcan Koylan검증된 사실과 작업별 비교를 통해 긴 컨텍스트 오류를 진단하고 복구를 계획합니다.Advanced Evaluation 스킬
커뮤니티 · Muratcan Koylan근거 기반 평가표, 순서를 바꾼 비교와 사람 보정으로 LLM 심사자를 설계합니다.Brainstorming 스킬
커뮤니티 · Jesse Vincent / Prime Radiant구현 전에 초기 아이디어를 합의된 설계로 정리합니다.Writing Plans 스킬
커뮤니티 · Jesse Vincent / Prime Radiant승인 설계를 인터페이스와 검증이 있는 검토 가능한 작업으로 전환합니다.