diff --git a/dual-function-keys/.config/dual-function-keys.yaml b/dual-function-keys/.config/dual-function-keys.yaml
new file mode 100644
index 0000000..8cf8052
--- /dev/null
+++ b/dual-function-keys/.config/dual-function-keys.yaml
@@ -0,0 +1,10 @@
+TIMING:
+    - TAP_MILLISEC: 1000
+    - DOUBLE_TAP_MILLISEC: 0
+MAPPINGS:
+    - KEY: KEY_CAPSLOCK
+      TAP: KEY_ESC
+      HOLD: KEY_LEFTCTRL
+    - KEY: KEY_SYSRQ
+      TAP: KEY_SYSRQ
+      HOLD: KEY_RIGHTMETA
diff --git a/dual-function-keys/README.md b/dual-function-keys/README.md
new file mode 100644
index 0000000..c8e4eb0
--- /dev/null
+++ b/dual-function-keys/README.md
@@ -0,0 +1,17 @@
+# dual-function-keys
+
+[dual-function-keys][dual-function-keys] is a way to give your keys multiple functions.
+
+## Use Cases
+
+dual-function-keys can be used to:
+
+- Have a caps lock key that works as ctrl and escape, without having your real ctrl key function as another escape key
+- Have one keybinding config that works across Xorg, Wayland, and ttys
+- Replace xcape, xmodmap, setxkbmap, keystrings, and similar technologies
+
+You should not use dual-function-keys if:
+
+- You should use dual-function-keys.
+
+[dual-function-keys]: https://gitlab.com/interception/linux/plugins/dual-function-keys