diff --git a/plugins/kyberforge/.apm/skills/apm-workflow/references/compile.md b/plugins/kyberforge/.apm/skills/apm-workflow/references/compile.md
index d9b77d9..ae801ea 100644
--- a/plugins/kyberforge/.apm/skills/apm-workflow/references/compile.md
+++ b/plugins/kyberforge/.apm/skills/apm-workflow/references/compile.md
@@ -51,6 +51,8 @@ apm publish --package acme/my-skill
 
 Publishes a producer package (root containing `apm.yml`, `.apm/`, and optionally a `registries:` block) to a registry. Always dry-run with `-v` first — publishing is not trivially reversible once a version tag is claimed on a registry.
 
+Publishing to a named registry requires `apm experimental enable registries` to have already run — see `references/configure.md`'s Gotchas for the full precondition and its silent-no-op failure mode.
+
 ## Run
 
 ```bash
diff --git a/plugins/kyberforge/.apm/skills/apm-workflow/references/install.md b/plugins/kyberforge/.apm/skills/apm-workflow/references/install.md
index 760c44e..8f30470 100644
--- a/plugins/kyberforge/.apm/skills/apm-workflow/references/install.md
+++ b/plugins/kyberforge/.apm/skills/apm-workflow/references/install.md
@@ -18,3 +18,5 @@ With no arguments, resolves and installs everything declared under `dependencies
 `--update` is the escape hatch for a lockfile hash mismatch against upstream — normal `apm install` treats that as drift and won't silently accept it; see `references/audit.md` for the CI-side check (`apm install --frozen`) that fails instead of re-resolving.
 
 `--target agent-skills` generates the vendor-neutral output directory instead of a Claude/Copilot-specific one — for IDE-agnostic tool support.
+
+If a `PACKAGE_REF` resolves through a named registry rather than a plain git source, `apm experimental enable registries` must already have been run — see `references/configure.md`'s Gotchas for the full precondition and its silent-no-op failure mode.
diff --git a/plugins/kyberforge/skills/apm-workflow/references/compile.md b/plugins/kyberforge/skills/apm-workflow/references/compile.md
index d9b77d9..ae801ea 100644
--- a/plugins/kyberforge/skills/apm-workflow/references/compile.md
+++ b/plugins/kyberforge/skills/apm-workflow/references/compile.md
@@ -51,6 +51,8 @@ apm publish --package acme/my-skill
 
 Publishes a producer package (root containing `apm.yml`, `.apm/`, and optionally a `registries:` block) to a registry. Always dry-run with `-v` first — publishing is not trivially reversible once a version tag is claimed on a registry.
 
+Publishing to a named registry requires `apm experimental enable registries` to have already run — see `references/configure.md`'s Gotchas for the full precondition and its silent-no-op failure mode.
+
 ## Run
 
 ```bash
diff --git a/plugins/kyberforge/skills/apm-workflow/references/install.md b/plugins/kyberforge/skills/apm-workflow/references/install.md
index 760c44e..8f30470 100644
--- a/plugins/kyberforge/skills/apm-workflow/references/install.md
+++ b/plugins/kyberforge/skills/apm-workflow/references/install.md
@@ -18,3 +18,5 @@ With no arguments, resolves and installs everything declared under `dependencies
 `--update` is the escape hatch for a lockfile hash mismatch against upstream — normal `apm install` treats that as drift and won't silently accept it; see `references/audit.md` for the CI-side check (`apm install --frozen`) that fails instead of re-resolving.
 
 `--target agent-skills` generates the vendor-neutral output directory instead of a Claude/Copilot-specific one — for IDE-agnostic tool support.
+
+If a `PACKAGE_REF` resolves through a named registry rather than a plain git source, `apm experimental enable registries` must already have been run — see `references/configure.md`'s Gotchas for the full precondition and its silent-no-op failure mode.