diff --git a/themes/cor/README.md b/themes/cor/README.md
new file mode 100644
index 0000000..eab2937
--- /dev/null
+++ b/themes/cor/README.md
@@ -0,0 +1,24 @@
+## cor
+
+The name says it all
+
+![cor theme](https://f.cloud.github.com/assets/516068/692075/a30d9080-dbf6-11e2-8dd3-d07cce41259d.png)
+
+For this theme you need a emoji supporting terminal and the emoji-clock plugin
+
+* emoji-clock
+* Git
+* Unicode-compatible fonts and terminals (I use iTerm2 on OSX)
+
+#### Characteristics
+
+##### Left side prompt
+* If the previous command failed (✘)
+* User @ Hostname
+* Abbriviated path
+* Emoji-clock
+
+##### Right side prompt
+* Branch
+* Git status clean dirty (*)
+* Time of last command