diff --git a/.claude/skills/init-project/SKILL.md b/.claude/skills/init-project/SKILL.md
index ec3da04..a7bd3cc 100644
--- a/.claude/skills/init-project/SKILL.md
+++ b/.claude/skills/init-project/SKILL.md
@@ -165,6 +165,13 @@ git config core.hooksPath .githooks
 chmod +x .githooks/*
 ```
 
+**pre-commit 훅 검증**: `.githooks/pre-commit`을 실행하여 빌드 검증이 정상 동작하는지 확인.
+에러 발생 시 (예: 모노레포가 아닌 특수 구조, 빌드 명령 불일치 등):
+1. 프로젝트에 맞게 `.githooks/pre-commit`을 커스텀 수정
+2. `.claude/workflow-version.json`에 `"custom_pre_commit": true` 추가
+3. 이후 `/sync-team-workflow` 실행 시 pre-commit은 덮어쓰지 않고 보존됨
+   (`commit-msg`, `post-checkout`은 항상 팀 표준으로 동기화)
+
 ### 6. 프로젝트 타입별 추가 설정
 
 #### java-maven