diff --git a/tools/metadata/README.md b/tools/metadata/README.md
new file mode 100644
index 0000000000..6447457320
--- /dev/null
+++ b/tools/metadata/README.md
@@ -0,0 +1,15 @@
+# TypeScript Decorator metadata collector
+
+The `.d.ts` format does not preserve information about the Decorators applied to symbols.
+Some tools, such as Angular 2 template compiler, need access to statically analyzable
+information about Decorators, so this library allows programs to produce a `foo.metadata.json`
+to accompany a `foo.d.ts` file, and preserves the information that was lost in the declaration
+emit.
+
+## Releasing
+```
+$ gulp build.tools
+$ cp tools/metadata/package.json dist/tools/metadata/
+$ npm login [angularcore]
+$ npm publish dist/tools/metadata
+```
\ No newline at end of file
diff --git a/tools/metadata/package.json b/tools/metadata/package.json
new file mode 100644
index 0000000000..479049e779
--- /dev/null
+++ b/tools/metadata/package.json
@@ -0,0 +1,16 @@
+{
+  "name": "ts-metadata-collector",
+  "version": "0.1.0",
+  "description": "Collects static Decorator metadata from TypeScript sources",
+  "homepage": "https://github.com/angular/angular/tree/master/tools/metadata",
+  "bugs": "https://github.com/angular/angular/issues",
+  "contributors": [
+    "Chuck Jazdzewski <chuckj@google.com>"
+  ],
+  "license": "MIT",
+  "repository": {"type":"git","url":"https://github.com/angular/angular.git"},
+  "devDependencies": {},
+  "peerDependencies": {
+    "typescript": "^1.8.9 || ^1.9"
+  }
+}