One thing that could help:<p>Add to the top of the readme something that basically shows "put in this / do this" and "get this"<p>Kind of like a before and after.<p>Basically, I'd recommend exposing 2-3 of the examples on the readme, otherwise the readme just shows how to run it, which doesn't show what it does / what it's for.