diff --git a/README.md b/README.md
new file mode 100644
index 0000000..89e39b0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# apkbuild-libpod-ansible: a simple playbook to automate software packaging for Alpine Linux
+
+## Usage
+
+### Pre-requisites
+<ul>
+<li>Ansible 2.9+</li>
+<li>collection containers.podman</li>
+<li>libpod</li>
+</ul>
+
+Developed and tested on Gentoo GNU/Linux with ZFS via fuse-overlayfs and crun in rootless mode.
+
+### Variables
+<ul>
+<li>alpine_version</li>
+<li>user.name</li>
+<li>user.email</li>
+<li>user.handle</li>
+<li>package.name</li>
+<li>package.version</li>
+</ul>
+
+### Invocation
+ansible-playbook alpine-builder.yaml