diff --git a/node-build-jxcore.rb b/node-build-jxcore.rb
index 2edc3a2..362db7c 100644
--- a/node-build-jxcore.rb
+++ b/node-build-jxcore.rb
@@ -14,6 +14,15 @@ def install
     system "./install.sh"
   end
 
+  def caveats
+    <<~MSG
+      For `node-build`/`nodenv install` to pick up definitions provided by this plugin,
+      ensure '#{share/"node-build"}' exists in NODE_BUILD_DEFINITIONS.
+
+          export NODE_BUILD_DEFINITIONS="#{share/"node-build"}"
+    MSG
+  end
+
   test do
     system "ls", "#{share}/node-build"
   end
diff --git a/node-build-prerelease.rb b/node-build-prerelease.rb
index 2f71d7d..90ef5ae 100644
--- a/node-build-prerelease.rb
+++ b/node-build-prerelease.rb
@@ -14,6 +14,15 @@ def install
     system "./install.sh"
   end
 
+  def caveats
+    <<~MSG
+      For `node-build`/`nodenv install` to pick up definitions provided by this plugin,
+      ensure '#{share/"node-build"}' exists in NODE_BUILD_DEFINITIONS.
+
+          export NODE_BUILD_DEFINITIONS="#{share/"node-build"}"
+    MSG
+  end
+
   test do
     system "ls", "#{share}/node-build"
   end
diff --git a/node-build-update-defs.rb b/node-build-update-defs.rb
index 744a348..9fe7d55 100644
--- a/node-build-update-defs.rb
+++ b/node-build-update-defs.rb
@@ -14,7 +14,16 @@ def install
     prefix.install Dir["*"]
   end
 
+  def caveats
+    <<~MSG
+      For `node-build`/`nodenv install` to pick up definitions written by this plugin,
+      ensure '#{share/"node-build"}' exists in NODE_BUILD_DEFINITIONS.
+
+          export NODE_BUILD_DEFINITIONS="#{share/"node-build"}"
+    MSG
+  end
+
   test do
-    assert_match /^update-version-defs$/, shell_output("nodenv commands")
+    assert_match(/^update-version-defs$/, shell_output("nodenv commands"))
   end
 end