diff --git a/README.md b/README.md
index eb34f1a7..6a4a88f7 100644
--- a/README.md
+++ b/README.md
@@ -61,6 +61,7 @@ It runs on Linux, macOS, Raspberry Pi, BSD, Cygwin, Linux subsystem for Windows
   - [Configuration](#configuration)
   - [Help](#help)
 - [Quickstart](#quickstart)
+- [User scripts](#user-scripts)
 - [Troubleshooting](#troubleshooting)
   - [Tmux configuration](#tmux-configuration)
   - [BSD terminal issue](#bsd-terminal-issue)
@@ -401,6 +402,20 @@ To lookup keyboard shortcuts at runtime, press <kbd>?</kbd>.
 - For additional functionality [setup custom scripts](https://github.com/jarun/nnn/wiki/How-to#run-custom-scripts).
 - Visit the [How to](https://github.com/jarun/nnn/wiki/How-to) for many more specific usecases.
 
+#### USER SCRIPTS
+
+The following [user-scripts](https://github.com/jarun/nnn/tree/master/user-scripts) are available.
+
+| Script | Description |
+| --- | --- |
+| copier.sh | Copy selection to clipboard |
+| edit.sh | Fuzzy find a file in directory subtree with fzy and edit in vim |
+| fzy.sh | Fuzzy find a file in directory subtree with fzy and open using xdg-open |
+| imgur.sh | Upload an image file to imgur |
+| picker.sh | Pick files and pipe the newline-separated list to another utility |
+| sxiv.sh | Open images in current directory in sxiv |
+| upgrade.sh | Check and update to latest version of nnn manually on Debian 9 Stretch |
+
 #### TROUBLESHOOTING
 
 ##### Tmux configuration
diff --git a/user-scripts/imgur.sh b/user-scripts/imgur.sh
index 675a3f0d..0a660fc7 100755
--- a/user-scripts/imgur.sh
+++ b/user-scripts/imgur.sh
@@ -3,6 +3,9 @@
 # https://imgur.com/tools
 #
 # Slightly modified for `nnn` integration
+#
+# Shell: bash
+# Description: Upload an image file to imgur
 
 if [ "${1}" = "--debug" ]; then
   echo "########################################"
diff --git a/user-scripts/picker.sh b/user-scripts/picker.sh
index 46168f1f..cebecb16 100755
--- a/user-scripts/picker.sh
+++ b/user-scripts/picker.sh
@@ -1,6 +1,6 @@
 #!/usr/bin/env sh
 
-# Description: Pick files and pipe the line-separated list to another utility
+# Description: Pick files and pipe the newline-separated list to another utility
 #
 # Shell: generic
 # Author: Arun Prakash Jana