diff --git a/.github/workflows/qed-score.yml b/.github/workflows/qed-score.yml
new file mode 100644
index 0000000..8e19f1e
--- /dev/null
+++ b/.github/workflows/qed-score.yml
@@ -0,0 +1,15 @@
+# .github/workflows/qed-score.yml
+name: QED Score
+on:
+  pull_request:
+    paths: ['**/*.md']
+
+permissions:
+  pull-requests: write
+
+jobs:
+  score:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: onebit0fme/qed-plugins/actions/score-docs@main
diff --git a/README.md b/README.md
index b3a7a52..45583b4 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,12 @@ Two skills:
 
 No setup required — the plugin connects to the hosted API at `qed.systems`.
 
+## GitHub Actions
+
+### score-docs
+
+Score markdown files on every PR. See [actions/score-docs](actions/score-docs/) for setup and configuration.
+
 ## License ███
 
 Apache-2.0