diff --git a/README.md b/README.md
index d23eba6..4b1058b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,32 @@
-# Hello World Skill
+# <img src='https://rawgithub.com/FortAwesome/Font-Awesome/master/advanced-options/raw-svg/solid/smile.svg ' card_color='#22a7f0' width='50' height='50' style='vertical-align:bottom'/> Hello World
+Introductory Skill so that Skill Authors can see how a Mycroft Skill is put together
 
-## Usage:
-* `hello world`
-* `how are you`
-* `thank you`
+## About 
+This is a basic Hello Word Skill that takes an _Utterance_ from the user and provides a voice response - a _Dialog_. This Skill demonstrates the basic directory and file structure of a Mycroft Skill, and is a good first Skill to study if you are interested in developing Skills for the Mycroft ecosystem. 
+
+If you want to write **Skills** for Mycroft, Documentation is available: 
+
+* [Mycroft Skills Kit](https://mycroft.ai/documentation/skills/msk/)
+* [Developing a new Skill](https://mycroft.ai/documentation/skills/introduction-developing-skills/)
+* [Skill Settings](https://mycroft.ai/documentation/skills/skill-settings/)
+* [Automatic testing of your Mycroft Skill](https://mycroft.ai/documentation/skills/automatic-testing/)
+* [Skill Acceptance Process](https://mycroft.ai/documentation/skills/skills-acceptance-process/)
+* [Mycroft Skills Manager](https://mycroft.ai/documentation/msm/)
+* [Mycroft Message Bus](https://mycroft.ai/documentation/message-bus/)
+
+## Examples 
+* "Hello world"
+* "How are you?"
+* "Thank you"
+
+## Credits 
+Mycroft AI (@MycroftAI)
+
+## Category
+**Daily**
+
+## Tags
+#helloworld
+#first-skill
+#hello
+#greeting