diff --git a/.changeset/30772-platform-skill-package-install-url.md b/.changeset/30772-platform-skill-package-install-url.md
new file mode 100644
index 00000000000..431991e32c4
--- /dev/null
+++ b/.changeset/30772-platform-skill-package-install-url.md
@@ -0,0 +1,8 @@
+---
+'@objectstack/skills': patch
+---
+
+docs(skills): objectstack-platform's `references/operations.md` spells `os package install`'s server flag `-u/--url` (in place of the removed `-r/--runtime`) and names the new `-t/--token` (env `OS_RUNTIME_TOKEN`) beside `--email/--password` as the target runtime's credential, matching the CLI
+
+Clause-②: no
+Metadata-protocol: none
diff --git a/skills/objectstack-platform/references/operations.md b/skills/objectstack-platform/references/operations.md
index 0bfca5358c7..c71f68b6a6a 100644
--- a/skills/objectstack-platform/references/operations.md
+++ b/skills/objectstack-platform/references/operations.md
@@ -103,7 +103,7 @@ Port resolution is the same for `os dev` and `os start` (both spawn `os serve`):
 | `os register` | Register the local stack as a deployable target |
 | `os cloud login` / `logout` / `whoami` | Cloud auth subcommands (these three only — there are no `os cloud logs/metrics/status`) |
 | `os package publish [dist/objectstack.json] [--env … --install --visibility org]` | Upload the compiled artifact as a versioned package to the cloud catalog (ADR-0008 P3). Listing file, README, review and every screen the customer's administrator meets: [Marketplace handbook](https://objectstack.ai/docs/deployment/marketplace-handbook) |
-| `os package install <manifest-id │ ./dist/objectstack.json> [--version │ --runtime http://localhost:3000]` | Install a package into a **running** runtime via its install-local endpoint. Catalog mode (by manifest id) or air-gapped local-artifact mode. Auths with the **target runtime's** session (`--email/--password` or `OS_RUNTIME_EMAIL`/`OS_RUNTIME_PASSWORD`), not the cloud login |
+| `os package install <manifest-id │ ./dist/objectstack.json> [--version │ -u/--url http://localhost:3000]` | Install a package into a **running** runtime. Catalog mode (by manifest id) or air-gapped local-artifact mode. Auths as a **target runtime** user (`-t/--token` or `--email/--password`; env `OS_RUNTIME_TOKEN` or `OS_RUNTIME_EMAIL`/`OS_RUNTIME_PASSWORD`), not the cloud login |
 
 > **Cloud connection & marketplace (`@objectstack/cloud-connection`, ADR-0008/0009).**
 > The open runtime-side cloud client. Its plugins —