From 1483aeb00f45fd2001066df5ae28ae66b22f20cd Mon Sep 17 00:00:00 2001
From: show <10173746+showxu@users.noreply.github.com>
Date: Mon, 5 Oct 2026 22:09:47 +0800
Subject: [PATCH] Document social preview and avatar uploads

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index c52f0e1..87db14b 100644
--- a/README.md
+++ b/README.md
@@ -46,3 +46,13 @@ jobs:
   brand:
     uses: computer-mcp/.github/.github/workflows/brand-check.yml@<commit>
 ```
+
+## Social previews and avatar
+
+GitHub has no API for a repository's social preview or the organization
+avatar. After a repository's brand pull request merges, upload its
+`.github/brand/social.png` in the repository's settings under Social preview.
+A public repository's preview is current when the image at its GraphQL
+`openGraphImageUrl` has the same SHA-256 as that file. Upload
+`profile/brand/avatar.png` as the organization avatar in the organization's
+settings.