코드 스타일: 존재·재사용·미러링·대칭
기존 코드베이스에 새 코드를 추가할 때 불필요한 코드를 걷어내고 주변 스타일과 완전히 일치시키도록 Claude를 규율하는 코딩 원칙 스킬.
개발·코딩중급★ 403⑂ 31AI 점수 7/10마지막 업데이트: 2026. 9. 24.
무엇을 해주나
- 7단계 우선순위 규칙으로 Claude의 코드 작성 습관을 교정합니다. 앞선 규칙이 뒤 규칙보다 항상 우선합니다.
- ① 존재 증명: 구현체가 하나뿐인 추상화, 호출자가 하나인 설정 지점, 도달 불가능한 분기, 미래를 대비한 스캐폴딩 등 요청에 필요 없는 코드를 애초에 만들지 않습니다. 단, 신뢰 경계의 입력 검증·에러 처리·보안·접근성은 예외로 살립니다.
- ② ③ 재사용: 새 헬퍼를 만들기 전에 기존 메서드를 재사용·일반화할 수 있는지 먼저 확인하고, 가장 유사한 기존 기능의 구조(메서드 분해, 제어 흐름, 가드 절)를 복제합니다.
- ④ 미러링: 중괄호 스타일, 주석 스타일, 네이밍, 빈 줄 간격, 코드 밀도까지 주변 코드를 먼저 읽고 그대로 맞춥니다.
- ⑤ 대칭성:
fooA()옆에fooB()를 추가한다면 이름·인자 순서·구조를 맞추고, 식별자뿐 아니라 라우트 경로, 설정 키, 이벤트명, 환경변수, CLI 플래그, 파일명 규칙까지 비대칭을 해소합니다. - ⑥ 논리적 배치 / ⑦ 주석 최소화: 새 메서드·switch case·필드를 맨 끝에 붙이지 않고 기존 그룹핑·업무 흐름 순서에 맞춰 넣으며, 주석은 코드가 표현할 수 없는 제약(숨은 불변식, 우회책)에만 남깁니다.
이런 분께 추천
- 레거시·대형 코드베이스에서 AI에게 기능 추가를 맡기는데 스타일이 튀어 리뷰 코멘트가 길어지는 개발자
- AI가 과도한 추상화·불필요한 옵션·장황한 주석을 만들어내는 것을 막고 싶은 분
- 팀 코드 리뷰 규칙을 AI에게도 동일하게 적용하고 싶은 테크리드
활용 예시
- 기존
POST /users핸들러 옆에POST /teams를 추가할 때, 기존 핸들러의 가드 절·에러 처리·네이밍을 그대로 복제하도록 유도. - "설정으로 켜고 끌 수 있게 해줘" 같은 요청에서 호출자가 하나뿐이면 설정 지점을 만들지 않고 직접 구현하도록 축소.
exportCsv()에 맞춰exportXlsx()를 만들 때 함수명·파라미터 순서·파일명 규칙·CLI 플래그까지 대칭으로 정리(공개 계약이 아니면 기존 이름도 함께 리네임).
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/tobihagemann/turbo/HEAD/claude/skills/code-style/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 tobihagemann/turbo 의 claude/skills/code-style 폴더를 내 ~/.claude/skills/code-style/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/tobihagemann/turbo.git && mkdir -p ~/.claude/skills && cp -r turbo/claude/skills/code-style ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/tobihagemann/turbo.git - 스킬 폴더를 준비합니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r turbo/claude/skills/code-style ~/.claude/skills/ ~/.claude/skills/code-style/SKILL.md파일이 있는지 확인합니다.- Claude Code를 다시 시작한 뒤, 기존 프로젝트에서 "이 기능 추가해줘"처럼 코드 변경을 요청하면 스킬이 자동으로 적용됩니다.
- 특정 프로젝트에만 적용하려면
~/.claude/skills대신 프로젝트 루트의.claude/skills/에 복사하세요.
GitHub에서 원본 보기 ↗라이선스: MIT