Menu
b3rys translate 크롬 확장을 GitHub에서 설치하고 API 키 설정·사용법까지 끝까지 안내한다. 사용자가 `/b3translate`을 실행하거나, repo URL을 붙여넣거나, "b3rys 번역 확장 설치/사용법"을 요청하면 사용.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
YouTube 자막 번역 룰 (파이프라인, cue 병합, rolling 번역, 캐시). youtube/ 디렉토리 수정 시 참조.
페이지 번역 룰 (text detection, injection, batch, cache). text-detector.ts, translator.ts, constants.ts 수정 시 참조.
상태 머신·보호 장치·Observer 룰. content.ts, observer.ts, background.ts 수정 시 참조.
선택 번역 팝업 룰 (단어/문장 모드, UI, 캐시). selection-popup.ts, llm-helpers.ts 수정 시 참조.
| name | b3translate |
| description | b3rys translate 크롬 확장을 GitHub에서 설치하고 API 키 설정·사용법까지 끝까지 안내한다. 사용자가 `/b3translate`을 실행하거나, repo URL을 붙여넣거나, "b3rys 번역 확장 설치/사용법"을 요청하면 사용. |
| allowed-tools | Bash, Read, WebFetch |
/b3translate)이 스킬 하나로 설치 → API 키 설정 → 사용법까지 손잡고 끝낸다. self-contained라 다른 문서 없이 이 파일만으로 진행한다. 빌드된 zip을 받아 로드하는 방식이라 Node.js가 없어도 된다 (없으면 소스 빌드 폴백).
chrome://extensions 조작은 사용자가 직접 하도록 단계별로 안내한다.b3rys/b3rys-translate)로 한정한다.owner/repo를 추출한다.b3rys/b3rys-translate**를 쓰되, 다른 repo인지 한 번 확인한다.owner/repo 추출. 기본값 b3rys/b3rys-translate.# macOS
ls "/Applications/Google Chrome.app" 2>/dev/null && echo "Chrome OK" || echo "Chrome 없음 (Chromium/Edge/Brave도 가능)"
Chromium 계열 브라우저가 하나도 없으면 설치 안내 후 중단.
gh CLI 우선, 없으면 curl 폴백.command -v gh >/dev/null && echo "gh 있음" || echo "gh 없음 → curl 사용"
설치 폴더는 고정 경로를 쓴다 (업데이트·재로드 편함). 기본 ~/b3rys-translate.
gh CLI가 있을 때 (최신 Release의 chrome zip):
DEST="$HOME/b3rys-translate"
mkdir -p "$DEST"
gh release download --repo <owner/repo> --pattern "*chrome*.zip" --dir "$DEST" --clobber
ZIP=$(ls "$DEST"/*chrome*.zip | head -1)
unzip -o "$ZIP" -d "$DEST/extension"
echo "설치 폴더: $DEST/extension"
gh가 없을 때 (curl로 latest asset):
DEST="$HOME/b3rys-translate"; mkdir -p "$DEST/extension"
URL=$(curl -sL "https://api.github.com/repos/<owner/repo>/releases/latest" \
| grep -o '"browser_download_url": *"[^"]*chrome[^"]*\.zip"' | head -1 | cut -d'"' -f4)
[ -n "$URL" ] && curl -L "$URL" -o "$DEST/ext.zip" && unzip -o "$DEST/ext.zip" -d "$DEST/extension"
echo "설치 폴더: $DEST/extension"
manifest.json이 있는 폴더가 최종 로드 대상이다. 압축 구조에 따라 위치가 다를 수 있으니 확인:find "$HOME/b3rys-translate/extension" -maxdepth 2 -name manifest.json
manifest.json이 있는 그 폴더 경로를 사용자에게 명확히 알려준다.
chrome://extensions는 특권 페이지라 자동화 불가. 번호로 또박또박 안내:
chrome://extensions 입력 후 이동사용자가 "떴어/로드됐어"라고 확인하면 다음으로.
먼저 어떤 엔진을 쓸지 물어본다. 무료로 시작하려면 Gemini 추천.
| 엔진 | 키 발급 | 가격 (1M 토큰, in/out) | 특징 |
|---|---|---|---|
| Gemini 3.1 Flash Lite (추천) | https://aistudio.google.com/apikey | $0.25 / $1.50 | 무료 할당량 있음 |
| GPT-4.1 Nano | https://platform.openai.com/api-keys | $0.10 / $0.40 | 최저가 · 비추론 |
| Claude Haiku 4.5 | https://console.anthropic.com/settings/keys | $1.00 / $5.00 | 품질 우선 |
안내 순서:
chrome.storage에만 저장되고 외부로 전송되지 않음을 알려준다. (번역 요청만 해당 엔진 API로 직접 전송)설치가 끝났으니 실제 기능을 시연하듯 안내한다.
① 웹페이지 번역
② 선택 번역
③ YouTube 이중자막
④ 비용 추적
번역이 안 나오면 체크: (a) API 키 저장됐는지, (b) 엔진 선택 맞는지, (c) 콘솔(F12)의 [b3rys] 에러, (d) 비용 한도 초과 여부.
chrome://extensions에서 b3rys translate 새로고침(↻).chrome://extensions에서 제거(Remove) → 설치 폴더 ~/b3rys-translate 삭제.Node.js(18+) 필요.
git clone https://github.com/<owner/repo>.git ~/b3rys-translate-src
cd ~/b3rys-translate-src
npm install
npm run build
# 로드 대상 폴더: dist/chrome-mv3 (여기에 manifest.json 있음)
이후 Phase 2~5는 동일하되, 로드할 폴더로 dist/chrome-mv3를 선택한다.
gh auth login 필요.unzip 없음 → macOS는 기본 내장, Linux는 apt install unzip 등 안내.