diff --git a/lib/codemod/README.md b/lib/codemod/README.md
index f130f7d3b99..9686dd42d57 100644
--- a/lib/codemod/README.md
+++ b/lib/codemod/README.md
@@ -3,8 +3,26 @@
 Storybook Codemods is a collection of codemod scripts written with JSCodeshift.
 It will help you migrate breaking changes & deprecations.
 
+## CLI Integration
+
+The preferred way to run these codemods is via the CLI's `migrate` command.
+
+To get a list of available codemods:
+
+```
+npx -p @storybook/cli sb migrate --list
+```
+
+To run a codemod:
+
+```
+npx -p @storybook/cli sb migrate name-of-codemod --glob "**/*.stories.js"
+```
+
 ## Installation
 
+If you want to run these codemods by hand:
+
 ```sh
 yarn add jscodeshift @storybook/codemod --dev
 ```