diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1369076
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+## My tilde.club gemini capsule
+
+Here is the repository of my tilde.club capsule you can browse
+`gemini://tilde.club/~valvin`
+
+It uses kiln to be generated: `kiln build`
+