diff --git a/vello_shaders/README.md b/vello_shaders/README.md
new file mode 100644
index 0000000..c0cf1af
--- /dev/null
+++ b/vello_shaders/README.md
@@ -0,0 +1,7 @@
+The `vello_shaders` crate provides a utility library to integrate the Vello shader modules into any
+renderer project. The create provides the necessary metadata to construct the individual compute
+pipelines on any GPU API while leaving the responsibility of all API interactions (such as
+resource management and command encoding) up to the client.
+
+The shaders can be pre-compiled to any target shading language at build time based on feature flags.
+Currently only WGSL and Metal Shading Language are supported.