README.md in crystallize-0.0.1 vs README.md in crystallize-0.0.2

@@ -1,7 +1,27 @@
 Crystallize
 =====
-Create gems!
+Generate gems!
+
+Overview
+--------
+
+Crystallize lets you quickly create gems. Run `crystallize my_gem` to generate the codebase for a gem named `my_gem` that has all of the best things: a pleasant directory structure, rspec, an MIT-LICENSE, a formatted README, a git repo, and more.
+
+Installation
+------------
+
+```bash
+gem install crystallize
+```
+
+Usage
+-----
+
+```bash
+$ crystallize my_gem
+Created gem in ./my_gem
+```
 
 License
 -------
 
 Crystallize is released under the MIT License. Please see the MIT-LICENSE file for details.