diff --git a/.changeset/social-insects-cheat.md b/.changeset/social-insects-cheat.md
index 13593865c2..494cba15e7 100644
--- a/.changeset/social-insects-cheat.md
+++ b/.changeset/social-insects-cheat.md
@@ -2,4 +2,20 @@
 '@backstage/plugin-scaffolder-backend-module-github': patch
 ---
 
-Added support for deleting files
+Added support for file deletion to `publish:github:pull-request` action.
+
+Example usage:
+
+```diff
+  - action: publish:github:pull-request
+    id: clean-up-pr
+    input:
+      description: This is the description
++     filesToDelete:
++       - outdated/changelog.md
++       - sample-file.txt
+      owner: owner
+      repo: repo
+      title: Title Goes Here
+
+```