클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
← 목록으로

코드 스타일: 존재·재사용·미러링·대칭

기존 코드베이스에 새 코드를 추가할 때 불필요한 코드를 걷어내고 주변 스타일과 완전히 일치시키도록 Claude를 규율하는 코딩 원칙 스킬.

개발·코딩중급★ 403⑂ 31AI 점수 7/10마지막 업데이트: 2026. 9. 24.

무엇을 해주나

  • 7단계 우선순위 규칙으로 Claude의 코드 작성 습관을 교정합니다. 앞선 규칙이 뒤 규칙보다 항상 우선합니다.
  • ① 존재 증명: 구현체가 하나뿐인 추상화, 호출자가 하나인 설정 지점, 도달 불가능한 분기, 미래를 대비한 스캐폴딩 등 요청에 필요 없는 코드를 애초에 만들지 않습니다. 단, 신뢰 경계의 입력 검증·에러 처리·보안·접근성은 예외로 살립니다.
  • ② ③ 재사용: 새 헬퍼를 만들기 전에 기존 메서드를 재사용·일반화할 수 있는지 먼저 확인하고, 가장 유사한 기존 기능의 구조(메서드 분해, 제어 흐름, 가드 절)를 복제합니다.
  • ④ 미러링: 중괄호 스타일, 주석 스타일, 네이밍, 빈 줄 간격, 코드 밀도까지 주변 코드를 먼저 읽고 그대로 맞춥니다.
  • ⑤ 대칭성: fooA() 옆에 fooB()를 추가한다면 이름·인자 순서·구조를 맞추고, 식별자뿐 아니라 라우트 경로, 설정 키, 이벤트명, 환경변수, CLI 플래그, 파일명 규칙까지 비대칭을 해소합니다.
  • ⑥ 논리적 배치 / ⑦ 주석 최소화: 새 메서드·switch case·필드를 맨 끝에 붙이지 않고 기존 그룹핑·업무 흐름 순서에 맞춰 넣으며, 주석은 코드가 표현할 수 없는 제약(숨은 불변식, 우회책)에만 남깁니다.

이런 분께 추천

  • 레거시·대형 코드베이스에서 AI에게 기능 추가를 맡기는데 스타일이 튀어 리뷰 코멘트가 길어지는 개발자
  • AI가 과도한 추상화·불필요한 옵션·장황한 주석을 만들어내는 것을 막고 싶은 분
  • 팀 코드 리뷰 규칙을 AI에게도 동일하게 적용하고 싶은 테크리드

활용 예시

  1. 기존 POST /users 핸들러 옆에 POST /teams를 추가할 때, 기존 핸들러의 가드 절·에러 처리·네이밍을 그대로 복제하도록 유도.
  2. "설정으로 켜고 끌 수 있게 해줘" 같은 요청에서 호출자가 하나뿐이면 설정 지점을 만들지 않고 직접 구현하도록 축소.
  3. exportCsv()에 맞춰 exportXlsx()를 만들 때 함수명·파라미터 순서·파일명 규칙·CLI 플래그까지 대칭으로 정리(공개 계약이 아니면 기존 이름도 함께 리네임).

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/tobihagemann/turbo/HEAD/claude/skills/code-style/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ 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자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/tobihagemann/turbo.git
  3. 스킬 폴더를 준비합니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r turbo/claude/skills/code-style ~/.claude/skills/
  5. ~/.claude/skills/code-style/SKILL.md 파일이 있는지 확인합니다.
  6. Claude Code를 다시 시작한 뒤, 기존 프로젝트에서 "이 기능 추가해줘"처럼 코드 변경을 요청하면 스킬이 자동으로 적용됩니다.
  7. 특정 프로젝트에만 적용하려면 ~/.claude/skills 대신 프로젝트 루트의 .claude/skills/에 복사하세요.