@litfamily/litopencode 1.0.5 → 1.0.6

package/CHANGELOG.md

@@ -5,6 +5,12 @@ are tracked separately from this product history.
 
 ## Unreleased
 
+## 1.0.6
+
+- Ask about competing visual directions the brief leaves open instead of silently applying an announced default.
+- Show the link target, its resolved directory, and any same-named shadowing skill for the shared native skills root in install and doctor output.
+- Show the robot cover as a visible image under the motion hero in both READMEs instead of behind a hidden link, and remove the duplicate copy that repeated near the LITFAMILY illustration.
+
 ## 1.0.5
 
 - Add README Studio decoration patterns and the bounded multi-round design interview.

package/README-Ko-KR.md

@@ -1,7 +1,7 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover-motion.webp" width="100%" alt="LITOPENCODE 워드마크 위 궤도를 라임 신호가 지나가는 표지입니다. 움직임 줄이기를 선호하면 이 표지의 정지 프레임을 표시합니다." /></picture></p>
-<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover.webp">정지 표지 보기</a></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/cover-motion.webp" width="100%" alt="LITOPENCODE 워드마크 위 궤도를 라임 신호가 지나가는 표지입니다. 움직임 줄이기를 선호하면 이 표지의 정지 프레임을 표시합니다." /></picture></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/cover.webp" width="100%" alt="LITFAMILY와 KEEP THE WORK LIT. 문구 아래에 모인 다섯 로봇 크루." /></p>
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크" /></p>
 
 <details>
 <summary>ASCII 로고 복사</summary>
@@ -33,21 +33,21 @@
 
 # LitOpenCode
 
-[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/README-Ko-KR.md)
+[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/README-Ko-KR.md)
 
 > **불씨를 건네받았다.**<br>
 > **이제, 당신의 작업에 옮길 차례다.**
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/litopencode-wordmark.svg" width="480" alt="LITOPENCODE 디스플레이 타입" /></p>
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/litopencode-clay-icon.png" width="160" alt="LitOpenCode 클레이 마크" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/litopencode-wordmark.svg" width="480" alt="LITOPENCODE 디스플레이 타입" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/litopencode-clay-icon.png" width="160" alt="LitOpenCode 클레이 마크" /></p>
 
 <p align="center">
-<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/badge-version.svg" alt="1.0.5" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/badge-version.svg" alt="1.0.6" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
 </p>
 
 <p align="center">
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 문서</a> &nbsp; <a href="#설치">설치</a> &nbsp; <a href="#ignition-motion"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 문서</a> &nbsp; <a href="#설치">설치</a> &nbsp; <a href="#ignition-motion"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
 </p>
 
 ## LitOpenCode란
@@ -79,9 +79,9 @@ npm exec --package @litfamily/litopencode@latest -- litopencode install --yes
 설치 도구는 OpenCode 설정 루트에 플러그인과 native 명령·스킬 파일을 등록합니다.
 route 파일은 `~/.config/opencode/litopencode.json`이며 `XDG_CONFIG_HOME`을 지정하면
 설정 루트가 달라집니다. 기존 custom route는 사용자 소유로 유지됩니다.
-custom root, 모델 선택, 터미널 정책, 무인 설치는 [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference-Ko-KR.md#설치)를 참고하세요.
+custom root, 모델 선택, 터미널 정책, 무인 설치는 [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md#설치)를 참고하세요.
 
-이 checkout의 패키지는 `@litfamily/litopencode@1.0.5`입니다. registry의 `@latest`는 다를 수 있으므로
+이 checkout의 패키지는 `@litfamily/litopencode@1.0.6`입니다. registry의 `@latest`는 다를 수 있으므로
 정확한 버전이 필요하면 `npm view @litfamily/litopencode version`으로 확인하세요.
 
 ## 처음 사용하기
@@ -136,9 +136,9 @@ primitive가 없으므로 이 프로젝트별 로컬 기록으로 작업을 재
 
 Lit 경로가 활성화되면 답변이 굵은 점화 문구로 시작합니다. 플러그인은 글리프를 지원하는 환경에서 다섯 줄의 micro 로고와 마지막 `🔥 LIT IGNITED · <discipline> 🔥` 문구를 6초 동안 경고 토스트로 표시하도록 요청합니다. 글리프를 지원하지 않으면 문구만 표시합니다.
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/litopencode-ignition-1600.webp" width="48%" alt="LitOpenCode 점화 장치" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/litopencode-continuity-1600.webp" width="48%" alt="LitOpenCode 연속 장치" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/litopencode-ignition-1600.webp" width="48%" alt="LitOpenCode 점화 장치" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/litopencode-continuity-1600.webp" width="48%" alt="LitOpenCode 연속 장치" /></p>
 
-<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/poster.png" width="720" alt="Ignition 모션 포스터" /></a></p>
+<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/poster.png" width="720" alt="Ignition 모션 포스터" /></a></p>
 
 포스터를 선택하면 선택형 영상을 엽니다. README에서 자동 재생하지 않습니다.
 
@@ -210,9 +210,9 @@ canonical 경로를 사용합니다. 번호가 붙은 license·provenance 파일
 | `/lit-korean` | 의미를 유지하며 한국어 문장 다듬기 |
 | `/lit-scientific-visualization` | 패키지에 포함된 과학 시각화 워크플로 |
 
-Autoresearch, Autoconference, Wikify, UI/UX는 [전체 경로 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference-Ko-KR.md#주요-명령)에,
-두 가지 rule 처리 경로는 [규칙 엔진 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md#safety-and-updates)에서 확인하세요.
-이전 스킬 이름은 한 릴리스 동안 별칭으로 연결됩니다. [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/migration.md#skill-id-renames)를 확인하세요.
+Autoresearch, Autoconference, Wikify, UI/UX는 [전체 경로 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md#주요-명령)에,
+두 가지 rule 처리 경로는 [규칙 엔진 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#safety-and-updates)에서 확인하세요.
+이전 스킬 이름은 한 릴리스 동안 별칭으로 연결됩니다. [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/migration.md#skill-id-renames)를 확인하세요.
 
 ## 안전과 업데이트
 
@@ -223,7 +223,7 @@ Autoresearch, Autoconference, Wikify, UI/UX는 [전체 경로 안내](https://cd
   `--no-auto-update` 또는 `LITOPENCODE_NO_AUTO_UPDATE=1`로 자동 업데이트를 끌 수 있습니다.
 - 스킬 학습 결과는 명시적인 apply 명령이 있어야 반영됩니다. 학습의 review·변경·rollback·curator는
   POSIX를 지원하며 Windows에서는 해당 경계를 차단합니다. 설치, doctor, 수동 조회에는
-  이 제한이 적용되지 않습니다. [학습 루프 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md#skill-learning-loop).
+  이 제한이 적용되지 않습니다. [학습 루프 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#skill-learning-loop).
 
 ## 문제 해결
 
@@ -235,7 +235,13 @@ Autoresearch, Autoconference, Wikify, UI/UX는 [전체 경로 안내](https://cd
 npm exec --package @litfamily/litopencode@latest -- litopencode doctor
 ```
 
-[설치와 모델 설정 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference-Ko-KR.md#설치)를 참고하세요.
+[설치와 모델 설정 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md#설치)를 참고하세요.
+
+`install`과 `doctor`는 `<root>/skills`가 심볼릭 링크일 때 그 사실과 git 저장소 경고를
+보고하며, `~/.agents/skills`, `~/.claude/skills`, 프로젝트 스킬 디렉토리에 같은 이름의
+스킬이 있으면 함께 알려줍니다. 자세한 내용은
+[심볼릭 링크된 native 스킬 루트와 다른 위치의 같은 이름 스킬](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md#심볼릭-링크된-native-스킬-루트와-다른-위치의-같은-이름-스킬)을
+참고하세요.
 
 ## 제거
 
@@ -250,7 +256,7 @@ npm uninstall -g @litfamily/litopencode
 설치된 명령·스킬 파일은 소유 관계를 확인한 뒤 설치 도구가 관리하는 복사본만 제거하세요.
 사용자가 만든 파일과 수정 내용은 보존합니다. route가 필요하면 `litopencode.json`을,
 작업을 재개할 계획이라면 프로젝트의 `.litopencode/` 기록을 남기세요. 제거 후 OpenCode를
-재시작합니다. [제거 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference-Ko-KR.md#제거).
+재시작합니다. [제거 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md#제거).
 
 ## 라이선스
 
@@ -260,27 +266,25 @@ MIT
 
 ### 문서
 
-- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference-Ko-KR.md): 모델, 권한, host 연결, 명령, 검증 방법
-- [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md): 전체 스킬 목록, 학습 루프, 규칙 엔진 포함
-- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/migration.md)
-- [터미널 마크와 활성화 확인 문구](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/lit-mark.md)
-- [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/CHANGELOG.md)
+- [워크플로 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md): 모델, 권한, host 연결, 명령, 검증 방법
+- [English reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md): 전체 스킬 목록, 학습 루프, 규칙 엔진 포함
+- [마이그레이션 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/migration.md)
+- [터미널 마크와 활성화 확인 문구](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/lit-mark.md)
+- [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/CHANGELOG.md)
 - 출시 담당자 체크리스트 (저장소 전용)
 
-- [기여 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/CONTRIBUTING.md) · [지원](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/SUPPORT.md) · [보안 제보](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/SECURITY.md)
-- [행동 규범](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/CODE_OF_CONDUCT.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/privacy.md)
+- [기여 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/CONTRIBUTING.md) · [지원](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/SUPPORT.md) · [보안 제보](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/SECURITY.md)
+- [행동 규범](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/CODE_OF_CONDUCT.md) · [개인정보와 네트워크 동작](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/privacy.md)
 
 ### LITFAMILY
 
-![LitClaude, LitHermes, LitCodex, LitOpenCode, LitGrok을 표현한 다섯 중장갑 머신](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/litfamily-machines.png)
+![LitClaude, LitHermes, LitCodex, LitOpenCode, LitGrok을 표현한 다섯 중장갑 머신](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/litfamily-machines.png)
 
 LitClaude · LitHermes · LitCodex · LitOpenCode · LitGrok.
 다섯 중장갑 머신으로 다섯 제품을 표현한 일러스트입니다. 각 제품은 자신이 지원하는 도구에서 독립적으로 동작합니다.
 
-![LITFAMILY와 KEEP THE WORK LIT. 문구 아래에 모인 다섯 로봇 크루.](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover.webp)
-
 ### Ignition motion
 
-[![Ignition 모션 그래픽 포스터](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/poster.png)](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-film.mp4)
+[![Ignition 모션 그래픽 포스터](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/poster.png)](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-film.mp4)
 
-[10초 영상 보기](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-film.mp4) · [애니메이션 GIF](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-readme.gif) · [Lucide 아이콘 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/Lucide-LICENSE.txt) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/JetBrainsMono-OFL.txt)
+[10초 영상 보기](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-film.mp4) · [애니메이션 GIF](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-readme.gif) · [Lucide 아이콘 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/Lucide-LICENSE.txt) · [ASCII 글꼴 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/JetBrainsMono-OFL.txt)

package/README.md

@@ -1,7 +1,7 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover-motion.webp" width="100%" alt="LitOpenCode cover art. A lime signal traces orbital paths above the OPENCODE wordmark. Reduced-motion users see a still frame from this cover." /></picture></p>
-<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover.webp">View the static cover</a></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/cover-motion.webp" width="100%" alt="LitOpenCode cover art. A lime signal traces orbital paths above the OPENCODE wordmark. Reduced-motion users see a still frame from this cover." /></picture></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/cover.webp" width="100%" alt="Five robots beneath the LITFAMILY and KEEP THE WORK LIT. lettering." /></p>
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
 
 <details>
 <summary>Copy ASCII logo</summary>
@@ -33,20 +33,20 @@
 
 # LitOpenCode
 
-[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/README-Ko-KR.md)
+[English](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/README.md) · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/README-Ko-KR.md)
 
 **Keep the work lit.**
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/litopencode-wordmark.svg" width="480" alt="LITOPENCODE display type" /></p>
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/litopencode-clay-icon.png" width="160" alt="LitOpenCode clay mark" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/litopencode-wordmark.svg" width="480" alt="LITOPENCODE display type" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/litopencode-clay-icon.png" width="160" alt="LitOpenCode clay mark" /></p>
 
 <p align="center">
-<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/badge-version.svg" alt="1.0.5" /></a>
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/badge-version.svg" alt="1.0.6" /></a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 
 <p align="center">
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install">Install</a> &nbsp; <a href="#ignition-motion"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install">Install</a> &nbsp; <a href="#ignition-motion"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
 </p>
 
 ## What is LitOpenCode
@@ -76,10 +76,10 @@ npm exec --package @litfamily/litopencode@latest -- litopencode install --yes
 Installation registers the plugin and native command/skill files under your OpenCode
 config root. Routes live in `~/.config/opencode/litopencode.json`; `XDG_CONFIG_HOME`
 changes that root. Existing custom routes remain user-owned. See the
-[installation and model reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md#install) for custom roots,
+[installation and model reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#install) for custom roots,
 provider choices, terminal policy, and unattended setup.
 
-This checkout is `@litfamily/litopencode@1.0.5`. Registry `@latest` can differ; inspect it with
+This checkout is `@litfamily/litopencode@1.0.6`. Registry `@latest` can differ; inspect it with
 `npm view @litfamily/litopencode version` when an exact version matters.
 
 ## First use
@@ -134,9 +134,9 @@ Use `lit` or `/lit` to start a bounded task; `handoff` or `/lit-handoff` carries
 
 When a Lit route activates, the reply starts with a bold ignition line. The plugin requests a six-second warning toast with five micro-logo rows and a final `🔥 LIT IGNITED · <discipline> 🔥` line when the environment supports mark glyphs; otherwise, it shows only that line.
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/litopencode-ignition-1600.webp" width="48%" alt="LitOpenCode ignition apparatus" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/litopencode-continuity-1600.webp" width="48%" alt="LitOpenCode continuity apparatus" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/litopencode-ignition-1600.webp" width="48%" alt="LitOpenCode ignition apparatus" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/litopencode-continuity-1600.webp" width="48%" alt="LitOpenCode continuity apparatus" /></p>
 
-<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/poster.png" width="720" alt="Ignition motion poster" /></a></p>
+<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/poster.png" width="720" alt="Ignition motion poster" /></a></p>
 
 The poster opens the optional film; this README keeps motion opt-in.
 
@@ -206,9 +206,9 @@ remain source-attribution records.
 | `/lit-korean` | Improve Korean prose without changing its meaning. |
 | `/lit-scientific-visualization` | Use the packaged scientific-visualization workflow. |
 
-The [full route and skill reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md#core-commands) covers
+The [full route and skill reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#core-commands) covers
 Autoresearch, Autoconference, Wikify, UI/UX, and the two-lane repository rules engine.
-[Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/migration.md#skill-id-renames) explain the one-release skill aliases.
+[Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/migration.md#skill-id-renames) explain the one-release skill aliases.
 
 ## Safety and updates
 
@@ -219,7 +219,7 @@ Autoresearch, Autoconference, Wikify, UI/UX, and the two-lane repository rules e
   check. Use `--no-auto-update` or `LITOPENCODE_NO_AUTO_UPDATE=1` to disable automatic updates.
 - Skill learning requires an explicit apply command. Its review, mutation, rollback, and
   curator boundaries support POSIX; on Windows those boundaries fail closed. Install,
-  doctor, and passive surfaces remain available. [Learning-loop details](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md#skill-learning-loop).
+  doctor, and passive surfaces remain available. [Learning-loop details](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#skill-learning-loop).
 
 ## Troubleshooting
 
@@ -231,7 +231,12 @@ Inspect package and configuration health with:
 npm exec --package @litfamily/litopencode@latest -- litopencode doctor
 ```
 
-See the [installation and model reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md#install).
+See the [installation and model reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#install).
+
+Install and `doctor` report when `<root>/skills` is a symlink (and its git-repository
+warning) and any same-named skill shadowing it in `~/.agents/skills`, `~/.claude/skills`,
+or a project skills directory. See
+[symlinked native skills root and shadow copies](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#symlinked-native-skills-root-and-shadow-copies).
 
 ## Uninstall
 
@@ -247,7 +252,7 @@ npm uninstall -g @litfamily/litopencode
 Review installed command/skill files before removing installer-owned copies; preserve
 user-created files and edits. Keep `litopencode.json` if you still need its routes, and
 keep project `.litopencode/` ledgers if you plan to resume. Restart OpenCode after removal.
-See the [removal reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md#remove).
+See the [removal reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md#remove).
 
 ## License
 
@@ -257,27 +262,25 @@ MIT
 
 ### Documentation
 
-- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference.md): models, permissions, host hooks, all skills, learning loop, and reproducible verification.
-- [한국어 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/reference-Ko-KR.md)
-- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/migration.md)
-- [Terminal mark and activation probes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/lit-mark.md)
-- [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/CHANGELOG.md)
+- [Workflow reference](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference.md): models, permissions, host hooks, all skills, learning loop, and reproducible verification.
+- [한국어 상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/reference-Ko-KR.md)
+- [Migration notes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/migration.md)
+- [Terminal mark and activation probes](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/lit-mark.md)
+- [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/CHANGELOG.md)
 - Maintainer release checklist (repository only)
 
-- [Contributing](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/CONTRIBUTING.md) · [Support](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/SUPPORT.md) · [Security](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/SECURITY.md)
-- [Code of conduct](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/CODE_OF_CONDUCT.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/privacy.md)
+- [Contributing](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/CONTRIBUTING.md) · [Support](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/SUPPORT.md) · [Security](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/SECURITY.md)
+- [Code of conduct](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/CODE_OF_CONDUCT.md) · [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/privacy.md)
 
 ### LITFAMILY
 
-![Five armored machines representing LitClaude, LitHermes, LitCodex, LitOpenCode and LitGrok](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/litfamily-machines.png)
+![Five armored machines representing LitClaude, LitHermes, LitCodex, LitOpenCode and LitGrok](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/litfamily-machines.png)
 
 LitClaude · LitHermes · LitCodex · LitOpenCode · LitGrok.
 Five armored machines for five independent products, each working in its own host.
 
-![Five robots beneath the LITFAMILY and KEEP THE WORK LIT. lettering.](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/cover.webp)
-
 ### Ignition motion
 
-[![Ignition motion graphic poster](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/poster.png)](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-film.mp4)
+[![Ignition motion graphic poster](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/poster.png)](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-film.mp4)
 
-[Watch the 10-second film](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-film.mp4) · [Animated GIF](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/ignition-readme.gif) · [Lucide icon license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/Lucide-LICENSE.txt) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.5/docs/assets/readme/JetBrainsMono-OFL.txt)
+[Watch the 10-second film](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-film.mp4) · [Animated GIF](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/ignition-readme.gif) · [Lucide icon license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/Lucide-LICENSE.txt) · [ASCII font license](https://cdn.jsdelivr.net/npm/@litfamily/litopencode@1.0.6/docs/assets/readme/JetBrainsMono-OFL.txt)

package/dist/cli/install-report.js

@@ -127,6 +127,21 @@ function actionLines(report) {
 function progressLine(label) {
     return "  " + tint("[ok]", green) + " " + label;
 }
+// A symlinked <root>/skills is intentional and install still succeeds; these lines only make the
+// resolved destination visible, and warn when that destination is a git work tree a managed install
+// would write dozens of skill directories into (see the ~/skills incident this guards against).
+function nativeSkillsLinkLines(report) {
+    const link = report.nativeSkills.link;
+    if (link === undefined)
+        return [];
+    const lines = [line("Native skills link", link.path + " -> " + link.target + " (linked directory)")];
+    if (link.gitRepositoryRoot !== undefined) {
+        lines.push(line("Warning", "linked native skills target is inside git repository " +
+            link.gitRepositoryRoot +
+            "; managed skills will appear inside that repository"));
+    }
+    return lines;
+}
 function headerLine(label, code) {
     return "| " + tint(label.padEnd(58, " "), code) + " |";
 }
@@ -168,6 +183,7 @@ export function renderInstallReport(report) {
         line("LitOpenCode config", report.litopencodeConfig.path),
         line("Command aliases", report.commandAliases.write.length + " managed / " + report.commandAliases.preserve.length + " preserved"),
         line("Native skills", report.nativeSkills.write.length + " managed / " + report.nativeSkills.preserve.length + " preserved"),
+        ...nativeSkillsLinkLines(report),
         line("Plugin entries", report.plugin.currentCount + " -> " + report.plugin.resultCount),
         ...section("Progress"),
         progressLine("Resolve package"),

package/dist/cli/native-skill-integrity.d.ts

@@ -14,6 +14,22 @@ export type DestinationState = {
     readonly reason: string;
 };
 export declare function nativeSkillsRoot(root: string): Promise<string>;
+export type NativeSkillsRootLink = {
+    readonly path: string;
+    readonly target: string;
+    readonly gitRepositoryRoot?: string;
+};
+export declare function nativeSkillsRootLink(root: string, homeDir?: string): Promise<NativeSkillsRootLink | undefined>;
+export type ShadowSkillLocationId = "user-agents" | "user-claude" | "project-opencode" | "project-claude" | "project-agents";
+export type ShadowSkillLocation = {
+    readonly id: ShadowSkillLocationId;
+    readonly root: string;
+};
+export type ShadowedSkill = {
+    readonly id: string;
+    readonly locations: readonly ShadowSkillLocation[];
+};
+export declare function detectShadowedSkills(skillIds: readonly string[], managedSkillsRoot: string, homeDir?: string, workDir?: string): Promise<readonly ShadowedSkill[]>;
 export declare function sourceSkillDir(metadata: PackageMetadata, id: string): string;
 export declare function nativeSkillContent(metadata: PackageMetadata, skill: RuntimeSkill): Promise<string>;
 export declare function validateManagedSkillSource(metadata: PackageMetadata, id: ManagedSkillId): Promise<void>;

package/dist/cli/native-skill-integrity.js

@@ -1,5 +1,6 @@
 import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
 import { litOpenCodeRuntimeSkills } from "../skills.js";
 import { hasLitOpenCodeGeneratedFileMarker, litOpenCodeGeneratedFrontmatterMarker, stripUserFacingHtmlCommentLines } from "../user-facing-markdown.js";
@@ -9,6 +10,85 @@ import { inspectCanonicalTree } from "./native-canonical-cache.js";
 export async function nativeSkillsRoot(root) {
     return resolveSafeDirectory(root, path.join(root, "skills"), "Native skills destination");
 }
+// Walks upward from `startDir` looking for a `.git` entry (directory or the gitdir-pointer file a
+// worktree/submodule uses), stopping once it reaches `homeDir` or the filesystem root so an
+// unrelated ancestor repository is never reported as the destination.
+async function gitRepositoryRootFor(startDir, homeDir) {
+    const home = path.resolve(homeDir);
+    const fsRoot = path.parse(startDir).root;
+    let current = path.resolve(startDir);
+    while (true) {
+        if ((await lstatIfPresent(path.join(current, ".git"))) !== null)
+            return current;
+        if (current === home || current === fsRoot)
+            return undefined;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+// Reports the same symlink LitOpenCode intentionally follows for install (resolveSafeDirectory),
+// so users can see where their managed skills actually landed and whether that is a git work tree.
+export async function nativeSkillsRootLink(root, homeDir = os.homedir()) {
+    const skillsPath = path.join(path.resolve(root), "skills");
+    const stat = await lstatIfPresent(skillsPath);
+    if (stat === null || !stat.isSymbolicLink())
+        return undefined;
+    const target = await fs.realpath(skillsPath);
+    const gitRepositoryRoot = await gitRepositoryRootFor(target, homeDir);
+    return { path: skillsPath, target, ...(gitRepositoryRoot === undefined ? {} : { gitRepositoryRoot }) };
+}
+function shadowSkillCandidateRoots(homeDir, workDir) {
+    return [
+        { id: "user-agents", root: path.join(homeDir, ".agents", "skills") },
+        { id: "user-claude", root: path.join(homeDir, ".claude", "skills") },
+        { id: "project-opencode", root: path.join(workDir, ".opencode", "skills") },
+        { id: "project-claude", root: path.join(workDir, ".claude", "skills") },
+        { id: "project-agents", root: path.join(workDir, ".agents", "skills") }
+    ];
+}
+async function statIfPresent(filePath) {
+    try {
+        return await fs.stat(filePath);
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR"))
+            return null;
+        throw error;
+    }
+}
+async function realpathOrResolved(candidate) {
+    try {
+        return await fs.realpath(candidate);
+    }
+    catch {
+        return path.resolve(candidate);
+    }
+}
+// OpenCode also reads skills from these other, unmanaged roots; a same-named skill there can be
+// loaded instead of (or alongside) LitOpenCode's managed copy. This is informational only: it never
+// changes `ok`, because LitOpenCode does not own those directories.
+export async function detectShadowedSkills(skillIds, managedSkillsRoot, homeDir = os.homedir(), workDir = process.cwd()) {
+    const managedRealpath = await realpathOrResolved(managedSkillsRoot);
+    const candidates = shadowSkillCandidateRoots(homeDir, workDir);
+    const shadowed = [];
+    for (const id of skillIds) {
+        const locations = [];
+        for (const candidate of candidates) {
+            const entrypoint = path.join(candidate.root, id, "SKILL.md");
+            const stat = await statIfPresent(entrypoint);
+            if (stat === null || !stat.isFile())
+                continue;
+            if ((await realpathOrResolved(candidate.root)) === managedRealpath)
+                continue;
+            locations.push(candidate);
+        }
+        if (locations.length > 0)
+            shadowed.push({ id, locations });
+    }
+    return shadowed;
+}
 export function sourceSkillDir(metadata, id) {
     return path.join(metadata.packageRoot, "skills", id);
 }

package/dist/cli/native-skills.d.ts

@@ -1,7 +1,9 @@
+import { type NativeSkillsRootLink, type ShadowedSkill } from "./native-skill-integrity.ts";
 import { inspectScientificVisualizationDependencies } from "./scientific-visualization-dependencies.ts";
 import type { InstallReport, PackageMetadata } from "./types.ts";
 export { validateManagedSkillSource } from "./native-skill-integrity.ts";
 export { ensureNativeSkills } from "./native-skill-install.ts";
+export type { NativeSkillsRootLink, ShadowedSkill, ShadowSkillLocation, ShadowSkillLocationId } from "./native-skill-integrity.ts";
 export declare function describeNativeSkillMutation(root: string, metadata: PackageMetadata): Promise<InstallReport["nativeSkills"]>;
 export type NativeSkillInspection = {
     readonly path: string;
@@ -17,6 +19,12 @@ export type NativeSkillInspection = {
     readonly dependencies: {
         readonly "lit-scientific-visualization": ReturnType<typeof inspectScientificVisualizationDependencies>;
     };
+    readonly link?: NativeSkillsRootLink;
+    readonly shadowedSkills: readonly ShadowedSkill[];
     readonly ok: boolean;
 };
-export declare function inspectNativeSkills(root: string, metadata: PackageMetadata): Promise<NativeSkillInspection>;
+export type InspectNativeSkillsOptions = {
+    readonly homeDir?: string;
+    readonly workDir?: string;
+};
+export declare function inspectNativeSkills(root: string, metadata: PackageMetadata, options?: InspectNativeSkillsOptions): Promise<NativeSkillInspection>;

package/dist/cli/native-skills.js

@@ -1,9 +1,19 @@
 import path from "node:path";
 import { litOpenCodeRuntimeSkills } from "../skills.js";
-import { destinationState, assertInstalledCanonicalOwnership, invalidInstalledAssets, validateSkillSource } from "./native-skill-integrity.js";
+import { destinationState, assertInstalledCanonicalOwnership, detectShadowedSkills, invalidInstalledAssets, nativeSkillsRoot, nativeSkillsRootLink, validateSkillSource } from "./native-skill-integrity.js";
 import { inspectScientificVisualizationDependencies } from "./scientific-visualization-dependencies.js";
 export { validateManagedSkillSource } from "./native-skill-integrity.js";
 export { ensureNativeSkills } from "./native-skill-install.js";
+// nativeSkillsRoot() follows the same intentional-symlink resolution install uses; if it fails,
+// fall back to the unresolved path so link/shadow reporting stays best-effort instead of throwing.
+async function bestEffortNativeSkillsRoot(root) {
+    try {
+        return await nativeSkillsRoot(root);
+    }
+    catch {
+        return path.join(root, "skills");
+    }
+}
 export async function describeNativeSkillMutation(root, metadata) {
     const write = [];
     const preserve = [];
@@ -21,15 +31,17 @@ export async function describeNativeSkillMutation(root, metadata) {
                 collisions.push(skill.id);
         }
     }
+    const link = await nativeSkillsRootLink(root);
     return {
         path: path.join(root, "skills"),
         changed: write.length > 0,
         write,
         preserve,
-        collisions
+        collisions,
+        ...(link === undefined ? {} : { link })
     };
 }
-export async function inspectNativeSkills(root, metadata) {
+export async function inspectNativeSkills(root, metadata, options = {}) {
     const present = [];
     const missing = [];
     const managed = [];
@@ -88,6 +100,8 @@ export async function inspectNativeSkills(root, metadata) {
         }
     }
     const uniqueInvalid = [...new Set(invalid)];
+    const link = await nativeSkillsRootLink(root, options.homeDir);
+    const shadowedSkills = await detectShadowedSkills(litOpenCodeRuntimeSkills.map((skill) => skill.id), await bestEffortNativeSkillsRoot(root), options.homeDir, options.workDir);
     return {
         path: path.join(root, "skills"),
         expected: litOpenCodeRuntimeSkills.map((skill) => skill.id),
@@ -100,6 +114,8 @@ export async function inspectNativeSkills(root, metadata) {
         sourceInvalid,
         canonicalCacheFiles,
         dependencies: { "lit-scientific-visualization": inspectScientificVisualizationDependencies() },
+        ...(link === undefined ? {} : { link }),
+        shadowedSkills,
         ok: missing.length === 0 && uniqueInvalid.length === 0
     };
 }

package/dist/cli/types.d.ts

@@ -167,6 +167,11 @@ export type InstallReport = {
         readonly write: readonly string[];
         readonly preserve: readonly string[];
         readonly collisions: readonly string[];
+        readonly link?: {
+            readonly path: string;
+            readonly target: string;
+            readonly gitRepositoryRoot?: string;
+        };
     };
     readonly hostLimits: {
         readonly path: string;

package/docs/assets/readme/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.5"><title>release: 1.0.5</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.5</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.6"><title>release: 1.0.6</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.6</text></g></svg>

package/docs/reference-Ko-KR.md

@@ -319,6 +319,28 @@ wrapper 이전에는 보관 사본이 필요하지 않습니다. 교체나 안
 이 검사는 일반적인 사용과 감지한 경로 변경을 다루며, 적대적인 동시 파일 변경까지
 막는다는 보장은 아닙니다.
 
+## 심볼릭 링크된 native 스킬 루트와 다른 위치의 같은 이름 스킬
+
+Install은 `<root>/skills`가 심볼릭 링크여도(예: `~/.config/opencode/skills`가 다른
+디렉토리를 가리키는 경우) 의도적으로 그 링크를 따라가며, 이 경우에도 설치는
+성공합니다. `install`과 `doctor` 모두 이제 이 링크를 보고하므로 조용히 다른 곳에
+쓰는 일이 없습니다: 링크 경로, 실제로 해석된 대상 경로, 그리고 그 대상이 git
+작업 트리 안에 있다면 저장소 루트까지 알려줍니다. 관리 대상 스킬 디렉토리가 그
+저장소 안에 나타나기 때문입니다. 스킬 디렉토리가 개인 git 저장소를 가리키는
+사용자라면 설치 후 그 저장소 안에 수십 개의 새 디렉토리가 생기는 것을 예상해야
+합니다. 이 경고는 설치 실패가 아니라 링크를 다시 정리하라는 안내로 받아들이세요.
+
+`doctor`는 이에 더해 `install.nativeSkills.shadowedSkills`를 보고합니다. 관리 대상
+스킬 id마다, OpenCode가 함께 읽는 다른 스킬 루트에 같은 이름의 `<id>/SKILL.md`
+사본이 있는지 확인합니다 — 사용자 수준의 `~/.agents/skills`, `~/.claude/skills`,
+그리고 현재 작업 디렉토리 기준 프로젝트 수준의 `.opencode/skills`, `.claude/skills`,
+`.agents/skills`가 대상입니다. OpenCode는 둘 중 어느 사본이든 불러올 수 있으며, 이
+문서는 어느 쪽이 우선하는지 단정하지 않습니다. 해석한 경로가 관리 대상 native
+스킬 루트와 같으면 같은 트리이므로 shadow로 표시하지 않고 제외합니다. Shadow
+표시는 안내용이며 `nativeSkills.ok`나 doctor 전체의 `install.ok`를 바꾸지 않습니다.
+보고된 shadow를 해결하려면 관리되지 않는 사본을 지우거나 이름을 바꾸세요. 그대로
+두면 OpenCode가 LitOpenCode가 관리하는 사본 대신 그 사본을 불러올 수 있습니다.
+
 ## 디자인 제작과 README
 
 OpenCode 네이티브 스킬 `frontend-ui-ux`는 충분한 구현 요청을 받으면 작업 화면을 만들고 렌더링을 확인합니다. 중요한 방향이 모호할 때만 질문하며 답변을 보존합니다. 검토·계획 요청은 읽기 전용입니다.

package/docs/reference.md

@@ -414,6 +414,27 @@ need no retained backup. If replacement or safe rollback fails, preserve the rep
 recovery paths and inspect them; do not assume installation succeeded. These checks
 cover ordinary use and detected path changes, not hostile concurrent filesystem mutation.
 
+## Symlinked native skills root and shadow copies
+
+Install intentionally follows a symlinked `<root>/skills` (for example, when a host's
+`~/.config/opencode/skills` is a symlink into another directory) and still succeeds. Both
+`install` and `doctor` now report the link so that is never a silent write: the report
+names the link path, its resolved target, and, if that target sits inside a git work
+tree, the repository root, because managed skill directories will appear inside that
+repository. A user whose skills directory points at a personal git repo should expect to
+see dozens of new directories appear there after install; treat the warning as a prompt
+to redirect the link, not as an install failure.
+
+`doctor` additionally lists `install.nativeSkills.shadowedSkills`: for each managed skill
+id, other skill roots OpenCode also reads that contain a same-named `<id>/SKILL.md`
+copy — user-level `~/.agents/skills` and `~/.claude/skills`, and project-level
+`.opencode/skills`, `.claude/skills`, and `.agents/skills` under the working directory.
+OpenCode can load either copy; which one wins is not asserted here. A root whose
+resolved path is identical to the managed native skills root is the same tree, not a
+shadow, and is excluded. Shadowing is informational: it never flips `nativeSkills.ok` or
+doctor's overall `install.ok`. To resolve a reported shadow, remove or rename the
+unmanaged copy, or accept that OpenCode may prefer it over the LitOpenCode-managed one.
+
 ## Design production and README Studio
 
 The native `frontend-ui-ux` skill takes an adequate authorized build request through working implementation and rendered inspection. It asks only material design choices and retains answers; review and plan requests remain read-only.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/litopencode",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "LitOpenCode OpenCode plugin bootstrap package.",
   "license": "MIT",
   "repository": {

package/skills/frontend-ui-ux/SKILL.md

@@ -34,7 +34,7 @@ Inspect only the task surface and selected skill resources; do not scout harness
 ## #contract.procedure
 
 1. Record a short direction and finite route/state/viewport/theme/input inventory before coding. Reuse existing primitives; explicit user direction wins. Otherwise load `references/production.md` and `references/default-editorial-pixel.json` for the authored default.
-2. Resolve material ambiguity via `references/production.md`: ask one high-impact choice per turn, retain prior answers, and continue only for unresolved choices. For a bounded brief, state the default and build. Action intent is not delegated choice; no routine re-approval.
+2. Resolve material ambiguity via `references/production.md`: ask one high-impact choice per turn, retain prior answers, and continue only for unresolved choices. Open competing directions: ask before choosing. For a bounded brief, state the default and build. Action intent is not delegated choice; no routine re-approval.
 3. Evolve `litfamily.design-contract/v1beta2` alongside implementation. Validate before acceptance; a full schema is not a prerequisite to begin a sufficiently specified build. Keep prior rationale when answers change.
 4. Implement real actions, keyboard/focus, loading/empty/error/recovery states, Korean/Latin readability, contrast and reduced motion. Label-only success is not an action. Inspect 320/390/1440px and verify hidden-state toggles in a browser.
 5. Capture the running surface through an available authorized driver. Tests and markup cannot establish visual quality. Separate local inspection from the independent `visual-qa` verdict.

package/skills/frontend-ui-ux/references/production.md

@@ -2,7 +2,7 @@
 
 Use this authored reference for production and interview decisions; canonical library text remains inert. Start by reading the source and current brief. Record purpose, audience, target, constraints, each answer across rounds, and unresolved choices in a short authorized project note. There is no mandatory interview: a sufficient brief permits the requested build now.
 
-Ask only when at least two plausible answers would materially change scope, architecture, permissions or data behavior, accessibility, or visual direction. Ask one high-impact question per user turn, state the consequence of each choice, then wait before selecting or editing. After each reply, retain the answer alongside earlier answers, update the unresolved-choice note, and ask only the next material question. Continue for as many rounds as materially necessary while an important choice remains open; never re-ask a settled choice, including in new wording. On resume, read the note before deciding whether to ask again. For a bounded brief, state the default direction and continue without an interview or routine approval. Review-only and plan-only requests remain read-only; a keyword or bare target does not authorize edits. Standalone deep-interview's planning-only handoff does not govern this build workflow.
+Ask only when at least two plausible answers would materially change scope, architecture, permissions or data behavior, accessibility, or visual direction. Ask one high-impact question per user turn, state the consequence of each choice, then wait before selecting or editing. After each reply, retain the answer alongside earlier answers, update the unresolved-choice note, and ask only the next material question. Continue for as many rounds as materially necessary while an important choice remains open; never re-ask a settled choice, including in new wording. On resume, read the note before deciding whether to ask again. When a brief names competing visual directions and leaves them undecided, that axis stays unresolved even if the brief calls every option acceptable: acceptance is not a selection or a delegation. Give it its own round once higher-impact choices are answered; you may recommend one option inside the question, but do not announce a default for it or implement before the user picks. A default applies only to choices the brief settles, choices it delegates ("your call", "pick one"), and details that do not materially change the result. A brief with no visual direction at all is not an open choice: apply the authored pixel profile without asking. For a bounded brief, state the default direction and continue without an interview or routine approval. Review-only and plan-only requests remain read-only; a keyword or bare target does not authorize edits. Standalone deep-interview's planning-only handoff does not govern this build workflow.
 
 The default is an original editorial/pixel composition: large headlines with intentional line breaks, small terminal labels, generous section gaps, fine rules, atmospheric color fields and asymmetric focal placement. Pixel imagery must contain visibly discrete grid-aligned cells, limited palette and intentional silhouettes. Smooth vector decoration alone is not the pixel component. Never name or imitate a reference brand, copy its prose or acquire its proprietary fonts/assets. Existing brand constraints override these defaults.
 

package/skills/managed-skill-manifest.json

@@ -789,7 +789,7 @@
         },
         {
           "path": "references/production.md",
-          "sha256": "23d7210027848acc8f9fdeacd8f994ba1d4533d66fc707db689ec4ae90d5c5f1"
+          "sha256": "467a9e54c4f9c9dd18e03144b34f576249c2a85086065819191d119955114e23"
         },
         {
           "path": "references/redesign-playbook.md",
@@ -1388,7 +1388,7 @@
         },
         {
           "path": "references/production.md",
-          "sha256": "375af9d6637322cebfb065d7ca86ebe79abc242d5aa7a2389a2b95cbf5ca4e4b"
+          "sha256": "4a4a813c80825ad039d4d4aaead8a0d45483f73b8e7d0b2978a0aa0b890b3d0a"
         },
         {
           "path": "references/typography.md",

package/skills/readme-studio/references/production.md

@@ -4,7 +4,7 @@ Find the real package root, including monorepo boundaries. Read package metadata
 
 The `scripts/check-facts.mjs` helper is read-only. It rejects unknown fields, duplicate claim ids, empty sources, escaping/symlink/missing source paths and malformed badge URLs. Its success is only structure/path validation. Manually compare each claim to source content and each badge to its real status endpoint. Omit uncertain popularity, coverage, affiliation and supported-platform assertions. Do not invent a badge URL; a syntactically valid URL does not establish that it exists.
 
-First read the brief, current README, project identity and supplied assets. No interview is mandatory. Ask only when at least two plausible answers would materially change README scope or structure, architecture, permissions or data behavior, accessibility, or visual direction. For those choices, ask one high-impact question per user turn, state the consequence, and wait before choosing or editing. Retain every answer in a task-local decision note across rounds; after each reply, ask only about an unresolved material choice. Continue for as many rounds as materially necessary, then proceed without repeated approval. Never re-ask a settled choice, including in new wording; read the note on resume. For a bounded brief, state the default direction and continue. Review-only and plan-only requests remain read-only; a keyword or bare repository name does not authorize writes.
+First read the brief, current README, project identity and supplied assets. No interview is mandatory. Ask only when at least two plausible answers would materially change README scope or structure, architecture, permissions or data behavior, accessibility, or visual direction. For those choices, ask one high-impact question per user turn, state the consequence, and wait before choosing or editing. Retain every answer in a task-local decision note across rounds; after each reply, ask only about an unresolved material choice. Continue for as many rounds as materially necessary, then proceed without repeated approval. Never re-ask a settled choice, including in new wording; read the note on resume. When a brief names competing visual directions and leaves them undecided, that axis stays unresolved even if the brief calls every option acceptable: acceptance is not a selection or a delegation. Give it its own round once higher-impact choices are answered; you may recommend one option inside the question, but do not announce a default for it or implement before the user picks. A default applies only to choices the brief settles, choices it delegates ("your call", "pick one"), and details that do not materially change the result. A brief with no visual direction at all is not an open choice: apply the default cover direction without asking. For a bounded brief, state the default direction and continue. Review-only and plan-only requests remain read-only; a keyword or bare repository name does not authorize writes.
 
 Choose alignment (left/center), tone and theme from the project's identity or the user's direction. A useful reading order is one distinctive cover, small relevant badge/logo row, purpose in plain text, copyable quick start, features or real demo, and navigation for longer documentation. Keep emoji restrained. Preserve current anchors and accurate instructions. Do not flatten prose, installation commands or critical instructions into images.
 

package/tools/version-manifests.json

@@ -44,12 +44,6 @@
       "occurrences": 1,
       "why": "This package manifest is the source of truth used by the lockstep guard."
     },
-    {
-      "path": "skills/readme-studio/templates/remotion/package-lock.json",
-      "kind": "derived",
-      "occurrences": 3,
-      "why": "The Remotion template lockfile has 3 occurrence(s) of an unrelated dependency version matching this package release by coincidence; it is not release metadata, and the count follows the current package version."
-    },
     {
       "path": "test/docs.test.mjs",
       "kind": "pinned",