Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
edithatogo merged 15 commits into from
Mar 14, 2026
Merged

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

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
04a66ef
Align repo with skill-first validation and release flow
Mar 13, 2026
05d7886
Harden skill CI on clean runners
Mar 13, 2026
35c642d
Refresh generated manifests for skill repo docs
Mar 14, 2026
b743d46
Harden skill repo automation and markdown linting
Mar 14, 2026
37297c2
Scope markdown lint to maintained source docs
Mar 14, 2026
46fb30e
Relax README install-matrix enforcement
Mar 14, 2026
50945db
Fix cross-platform skill distribution validation
Mar 14, 2026
bd9c0a2
Make skillshare dry-run best effort in CI
Mar 14, 2026
b5735df
Fix CodeQL regex issue and Windows matrix linting
Mar 14, 2026
9d0bb68
Make Node test runner cross-platform
Mar 14, 2026
8d56bbd
Use PowerShell skillshare installer on Windows
Mar 14, 2026
ac21ba6
Fix Windows skillshare PATH handoff in CI
Mar 14, 2026
82ca66b
Handle Git Bash Windows paths for skillshare
Mar 14, 2026
36be5e6
Address PR review follow-ups
Mar 14, 2026
f44f504
Fix review follow-up regressions
Mar 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agent/skills/humanizer/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: humanizer
adapter_format: Antigravity skill
Expand Down
2 changes: 1 addition & 1 deletion .agent/skills/humanizer/SKILL_PROFESSIONAL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL_PROFESSIONAL.md
adapter_id: humanizer-pro
adapter_format: Antigravity skill
Expand Down
24 changes: 19 additions & 5 deletions .github/workflows/ci.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,15 +12,23 @@ jobs:
steps:
- uses: actions/checkout@v6

- name: Set up Node
uses: actions/setup-node@v6
with:
node-version: "20"

- 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: |
Expand All @@ -29,8 +37,14 @@ jobs:
tar -xzf vale.tar.gz
sudo mv vale /usr/local/bin/vale

- name: Run pre-commit
run: pre-commit run --all-files
- name: Run maintainer validation
run: npm run lint:all && npm run validate

- name: Run tests
- name: Run Node tests
run: npm test

- name: Run Python tests
run: pytest

- name: Verify sync outputs
run: npm run check:sync
Comment on lines +53 to +54
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot Mar 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Avoid date-dependent sync checks in CI

Running npm run check:sync as a hard CI gate is unstable because scripts/sync-adapters.js rewrites adapter_metadata.last_synced from the current date on every sync (new Date().toISOString().split('T')[0]). Once the day changes, a clean checkout appears dirty even when sources are unchanged, so this step can fail unrelated PRs/releases until someone commits regenerated artifacts for that day.

Useful? React with 👍 / 👎.

50 changes: 33 additions & 17 deletions .github/workflows/release.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -23,18 +26,31 @@ jobs:
- name: Install Dependencies
run: npm ci

- name: Create Release Pull Request or Publish to npm
id: changesets
uses: changesets/action@v1
- 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 -R adapters release-artifacts/adapters

- name: Upload release artifacts
uses: actions/upload-artifact@v7
with:
name: humanizer-next-skill-artifacts
path: release-artifacts

- 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: |
release-artifacts/**
21 changes: 17 additions & 4 deletions .github/workflows/self-improvement.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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."
8 changes: 7 additions & 1 deletion .github/workflows/skill-distribution.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ jobs:
- name: Setup Node
uses: actions/setup-node@v6
with:
node-version: '18'
node-version: '20'

- name: Install dependencies
run: npm ci
Expand All @@ -27,9 +27,15 @@ jobs:
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: |
Expand Down
2 changes: 2 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
6 changes: 5 additions & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
adapter_metadata:
skill_name: humanizer
skill_version: 2.3.0
last_synced: 2026-03-04
last_synced: 2026-03-13
source_path: SKILL.md
adapter_id: codex-cli
adapter_format: AGENTS.md
Expand All @@ -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.
Expand All @@ -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

Expand All @@ -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

Expand Down
14 changes: 11 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

Humanizer-next is a forward-maintained fork of [blader/humanizer](https://github.com/blader/humanizer). It removes signs of AI-generated writing from text while preserving meaning, tone, and technical literals.

This repository is the source for an **agent skill**, not a standalone runtime library. The Node tooling here exists to compile, validate, and sync skill artifacts across adapters.

## Installation

### Recommended
Expand All @@ -12,11 +14,11 @@ cd humanizer-next
npm install
```

For tool-specific installation, migration, and update instructions, use [docs/install-matrix.md](docs/install-matrix.md).
This setup is for **maintainers** working on the skill source. For tool-specific installation, migration, and update instructions, use [docs/install-matrix.md](docs/install-matrix.md).

## Usage

### Sync and build (cross-platform)
### Maintain the skill (cross-platform)

The repository uses a modular fragment system to maintain consistency.

Expand All @@ -25,7 +27,7 @@ The repository uses a modular fragment system to maintain consistency.
3. Compile and sync all versions: `npm run sync`
4. Validate adapters and docs: `npm run validate`

This will rebuild `SKILL.md` (Standard) and `SKILL_PROFESSIONAL.md` (Pro) from the `src/` directory and sync them to all adapter files.
This rebuilds `SKILL.md` (Standard) and `SKILL_PROFESSIONAL.md` (Pro) from the `src/` directory and syncs them to all adapter files.

### Variants

Expand Down Expand Up @@ -56,6 +58,12 @@ AI agents (Claude Code, Cursor, Windsurf, etc.) should use [AGENTS.md](AGENTS.md

Use [docs/install-matrix.md](docs/install-matrix.md) as the canonical installation source.

### What this repo is not

- It is not a published npm package.
- It is not intended to be embedded as an application library.
- It is a source-and-distribution repo for prompt/skill artifacts plus maintenance tooling.

### Sync process

When `SKILL.md` is updated, run the sync script to propagate changes to all adapters:
Expand Down
2 changes: 1 addition & 1 deletion adapters/amp/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: amp
adapter_format: Amp skill
Expand Down
2 changes: 1 addition & 1 deletion adapters/antigravity-rules-workflows/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: antigravity-rules-workflows
adapter_format: Antigravity rules/workflows
Expand Down
2 changes: 1 addition & 1 deletion adapters/antigravity-skill/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: antigravity-skill
adapter_format: Antigravity skill
Expand Down
2 changes: 1 addition & 1 deletion adapters/antigravity-skill/SKILL_PROFESSIONAL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL_PROFESSIONAL.md
adapter_id: antigravity-skill-pro
adapter_format: Antigravity skill
Expand Down
2 changes: 1 addition & 1 deletion adapters/claude/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: claude
adapter_format: Claude skill
Expand Down
2 changes: 1 addition & 1 deletion adapters/cline/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: cline
adapter_format: Cline skill
Expand Down
2 changes: 1 addition & 1 deletion adapters/copilot/COPILOT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: copilot
adapter_format: Copilot instructions
Expand Down
2 changes: 1 addition & 1 deletion adapters/gemini-extension/GEMINI.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: gemini-extension
adapter_format: Gemini extension
Expand Down
2 changes: 1 addition & 1 deletion adapters/gemini-extension/GEMINI_PRO.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL_PROFESSIONAL.md
adapter_id: gemini-extension-pro
adapter_format: Gemini extension
Expand Down
2 changes: 1 addition & 1 deletion adapters/kilo/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: kilo
adapter_format: Kilo skill
Expand Down
2 changes: 1 addition & 1 deletion adapters/opencode/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: opencode
adapter_format: OpenCode skill
Expand Down
2 changes: 1 addition & 1 deletion adapters/qwen-cli/QWEN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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-13
source_path: SKILL.md
adapter_id: qwen-cli
adapter_format: Qwen CLI context
Expand Down
Loading
Loading