diff --git a/README.md b/README.md
new file mode 100644
index 0000000..475566f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+- `./update-issues.sh` - get latest list of open issues from Github
+- `./update-packages.hs` - get latest list of packages in nixpkgs (requires Nix to be installed and set up)
+- `node match.js` - do the classification