diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ba8a33b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,58 @@
+# GitHub Actions for Yarn
+
+> Look https://github.com/actions/npm for more details.
+
+This Action for [yarn](https://yarnpkg.com) enables arbitrary actions with the `yarn` command-line client, including testing packages and publishing to a registry.
+
+## Usage
+
+An example workflow to build, test, and publish an npm package to the default public registry follows:
+
+```hcl
+workflow "Build, Test, and Publish" {
+  on = "push"
+  resolves = ["Publish"]
+}
+
+action "Build" {
+  uses = "borales/actions-yarn@master"
+  args = "install"
+}
+
+action "Test" {
+  needs = "Build"
+  uses = "borales/actions-yarn@master"
+  args = "test"
+}
+
+action "Publish" {
+  needs = "Test"
+  uses = "borales/actions-yarn@master"
+  args = "publish --access public"
+  secrets = ["NPM_AUTH_TOKEN"]
+}
+```
+
+### Secrets
+
+* `NPM_AUTH_TOKEN` - **Optional**. The token to use for authentication with the npm registry. Required for `yarn publish` ([more info](https://docs.npmjs.com/getting-started/working_with_tokens))
+
+### Environment variables
+
+* `NPM_REGISTRY_URL` - **Optional**. To specify a registry to authenticate with. Defaults to `registry.npmjs.org`
+* `NPM_CONFIG_USERCONFIG` - **Optional**. To specify a non-default per-user configuration file. Defaults to `$HOME/.npmrc` ([more info](https://docs.npmjs.com/misc/config#npmrc-files))
+
+#### Example
+
+To authenticate with, and publish to, a registry other than `registry.npmjs.org`:
+
+```hcl
+action "Publish" {
+  uses = "borales/actions-yarn@master"
+  args = "publish --access public"
+  env = {
+    NPM_REGISTRY_URL = "someOtherRegistry.someDomain.net"
+  }
+  secrets = ["NPM_AUTH_TOKEN"]
+}
+```