chore: implement repo improvements plan (npm scripts, docs, catalog CI, i18n, validator)

- Add npm scripts: validate, validate:strict, index, readme, chain, catalog, build
- Align docs to V4 and 560 skills (GETTING_STARTED, FAQ, BUNDLES, MAINTENANCE, vietnamese)
- build-catalog: output to data/ for catalog, bundles, aliases; add to CI and drift check
- Add yaml dep, Node setup and catalog step in CI; extend auto-commit and drift msg
- Translate CI and MAINTENANCE to English; update CI_DRIFT_FIX and maintenance routine
- QUALITY_BAR/CONTRIBUTING: canonical validator npm run validate; legacy note in validate-skills.js

.github/MAINTENANCE.md

@@ -1,4 +1,4 @@
-# 🛠️ Repository Maintenance Guide (V3)
+# 🛠️ Repository Maintenance Guide (V4)
 
 > **"If it's not documented, it's broken."**
 
@@ -24,21 +24,20 @@ Committing is NOT enough. You must PUSH to the remote.
 
 If you touch **any of these**:
 
-- `skills/` (aggiungi/rimuovi/modifichi skill)
-- la sezione **Full Skill Registry** di `README.md`
-- i **conteggi/claim** sul numero di skill (`256+ Agentic Skills...`, `(256/256)`, ecc.)
+- `skills/` (add/remove/modify skills)
+- the **Full Skill Registry** section of `README.md`
+- **counts/claims** about the number of skills (`560+ Agentic Skills...`, `(560/560)`, etc.)
 
-…allora **DEVI** eseguire la Validation Chain **PRIMA** di committare.
+…then you **MUST** run the Validation Chain **BEFORE** committing.
 
-- Eseguire `validate_skills.py` **NON è opzionale**.
-- Eseguire `generate_index.py` **NON è opzionale**.
-- Eseguire `update_readme.py` **NON è opzionale**.
+- Running `npm run chain` is **NOT optional**.
+- Running `npm run catalog` is **NOT optional**.
 
-Se la CI fallisce con:
+If CI fails with:
 
-> `❌ Detected uncommitted changes in README.md or skills_index.json`
+> `❌ Detected uncommitted changes produced by registry/readme/catalog scripts.`
 
-significa che **non hai eseguito o committato** correttamente la Validation Chain.
+it means you **did not run or commit** the Validation Chain correctly.
 
 ### 3. 📝 EVIDENCE OF WORK
 
@@ -59,29 +58,23 @@ significa che **non hai eseguito o committato** correttamente la Validation Chai
 
 Before ANY commit that adds/modifies skills, run the chain:
 
-1.  **Validate Metadata & Quality**:
+1.  **Validate, index, and update readme**:
 
     ```bash
-    python3 scripts/validate_skills.py
+    npm run chain
     ```
 
     _Must return 0 errors for new skills._
 
-2.  **Regenerate Index**:
+2.  **Build catalog**:
 
     ```bash
-    python3 scripts/generate_index.py
+    npm run catalog
     ```
 
-3.  **Update Readme**:
-
+3.  **COMMIT GENERATED FILES**:
     ```bash
-    python3 scripts/update_readme.py
-    ```
-
-4.  **COMMIT GENERATED FILES**:
-    ```bash
-    git add skills_index.json README.md
+    git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md
     git commit -m "chore: sync generated files"
     ```
     > 🔴 **CRITICAL**: If you skip this, CI will fail with "Detected uncommitted changes".
@@ -102,13 +95,13 @@ After multiple PR merges or significant changes:
 3.  **Draft a Release**:
     - Go to [Releases Page](https://github.com/sickn33/antigravity-awesome-skills/releases).
     - Draft a new release for the merged changes.
-    - Tag version (e.g., `v3.1.0`).
+    - Tag version (e.g., `v4.1.0`).
 
 ---
 
 ## 2. 📝 Documentation "Pixel Perfect" Rules
 
-We discovered several consistency issues during V3 development. Follow these rules STRICTLY.
+We discovered several consistency issues during V4 development. Follow these rules STRICTLY.
 
 ### A. Table of Contents (TOC) Anchors
 
@@ -132,12 +125,12 @@ _Common pitfall: Updating the clone URL in README but leaving an old one in FAQ.
 ### C. Statistics Consistency (CRITICAL)
 
 If you add/remove skills, you **MUST** ensure the total count is identical in ALL locations.
-**Do not allow drift** (e.g., 356 in title, 354 in header).
+**Do not allow drift** (e.g., 560 in title, 558 in header).
 
 Locations to check:
 
-1.  **Title of `README.md`**: "356+ Agentic Skills..."
-2.  **`## Full Skill Registry (356/356)` header**.
+1.  **Title of `README.md`**: "560+ Agentic Skills..."
+2.  **`## Full Skill Registry (560/560)` header**.
 3.  **`docs/GETTING_STARTED.md` intro**.
 
 ### D. Credits Policy (Who goes where?)
@@ -166,7 +159,7 @@ Reject any PR that fails this:
 4.  **Examples**: Copy-pasteable code blocks?
 5.  **Actions**: "Run this command" vs "Think about this".
 
-### B. Risk Labels (V3)
+### B. Risk Labels (V4)
 
 - ⚪ **Safe**: Default.
 - 🔴 **Risk**: Destructive/Security tools. MUST have `[Authorized Use Only]` warning.
@@ -183,8 +176,8 @@ When cutting a new version (e.g., V4):
 3.  **Bump Version**: Update header in `README.md`.
 4.  **Tag Release**:
     ```bash
-    git tag -a v3.0.0 -m "V3 Enterprise Edition"
-    git push origin v3.0.0
+    git tag -a v4.0.0 -m "V4 Enterprise Edition"
+    git push origin v4.0.0
     ```
 
 ### 📋 Release Note Template

.github/workflows/ci.yml

@@ -37,6 +37,17 @@ jobs:
         run: |
           python3 scripts/update_readme.py
 
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "lts/*"
+
+      - name: Install npm dependencies
+        run: npm install
+
+      - name: 📦 Build catalog
+        run: npm run catalog
+
       - name: Set up GitHub credentials (for auto-sync)
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
         run: |
@@ -47,12 +58,12 @@ jobs:
       - name: Auto-commit registry drift (main only)
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
         run: |
-          # Se non ci sono cambi, esci senza errore
+          # If no changes, exit successfully
           git diff --quiet && exit 0
 
-          git add README.md skills_index.json || true
+          git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md || true
 
-          # Se non c'è niente da committare, esci senza errore
+          # If nothing to commit, exit successfully
           git diff --cached --quiet && exit 0
 
           git commit -m "chore: sync generated registry files [ci skip]"
@@ -61,13 +72,12 @@ jobs:
       - name: 🚨 Check for Uncommitted Drift
         run: |
           if ! git diff --quiet; then
-            echo "❌ Detected uncommitted changes produced by registry/readme scripts."
+            echo "❌ Detected uncommitted changes produced by registry/readme/catalog scripts."
             echo
             echo "To fix locally, run the FULL Validation Chain, then commit and push:"
-            echo "  python3 scripts/validate_skills.py"
-            echo "  python3 scripts/generate_index.py"
-            echo "  python3 scripts/update_readme.py"
-            echo "  git add README.md skills_index.json"
+            echo "  npm run chain"
+            echo "  npm run catalog"
+            echo "  git add README.md skills_index.json data/catalog.json data/bundles.json data/aliases.json CATALOG.md"
             echo "  git commit -m \"chore: sync generated registry files\""
             echo "  git push"
             exit 1