diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..13c06cf
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,5 @@
+# wordle-hs
+a [Wordle](https://www.powerlanguage.co.uk/wordle/) clone in Haskell, made with help by [skye](https://git.oat.zone/skye)
+
+## build
+`cabal build` then find executables in `build/`, might need a `cabal update` first (or just `cabal run`)
\ No newline at end of file