secret-leak-check
커밋 전 비밀 값과 개인정보 점검
커밋하거나 공개하기 전에 API 키, 토큰, 비밀번호, 개인 메일 주소가 섞이지 않았는지 찾아요.
2026년 11월 17일 추가한국어로 씀
까는 법
터미널에 붙여 넣으면 ~/.claude/skills/secret-leak-check/SKILL.md에 파일 하나가 받아져요. Claude Code를 다시 켜면 스킬 목록에 나타나요.
mkdir -p ~/.claude/skills/secret-leak-check && curl -fsSL https://beautifulsoup.dev/skill-files/secret-leak-check/SKILL.md -o ~/.claude/skills/secret-leak-check/SKILL.md
명령을 쓰기 어렵다면 아래 SKILL.md를 복사하거나 내려받아, 같은 위치에 secret-leak-check 폴더를 만들고 그 안에 넣어도 돼요. 한 프로젝트에서만 쓰려면 프로젝트 안의 .claude/skills/에 넣어요.
에이전트가 이 스킬을 꺼내는 때
git 커밋, 푸시, 공개 저장소 올리기, 웹사이트 배포 전에 쓴다. 사용자가 "커밋해 줘", "푸시해 줘", "공개해도 돼?"라고 할 때 이 점검을 먼저 한다.
SKILL.md 머리말의 설명이에요. 에이전트는 이 설명을 보고 언제 이 스킬을 쓸지 정해요. 이름을 직접 불러 써도 돼요.
SKILL.md
찾을 것
- API 키와 토큰:
sk-,ghp_,AKIA,xox,AIza로 시작하는 문자열,Bearer뒤의 긴 문자열 - 비밀번호, 연결 문자열(
postgres://사용자:비밀번호@), 개인 키(-----BEGIN ... PRIVATE KEY-----) .env,*.pem,*.key, 인증서 파일, 브라우저 프로필 폴더- 개인정보: 개인 메일 주소, 전화번호, 주소, 주민등록번호 꼴
- 내부 주소, 서버 IP, 회사 내부 문서
순서
- 이번에 올라갈 변경 목록을 본다(
git status,git diff --cached). - 위 꼴을 검색한다. 찾은 값은 화면에 그대로 보여 주지 말고 앞 몇 글자만 남기고 가린다.
.gitignore에 넣어야 할 파일이 있으면 제안한다.- 이미 커밋된 기록에 들어갔다면 지우는 것만으로는 안전하지 않다고 알린다. 그 값을 새로 발급하고(교체), 기록 정리는 따로 계획한다.
지킬 것
- 찾은 비밀 값을 대화, 로그, 커밋 메시지에 옮겨 적지 않는다.
- 공개해도 되는 값(공개 키, 공개용 확인 파일)은 그렇다고 구분해 알린다.
돌려줄 것
파일, 줄, 종류, 가린 값, 할 일(지우기, 무시 목록에 넣기, 값 교체)을 표로.
개발의 다른 스킬
이런 스킬도 있으면 좋겠다 싶으면 알려 주세요