diff --git a/CLAUDE.md b/CLAUDE.md
index defb0fd..25b8fe9 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -103,7 +103,9 @@ Tests live in `tests/UnityCli.Cli.Tests/` (xUnit, `.NET`-testable surface only).
   1. `dotnet run --project cli/UnityCli.DocGen -- --write` — auto-updates `docs/cli-reference.md`
   2. `README.md` — update examples for new/changed commands in both Scene and Prefab sections
   3. `CLAUDE.md` — update Architecture tree if new files are added, update Key Conventions if behavior changes
-  4. `tools/skills/unity-cli-operator/SKILL.md` — update command workflows and examples for AI agent usage
+  4. **The AI-agent skill ships in two copies — update both.** `tools/skills/unity-cli-operator/` is the maintainer copy; `unity-package/com.yhc509.unity-cli-bridge/SkillTemplates~/` is what `SkillInstaller` actually installs into a user's project, and nothing in CI compares them.
+     - `references/*.md` must stay **byte-identical** between the two (`diff -rq` on the two `references/` folders reports nothing).
+     - `SKILL.md` is a deliberate fork: the shipped copy drops maintainer-only content (`## 진입 규칙`). Sync it *where the content applies to end users* — do not make the two identical.
   5. `dotnet run --project cli/UnityCli.DocGen -- --check` — verify cli-reference is up to date
 - **Release checklist:** Cutting a new version:
   1. `CHANGELOG.md` — move `[Unreleased]` entries to new version section with date, then mirror the file to `unity-package/com.yhc509.unity-cli-bridge/CHANGELOG.md` (the UPM package ships its own copy; keep the two identical so Package Manager shows the current changelog)
diff --git a/unity-package/com.yhc509.unity-cli-bridge/SkillTemplates~/SKILL.md b/unity-package/com.yhc509.unity-cli-bridge/SkillTemplates~/SKILL.md
index 2e4954c..9f08f8d 100644
--- a/unity-package/com.yhc509.unity-cli-bridge/SkillTemplates~/SKILL.md
+++ b/unity-package/com.yhc509.unity-cli-bridge/SkillTemplates~/SKILL.md
@@ -89,6 +89,10 @@ unity-cli does not have dedicated script create/delete commands. Use this combin
 - `unity-cli asset delete --path Assets/Scripts/MyScript.cs --force`
   (handles .meta cleanup and refresh automatically)
 
+### Test Runner Workflow
+
+코드 수정 뒤 테스트 러너 기본 호출, `--failures-only`/`--wait`/`--no-domain-reload` 사용 기준, `refresh` 후 재실행 루프는 [references/command-flows.md](references/command-flows.md)의 `테스트 러너` 절을 따른다.
+
 ### Profile Workflow
 
 성능 진단은 다음 루프를 따른다: