diff --git a/README.md b/README.md
new file mode 100644
index 0000000..22af718
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+## Workflow with secrets
+
+Useful Gitea workflow for safe decryption of secrets in a .env which might contain sensitive data such usernames,
+passwords, API keys and so on. A good use case for this workflow is to use it to provide decrypted environment variables at
+runtime to a docker container. For example, `docker run --env-file ./.env ubuntu bash`.
\ No newline at end of file