Align humanizer-next with skill-first validation and release flow

.agent/skills/humanizer/SKILL.md

@@ -20,7 +20,7 @@ allowed-tools:
 adapter_metadata:
   skill_name: humanizer
   skill_version: 2.3.0
-  last_synced: 2026-03-04
+  last_synced: 2026-03-14
   source_path: SKILL.md
   adapter_id: humanizer
   adapter_format: Antigravity skill

.agent/skills/humanizer/SKILL_PROFESSIONAL.md

@@ -19,7 +19,7 @@ allowed-tools:
 adapter_metadata:
   skill_name: humanizer-pro
   skill_version: 2.3.0
-  last_synced: 2026-03-04
+  last_synced: 2026-03-14
   source_path: SKILL_PROFESSIONAL.md
   adapter_id: humanizer-pro
   adapter_format: Antigravity skill

.github/workflows/ci.yml

@@ -12,15 +12,24 @@ jobs:
     steps:
       - uses: actions/checkout@v6
 
+      - name: Set up Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: "20"
+          cache: "npm"
+
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
           python-version: "3.13"
 
-      - name: Install dependencies
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Install Python dependencies
         run: |
           python -m pip install --upgrade pip
-          python -m pip install pytest pytest-cov ruff mypy pre-commit
+          python -m pip install pytest pytest-cov
 
       - name: Install Vale
         run: |
@@ -29,8 +38,17 @@ jobs:
           tar -xzf vale.tar.gz
           sudo mv vale /usr/local/bin/vale
 
-      - name: Run pre-commit
-        run: pre-commit run --all-files
+      - name: Sync generated outputs
+        run: npm run sync
 
-      - name: Run tests
+      - name: Run maintainer validation
+        run: npm run lint:all && npm run validate
+
+      - name: Run Node tests
+        run: npm test
+
+      - name: Run Python tests
         run: pytest
+
+      - name: Verify sync outputs
+        run: npm run check:sync

.github/workflows/release.yml

@@ -2,15 +2,18 @@ name: Release
 
 on:
   push:
-    branches:
-      - main
+    tags:
+      - 'v*'
+  workflow_dispatch:
 
 concurrency: ${{ github.workflow }}-${{ github.ref }}
 
 jobs:
   release:
-    name: Release
+    name: Build skill artifacts
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - name: Checkout Repo
         uses: actions/checkout@v6
@@ -19,22 +22,54 @@ jobs:
         uses: actions/setup-node@v6
         with:
           node-version: '20'
+          cache: 'npm'
 
       - name: Install Dependencies
         run: npm ci
 
-      - name: Create Release Pull Request or Publish to npm
-        id: changesets
-        uses: changesets/action@v1
+      - name: Install Vale
+        run: |
+          VALE_VERSION=3.13.0
+          curl -sSL "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -o vale.tar.gz
+          tar -xzf vale.tar.gz
+          sudo mv vale /usr/local/bin/vale
+
+      - name: Sync generated outputs
+        run: npm run sync
+
+      - name: Build and validate artifacts
+        run: |
+          npm run lint:all
+          npm test
+          npm run validate
+          npm run check:sync
+
+      - name: Package release artifacts
+        run: |
+          mkdir -p release-artifacts
+          cp SKILL.md release-artifacts/
+          cp SKILL_PROFESSIONAL.md release-artifacts/
+          cp README.md release-artifacts/
+          cp AGENTS.md release-artifacts/
+          cp docs/install-matrix.md release-artifacts/
+          cp docs/skill-distribution.md release-artifacts/
+          cp -R adapters release-artifacts/adapters
+          tar -czf humanizer-next-skill-artifacts.tar.gz -C release-artifacts .
+          (cd release-artifacts && zip -r ../humanizer-next-skill-artifacts.zip .)
+
+      - name: Upload release artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: humanizer-next-skill-artifacts
+          path: |
+            release-artifacts
+            humanizer-next-skill-artifacts.tar.gz
+            humanizer-next-skill-artifacts.zip
+
+      - name: Publish GitHub release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v2
         with:
-          # This expects you to have a script called release which does a build for your packages and calls changeset publish
-          publish: npm run release
-          title: Release - Version Packages
-          commit: "chore: release version packages"
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-      - name: Notify on Success
-        if: steps.changesets.outputs.published == 'true'
-        run: echo "Release published successfully!"
+          files: |
+            humanizer-next-skill-artifacts.tar.gz
+            humanizer-next-skill-artifacts.zip

.github/workflows/self-improvement.yml

@@ -42,22 +42,35 @@ jobs:
           echo "AI Pattern Count:" >> metrics-baseline.txt
           grep -c -i "stands as\|testament to\|crucial\|pivotal\|vibrant\|showcasing" SKILL.md SKILL_PROFESSIONAL.md QWEN.md >> metrics-baseline.txt || echo "0" >> metrics-baseline.txt
 
+      - name: Gather repository intelligence
+        run: |
+          node scripts/gather-repo-data.js edithatogo/humanizer-next blader/humanizer
+          node scripts/render-self-improvement-issue.js
+
       - name: Run Validation
         run: |
           npm run validate
           npm test
 
       - name: Upload Baseline Metrics
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: baseline-metrics
           path: metrics-baseline.txt
 
+      - name: Upload self-improvement data
+        uses: actions/upload-artifact@v7
+        with:
+          name: self-improvement-data
+          path: |
+            conductor/tracks/repo-self-improvement_20260303/repo-data.json
+            .github/generated/self-improvement-issue.md
+
       - name: Create Analysis Issue
-        uses: peter-evans/create-issue-from-file@v5
+        uses: peter-evans/create-issue-from-file@v6
         with:
           title: Self-Improvement Cycle $(date +%Y-%m-%d)
-          content-filepath: .github/SELF_IMPROVEMENT_TEMPLATE.md
+          content-filepath: .github/generated/self-improvement-issue.md
           labels: |
             self-improvement
             weekly-cycle
@@ -67,4 +80,4 @@ jobs:
         run: |
           echo "::notice::Self-improvement cycle initiated. See issue created above for detailed analysis tasks."
           echo "::notice::Branch created: self-improvement-$(date +%Y-%m-%d)"
-          echo "::notice::Complete analysis manually following docs/SELF_IMPROVEMENT_WORKFLOW.md"
+          echo "::notice::Generated issue body and repo-data.json are attached as workflow artifacts."

.github/workflows/skill-distribution.yml

@@ -8,28 +8,66 @@ on:
 jobs:
   validate-skill:
     strategy:
+      fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
+      - name: Normalize line endings (Windows)
+        if: runner.os == 'Windows'
+        shell: powershell
+        run: |
+          git config --global core.autocrlf false
+          git config --global core.eol lf
+          git reset --hard HEAD
+
       - name: Setup Node
         uses: actions/setup-node@v6
         with:
-          node-version: '18'
+          node-version: '20'
+          cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
+      - name: Install Vale (Linux)
+        if: runner.os == 'Linux'
+        shell: bash
+        run: |
+          VALE_VERSION=3.13.0
+          curl -sSL "https://github.com/errata-ai/vale/releases/download/v${VALE_VERSION}/vale_${VALE_VERSION}_Linux_64-bit.tar.gz" -o vale.tar.gz
+          tar -xzf vale.tar.gz
+          sudo mv vale /usr/local/bin/vale
+
+      - name: Install Vale (macOS)
+        if: runner.os == 'macOS'
+        shell: bash
+        run: brew install vale
+
+      - name: Install Vale (Windows)
+        if: runner.os == 'Windows'
+        shell: powershell
+        run: choco install vale --no-progress -y
+
+      - name: Sync generated outputs
+        run: npm run sync
+
       - name: Lint, Typecheck and Format
         run: |
           npm run lint:all
 
+      - name: Validate repository docs and adapters
+        run: npm run validate
+
       - name: Run tests
         run: npm test
 
+      - name: Verify generated outputs are committed
+        run: npm run check:sync
+
       - name: Run skill validation script
         shell: bash
         run: |

.gitignore

@@ -22,6 +22,8 @@ hist.html
 page_raw.txt
 talk_headings.txt
 talk_raw.txt
+conductor/tracks/*/repo-data.json
+.github/generated/
 
 # Test and debug files
 simple_test.js

AGENTS.md

@@ -2,7 +2,7 @@
 adapter_metadata:
   skill_name: humanizer
   skill_version: 2.3.0
-  last_synced: 2026-03-04
+  last_synced: 2026-03-14
   source_path: SKILL.md
   adapter_id: codex-cli
   adapter_format: AGENTS.md
@@ -12,6 +12,8 @@ adapter_metadata:
 
 This repository defines the **Humanizer** coding skill, designed to remove AI-generated patterns and improve prose quality.
 
+This is a **skill source repository**. Treat the Node/Python configuration here as maintenance tooling for compiling, validating, and distributing skill artifacts rather than as a standalone software product.
+
 ## Capability
 
 The Humanizer skill provides a set of 25 patterns for identifying and rewriting "AI-slop" or sterile writing. It preserves technical literals (code blocks, URLs, identifiers) while injecting personality and human-like voice.
@@ -37,6 +39,7 @@ This file serves as the **Agents.md** standard manifest for this repository. It
   - Tool-specific implementations (VS Code, Qwen, Copilot, Antigravity, etc.).
 - `scripts/`
   - Automation for syncing fragments to these files.
+  - Maintenance/build scripts for artifact generation, not user-facing runtime code.
 
 ### Core instructions
 
@@ -61,6 +64,7 @@ npm run sync
 
 - `SKILL.md` has a `version:` field in its YAML frontmatter.
 - **Rule:** If you bump the version, you must update the source in `src/` and run `npm run sync`.
+- `package.json` is only for repo tooling. Do not treat this repository as an npm package to publish or consume.
 
 ## Interoperability