diff --git a/.github/workflows/README.md b/.github/workflows/README.md
new file mode 100644
index 0000000..79d40a0
--- /dev/null
+++ b/.github/workflows/README.md
@@ -0,0 +1,13 @@
+# GitHub Actions
+
+This folder contains the following GitHub Actions:
+
+- [CI][CI] - all CI jobs for the project
+  - lints the code
+  - `typecheck`s the code
+  - runs test suite
+  - runs on `ubuntu-latest`
+- [Release][Release] - automates the release process & changelog generation
+
+[CI]: ./workflows/ci.yml
+[Release]: ./workflows/release.yml