feat: auto-sync repo About section from registry.json on release

Made-with: Cursor

Author: TMHSDigital

.github/workflows/release.yml

@@ -71,3 +71,18 @@ jobs:
             --generate-notes
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Sync repo About section
+        run: |
+          TOOLS=$(python3 -c "import json; data=json.load(open('registry.json')); print(len(data))")
+          SKILLS=$(python3 -c "import json; data=json.load(open('registry.json')); print(sum(t.get('skills',0) for t in data))")
+          RULES=$(python3 -c "import json; data=json.load(open('registry.json')); print(sum(t.get('rules',0) for t in data))")
+          MCP=$(python3 -c "import json; data=json.load(open('registry.json')); print(sum(t.get('mcpTools',0) for t in data))")
+
+          DESC="Centralized catalog, standards, and scaffolding for ${TOOLS} TMHSDigital developer tools - ${SKILLS} skills, ${RULES} rules, ${MCP} MCP tools"
+
+          gh repo edit "${{ github.repository }}" \
+            --description "$DESC" \
+            --homepage "https://tmhsdigital.github.io/Developer-Tools-Directory/"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

AGENTS.md

@@ -51,6 +51,8 @@ Checks:
 
 Has a concurrency guard -- only one release can run at a time. Commits with `[skip ci]` are ignored.
 
+After creating the release, it syncs the GitHub repository About section (description and homepage) by reading live counts from `registry.json`. **Do not manually edit the repo description** -- the release workflow owns it.
+
 ### `release-drafter.yml` (runs on push to main and PR activity)
 
 Auto-drafts release notes from merged PR titles/labels. Config in `.github/release-drafter.yml` defines categories (Features, Standards, Scaffold, Bug Fixes, Documentation, CI) and version resolution rules.
@@ -186,7 +188,7 @@ Pure documentation -- no code. Each file documents a convention derived from ana
 
 - **`validate.yml`** runs on PR and push to main. It has three jobs: registry validation, docs existence checks, and scaffold syntax + dry-run test. Keep checks fast -- avoid installing unnecessary dependencies.
 - **`pages.yml`** deploys to GitHub Pages on push to main when `docs/`, `assets/`, or `registry.json` change. It copies `registry.json` into `docs/` and `assets/` into `docs/assets/` before uploading. Uses `actions/deploy-pages`.
-- **`release.yml`** auto-creates a GitHub release on push to main (excluding docs/md/standards changes). It determines the version bump from conventional commit prefixes since the last tag. Has a concurrency guard -- only one release can run at a time. Commits containing `[skip ci]` are ignored.
+- **`release.yml`** auto-creates a GitHub release on push to main (excluding docs/md/standards changes). It determines the version bump from conventional commit prefixes since the last tag. Has a concurrency guard -- only one release can run at a time. Commits containing `[skip ci]` are ignored. After release, it syncs the repo About section (description with live tool/skill/rule/MCP counts, homepage URL) from `registry.json`. Do not manually edit the repo description.
 - **`release-drafter.yml`** auto-drafts release notes from merged PR titles/labels. Config is in `.github/release-drafter.yml`. Categories: Features, Standards, Scaffold, Bug Fixes, Documentation, CI/Infrastructure. The autolabeler assigns labels based on changed file paths.
 - **`stale.yml`** runs weekly (Sunday midnight UTC). Issues: 60-day stale, 14-day close. PRs: 30-day stale, 14-day close. Labels exempt from staleness: `pinned`, `security`, `enhancement` (issues) and `pinned`, `security` (PRs).
 - **`codeql.yml`** runs Python security scanning on push/PR to main and weekly (Monday 06:00 UTC). Uses `github/codeql-action` v3.