The readme should give more detailed install instructions, usage examples, and caveats. Also it should have the same readme contents published to npm, and a link from the npm page to the github repo.