diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5c73967
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# phlo's Personal Repository
+
+Repository (overlay) containing custom ebuilds for software not contained in Gentoo's official portage tree.
+
+## Packages
+
+* [app-portage/remerge](https://github.com/phlo/remerge) - a quick and dirty binary package host implementation
+* [dev-cpp/stdman](https://github.com/jeaye/stdman) - C++ standard library man pages (generated from http://cppreference.com)
+
+## Setup
+
+Simply create a repository configuration file `/etc/portage/repos.conf/phlo.conf` containing:
+
+```
+[phlo]
+location = <portdir>/phlo
+sync-type = git
+sync-uri = https://github.com/phlo/phlo-portage.git
+auto-sync = yes
+```
+
+See https://wiki.gentoo.org/wiki//etc/portage/repos.conf for details.