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

깨진 UI 디버깅 (Reticle)

콘솔은 조용하고 코드는 멀쩡해 보이는데 앱이 동작하지 않을 때, 실행 중인 페이지에서 증거를 모아 열어야 할 파일:줄을 찾아준다.

개발·코딩중급442109AI 점수 9/10마지막 업데이트: 2026. 9. 5.

무엇을 해주나

  • 실행 중인 웹 앱 내부에서 클릭 이벤트, 네트워크 요청, 상태 스토어, 로컬스토리지, 콘솔 로그를 하나의 인과 구간으로 함께 읽습니다.
  • 먼저 재현(reticle_act_and_wait)으로 판정(no/contradicted/unknown)을 뽑고, 결과 요약(net·consoleErrors·stateDiffs·storageDiffs·route)에서 이미 드러난 단서만 더 깊게 파고들도록 호출 낭비를 줄여줍니다.
  • "요청이 아예 안 나감 → 핸들러 미바인딩/캐시", "2xx인데 화면 그대로 → 성공 경로 버그", "클릭 무반응 → 요소가 가려짐/0×0/disabled" 같은 증상-원인-다음 조치 진단 표를 제공합니다.
  • 마지막에 reticle_inspect로 해당 요소의 컴포넌트와 source: {file, line}을 반환해, 가설이 아니라 열어야 할 위치로 조사를 끝냅니다.
  • 수정 후에는 눈으로 확인하는 대신 재현 시나리오를 판정 형태로 재실행하도록 강제합니다.

이런 분께 추천

  • React/Vue 등 SPA를 만들며 "내 로컬에선 되는데" 류의 재현 어려운 버그를 자주 만나는 프론트엔드 개발자
  • 스크린샷으로는 보이지 않는 UI-상태 불일치, 토큰 미저장, 가상 리스트 미마운트 문제를 자주 겪는 팀
  • QA 리포트만 보고 원인 파일을 빠르게 특정해야 하는 개발자

활용 예시

  1. "저장 버튼을 눌러도 아무 일이 없어요" → 클릭 재현 후 네트워크 요청이 0건임을 확인하고, inspect로 버튼이 투명 오버레이에 가려져 있음을 찾아 해당 컴포넌트 파일:줄 제시.
  2. "목록이 갱신되지 않아요" → 요청은 200, DOM도 정상인데 stateDiffs가 비어 있어 스토어가 응답을 반영하지 않은 성공 경로 버그로 특정.
  3. "로그인한 것처럼 보이는데 새로고침하면 풀려요" → reticle_storage로 토큰이 저장되지 않았음을 증명하고 저장 로직 위치를 지목.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

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

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/reticlehq/reticle/HEAD/skills/debug-broken-ui/SKILL.md

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

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

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

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

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

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

직접 명령으로 설치하기

git clone https://github.com/reticlehq/reticle.git && mkdir -p ~/.claude/skills && cp -r reticle/skills/debug-broken-ui ~/.claude/skills/

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

  1. 터미널에서 저장소를 클론합니다: git clone https://github.com/reticlehq/reticle.git
  2. 스킬 폴더를 Claude Code 스킬 경로로 복사합니다: mkdir -p ~/.claude/skills && cp -r reticle/skills/debug-broken-ui ~/.claude/skills/
  3. 디버깅할 웹 프로젝트 루트로 이동해 Reticle을 설치합니다: RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init
  4. 설치가 끝나면 저장소의 install-and-verify 스킬 안내에 따라 MCP 연결과 페이지 계측(스토어 등록 포함)을 확인합니다.
  5. Claude Code를 재시작하고 개발 서버를 띄운 뒤, "버튼이 눌리지 않는데 원인 파일을 찾아줘"처럼 요청하면 스킬이 발동합니다.
  6. 상태 진단이 필요하면 summary.stateUnwatched가 true가 아니도록 스토어를 등록해 두세요.
GitHub에서 원본 보기라이선스: NOASSERTION