diff --git a/.changeset/27331-skills-marketplace-handbook-link.md b/.changeset/27331-skills-marketplace-handbook-link.md
new file mode 100644
index 00000000000..e6b1c5d26c3
--- /dev/null
+++ b/.changeset/27331-skills-marketplace-handbook-link.md
@@ -0,0 +1,12 @@
+---
+'@objectstack/skills': patch
+---
+
+docs(skills): the `os package publish` row of objectstack-platform's operations reference points app authors at the Marketplace handbook
+
+Clause-②: no
+Metadata-protocol: none
+
+- **Before.** The platform skill's operations reference described `os package publish` as an upload to the cloud catalog and nothing more. An agent authoring an app from the skills never found the page that says what a listing is made of (`objectstack.manifest.json`, the README), what review checks, and what the customer's administrator goes through after installing.
+- **Now.** That row names the listing file, the README, review and the administrator's screens, and links `https://objectstack.ai/docs/deployment/marketplace-handbook`.
+- Paid for under the skills token ratchet by deleting the cloud-connection note's tail (the `LocalManifestSource` ledger and runtime-identity bind v2), plugin internals an app author never acts on. The file stays under its ceiling; no ceiling moves, no frontmatter, schema, key or behaviour changes.
diff --git a/skills/objectstack-platform/references/operations.md b/skills/objectstack-platform/references/operations.md
index 4c790c33a4f..c3bf776b4a2 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 environments list` / `create` / `switch` | Manage cloud environments (prod/staging/dev) |
 | `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) |
+| `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 |
 
 > **Cloud connection & marketplace (`@objectstack/cloud-connection`, ADR-0008/0009).**
@@ -111,9 +111,7 @@ Port resolution is the same for `os dev` and `os start` (both spawn `os serve`):
 > `CloudConnectionPlugin`/`createCloudConnectionPlugin`, `MarketplaceProxyPlugin`,
 > `MarketplaceInstallLocalPlugin`, `RuntimeConfigPlugin` — expose the install-local
 > endpoint that `os package install` targets, ship the **Installed Apps** page and
-> marketplace Setup nav as plugin metadata, and maintain `LocalManifestSource`
-> (a local desired-state ledger) plus runtime-identity bind v2 (environment-less
-> self-hosted binding).
+> marketplace Setup nav as plugin metadata.
 
 ## Shipping a plugin