From eb71ddc1da20ea4cba858b6a4923d62918f52885 Mon Sep 17 00:00:00 2001
From: BB-fat <1056871944@qq.com>
Date: Fri, 14 Aug 2026 08:10:05 +0000
Subject: [PATCH] docs(dsh-plugin-browserskill): note the top-right docking and
 shell-native styling

---
 packages/dsh-plugin-browserskill/README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/dsh-plugin-browserskill/README.md b/packages/dsh-plugin-browserskill/README.md
index 0aa9467..f0cc68f 100644
--- a/packages/dsh-plugin-browserskill/README.md
+++ b/packages/dsh-plugin-browserskill/README.md
@@ -75,7 +75,9 @@ All fields are optional and validated through the plugin's Schemastery `Config`:
 
 When the plugin runs inside the dsh Web UI, an **observation overlay** floats over the app
 (registered into the `shell.overlay` seat): a breathing thumbnail per owned session plus its
-current action and elapsed time.
+current action and elapsed time. The card docks at the top-right of the content area (clear of
+the composer and the shell's header controls) and follows the shell's own visual language —
+shared `ui-primitives` controls and `--dsw-alias-*` semantic tokens throughout.
 
 - **Lifecycle**: hidden while the plugin owns no sessions; appears on the first
   `browser_session_start`; disappears when all sessions stop (or the plugin unloads).