diff --git a/README.md b/README.md
index a0aeb0e..7e68d27 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,14 @@
-# Fallback-aiml
+## AIML Fallback Skill
 
-This is a AIML fallback using the Alice chatbot files. Everything advanced was made by JarbasAI (https://github.com/jarbasAI), this is just a repackaging of his work so it works stand-alone in the current mycroft-core (2017-08-09). All praise should go to him!
+
+## Description 
+This is a AIML fallback using the Alice chatbot files. This is based on the works of [JarbasAI](https://github.com/JarbasAI) to work stand-alone in the current mycroft-core (2017-08-09). 
+
+## Examples 
+* "Hey Mycroft, are you a robot?"
+* "Hey Mycroft, what is the name of my dog?"
+
+## Credits 
+JarbasAI
+nielstron
+forslund