클로드스킬마트스킬 둘러보기스킬이 뭐예요?
목록으로

코드 헬스 점검

데드 코드, 기술 부채, 오래된 의존성, 코드 스멜을 한 번에 스캔해 날짜별 리포트로 정리해 주는 스킬입니다.

보안·리뷰입문3,276452AI 점수 6/10마지막 업데이트: 2026. 8. 7.

무엇을 해주나

/code-health 한 줄로 코드베이스 전반의 건강 상태를 점검합니다. 내부적으로 Centinela(QA) 에이전트에게 작업을 위임해 다음을 수행합니다.

  • 데드 코드 탐지: 사용하지 않는 import·변수·함수, 주석 처리된 블록, 도달 불가 코드
  • 의존성 점검: 오래된 패키지와 알려진 취약점 확인
  • 코드 스멜 탐지: 지나치게 긴 함수, 깊은 중첩, 중복 코드
  • TODO/FIXME 감사: 이슈 번호 연결 여부 확인
  • 결과를 docs/reviews/code-health-{날짜}.md 파일로 저장하고 Critical > Warning > Suggestion 순으로 우선순위화
  • 이전 스캔 결과와 비교해 반복되는 문제를 추적하고, 동적 import/플러그인으로 인한 오탐을 걸러냄

이런 분께 추천

  • 릴리스 전에 남은 부채와 죽은 코드를 정리하고 싶은 개발자
  • 대규모 리팩터링 후 정리 상태를 검증해야 하는 팀
  • 새로 합류한 프로젝트의 코드 품질 수준을 빠르게 파악하고 싶은 신규 팀원
  • 주기적인 코드베이스 위생 점검 루틴을 만들고 싶은 테크 리드

활용 예시

  1. 릴리스 직전 점검/code-health를 실행해 취약한 의존성과 미해결 TODO를 Critical 항목으로 뽑아내고, 리포트를 릴리스 체크리스트에 첨부합니다.
  2. 리팩터링 후 정리 — 대규모 구조 변경 뒤 남은 미사용 함수와 주석 처리된 옛 코드를 목록으로 받아 한 번에 삭제합니다.
  3. 월간 부채 트래킹 — 매달 실행해 이전 리포트와 비교하면서 반복적으로 지적되는 코드 스멜을 팀 백로그로 등록합니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 davepoon/buildwithclaude 의 plugins/agent-triforce/skills/code-health 폴더를 내 ~/.claude/skills/code-health/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/davepoon/buildwithclaude.git && mkdir -p ~/.claude/skills && cp -r buildwithclaude/plugins/agent-triforce/skills/code-health ~/.claude/skills/

제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/davepoon/buildwithclaude.git
  3. 스킬 폴더를 준비합니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r buildwithclaude/plugins/agent-triforce/skills/code-health ~/.claude/skills/
  5. 이 스킬은 Centinela(QA) 에이전트에 의존하므로, buildwithclaude/plugins/agent-triforce 안의 에이전트 정의도 함께 ~/.claude/의 해당 위치(예: ~/.claude/agents/)로 복사하는 것을 권장합니다.
  6. Claude Code를 재시작하고 프로젝트 폴더에서 /code-health를 입력해 동작을 확인합니다.
  7. 실행이 끝나면 docs/reviews/ 폴더에 생성된 리포트 파일을 열어봅니다.