diff --git a/.changeset/add-package-readmes.md b/.changeset/add-package-readmes.md
new file mode 100644
index 0000000..4bbb94c
--- /dev/null
+++ b/.changeset/add-package-readmes.md
@@ -0,0 +1,7 @@
+---
+"@chatcops/core": patch
+"@chatcops/server": patch
+"@chatcops/widget": patch
+---
+
+Add README.md to all packages with install instructions, usage examples, and API reference