diff --git a/scripts/generate-plugin-inventory-doc.mjs b/scripts/generate-plugin-inventory-doc.mjs
index f06a6b5dec6b..d2c36cb7eecc 100644
--- a/scripts/generate-plugin-inventory-doc.mjs
+++ b/scripts/generate-plugin-inventory-doc.mjs
@@ -77,7 +77,13 @@ function pluginReferencePath(id) {
 }
 
 function hasGeneratedReferencePage(record) {
-  return !SKIPPED_REFERENCE_PAGE_IDS.has(record.id);
+  if (!SKIPPED_REFERENCE_PAGE_IDS.has(record.id)) {
+    return true;
+  }
+  if (PLUGIN_DOC_ALIASES.has(record.id)) {
+    return false;
+  }
+  throw new Error(`skipped plugin reference page ${record.id} needs a plugin doc alias`);
 }
 
 function pluginInventoryHref(record) {