diff --git a/modules/history-substring-search/README.md b/modules/history-substring-search/README.md
new file mode 100644
index 0000000..6e75170
--- /dev/null
+++ b/modules/history-substring-search/README.md
@@ -0,0 +1,17 @@
+History-Substring-Search
+========================
+
+Allows for fish-shell-like searching of history with UP and DOWN.
+
+The options set explicitly by init.zsh are the default options, and are only set for consistancy.
+
+![example][fish_shell]
+
+Functionality is sourced from [history-substring-search](https://github.com/zsh-users/zsh-history-substring-search)
+
+Contributing
+------------
+
+Contributions should be submitted [upstream to history-substring-search](https://github.com/zsh-users/zsh-history-substring-search)
+
+[fish_shell]: http://i.eriner.me/zim_history-substring-search.gif