diff --git a/packages/shared-backend/README.md b/packages/shared-backend/README.md
index cb3fa83d0..41391b9fa 100644
--- a/packages/shared-backend/README.md
+++ b/packages/shared-backend/README.md
@@ -1,12 +1,6 @@
 # @hexclave/shared-backend
 
-Shared backend utilities for [Hexclave](https://hexclave.com) — open-source authentication and user management.
-
-## Installation
-
-```bash
-npm install @hexclave/shared-backend
-```
+Internal shared backend utilities for the [Hexclave](https://hexclave.com) SDK. This package is not intended for direct consumption — it is used internally by other `@hexclave/*` packages.
 
 ## Documentation
 
diff --git a/packages/shared/README.md b/packages/shared/README.md
index ebe40b1c9..61fd178c4 100644
--- a/packages/shared/README.md
+++ b/packages/shared/README.md
@@ -1,12 +1,6 @@
 # @hexclave/shared
 
-Shared utilities and types for [Hexclave](https://hexclave.com) — open-source authentication and user management.
-
-## Installation
-
-```bash
-npm install @hexclave/shared
-```
+Internal shared utilities and types for the [Hexclave](https://hexclave.com) SDK. This package is not intended for direct consumption — it is used internally by other `@hexclave/*` packages.
 
 ## Documentation
 
diff --git a/packages/template/README.md b/packages/template/README.md
index 1e2237292..9327068da 100644
--- a/packages/template/README.md
+++ b/packages/template/README.md
@@ -14,6 +14,10 @@ The official SDK for [Hexclave](https://hexclave.com) — open-source authentica
 
 Full documentation is available at [docs.hexclave.com](https://docs.hexclave.com).
 
+## Migrating from Stack Auth
+
+If you're migrating from `@stackframe/stack`, see the [migration guide](https://docs.hexclave.com/migration).
+
 ## Links
 
 - [Hexclave](https://hexclave.com)