마켓플레이스·플러그인으로 설치하셨다면 업데이트를 권합니다.
스킬은 로드됐지만 내부에서 두 층이 조용히 빠지고 있었습니다.
무엇이 문제였나
플러그인 로더는 스킬을 플러그인 루트 skills/ 에서 기본 스캔합니다. 그런데 이 저장소는 .claude/skills/ 에 두고 plugin.json 의 skills 필드로 가리키고 있었습니다.
스펙에 예외가 있습니다 — marketplace 항목의 source 가 마켓플레이스 루트로 풀리면, 선언한 디렉터리가 기본 skills/ 스캔을 대체합니다. 우리 source 는 "./" 라 정확히 그 경우였고, 관례 위치는 비어 있었습니다.
| 환경 | 이전 | 지금 |
|---|---|---|
| CLI 심링크 설치 | 정상 | 정상 |
| CLI 마켓플레이스 설치 | 로드는 됐지만 정량 shim·진단 조용히 누락 | 정상 |
| 관례 위치만 스캔하는 로더 | 스킬 자체를 못 찾음 | 정상 |
두 번째가 특히 문제였습니다. route_hint 와 철칙 #4 게이트가 사라진 채로도 결과물은 정상적으로 나오기 때문에 품질이 떨어진 것을 알아채기 어렵습니다.
고친 것
- 스킬 3종을
.claude/skills/→skills/로 이동.plugin.json의skills필드 제거 — 루트skills/는 기본 스캔 대상이라 선언이 불필요하고, 선언하면 오히려 예외 조항에 걸립니다. ${SKILL_ROOT}유도를 깊이 비의존으로..claude-plugin/마커를 만날 때까지 거슬러 올라갑니다. 고정 횟수(cd ../../..)는 레이아웃이 바뀌면 조용히 엉뚱한 곳을 가리킵니다.- 끊어져 있던
codex/skills/.../references심링크 복구.
에이전트는 같은 이유로 이미 루트 agents/ 에 있었습니다(#26). 스킬만 남아 있었던 것입니다.
업데이트 방법
# 플러그인
/plugin update humanize-korean
# 스크립트 설치
./update.sh # 또는 ./install.sh.claude/skills/ 가 사라졌기 때문입니다. ./install.sh 를 다시 돌리면 복구됩니다.
검증
pytest236 passed — 레이아웃 회귀 4건 신설(구 위치 부활 금지 ·skills필드 재도입 금지 · 고정 깊이 유도 금지)claude plugin validate .✔- 격리 환경 설치 실측 ·
${SKILL_ROOT}유도 4종(저장소 직접 · 심링크 · 깊이 2 · 깊이 3) 검증
이번 주 경로 관련 수정 세 건(#84 · #88 · 이번)은 모두 실제로 설치해 쓴 분들이 찾아주셨습니다. 저장소 안에서만 테스트하면 원리적으로 보이지 않는 것들이었습니다. 감사합니다.