diff --git a/modules/lang/sh/README.org b/modules/lang/sh/README.org
index 8ee01d3d9..782344eb9 100644
--- a/modules/lang/sh/README.org
+++ b/modules/lang/sh/README.org
@@ -9,14 +9,18 @@ This module adds support for shell scripting languages.
 
 * Table of Contents :TOC:
 - [[#install][Install]]
+  - [[#dependencies][Dependencies]]
 - [[#appendix][Appendix]]
   - [[#commands][Commands]]
 
 * Install
-This module has no dependencies.
+** Dependencies
+This module has one soft dependency:
+
++ ~shellcheck~ Enables shell script linting.
 
 * Appendix
 ** Commands
-| command    | key / ex command | description                                           |
-|------------+------------------+-------------------------------------------------------|
-| ~+sh/repl~ | =:repl=          | Open a terminal (or send the current selection to it) |
+| command         | key / ex command | description                                           |
+|-----------------+------------------+-------------------------------------------------------|
+| ~+sh/open-repl~ | =:repl=          | Open a terminal (or send the current selection to it) |
diff --git a/modules/lang/sh/doctor.el b/modules/lang/sh/doctor.el
new file mode 100644
index 000000000..0a9687a29
--- /dev/null
+++ b/modules/lang/sh/doctor.el
@@ -0,0 +1,5 @@
+;;; lang/sh/doctor.el -*- lexical-binding: t; -*-
+
+(when! (not (executable-find "shellcheck"))
+  (warn! "Couldn't find shellcheck. Shell script linting will not work"))
+