diff --git a/packages/eslint-config-airbnb/README.md b/packages/eslint-config-airbnb/README.md
new file mode 100644
index 00000000..d21a1c90
--- /dev/null
+++ b/packages/eslint-config-airbnb/README.md
@@ -0,0 +1,12 @@
+# eslint-config-airbnb
+
+This package provides Airbnb's .eslintrc as an extensible shared config.
+
+## Usage
+
+1. `npm install --save-dev eslint-config-airbnb`
+2. add `"extends": "eslint-config-airbnb"` to your .eslintrc
+
+See [Airbnb's Javascript styleguide](https://github.com/airbnb/javascript) and
+the [ESlint config docs](http://eslint.org/docs/user-guide/configuring#extending-configuration-files)
+for more information.