humanizer-lint 0.2.4 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -18
- package/SKILL.md +132 -116
- package/package.json +24 -3
package/README.md
CHANGED
|
@@ -9,18 +9,44 @@ Detect repetitive LLM phrasing, uniform sentence rhythm, structural clichés, an
|
|
|
9
9
|
[](https://github.com/yanstd888/humanizer-lint/releases)
|
|
10
10
|
[](https://www.npmjs.com/package/humanizer-lint)
|
|
11
11
|
[](https://github.com/yanstd888/humanizer-lint/actions/workflows/ci.yml)
|
|
12
|
+
[](package.json)
|
|
13
|
+
[](https://www.skills.sh/yanstd888/humanizer-lint/humanizer-lint/security/snyk)
|
|
14
|
+
[](https://www.skills.sh/yanstd888/humanizer-lint/humanizer-lint/security/socket)
|
|
15
|
+
[](https://www.skills.sh/yanstd888/humanizer-lint/humanizer-lint/security/agent-trust-hub)
|
|
16
|
+
[](https://humanizer.aiclub.ai.id/)
|
|
12
17
|
[](LICENSE)
|
|
13
18
|
[](https://nodejs.org/)
|
|
14
|
-
[](https://skills.sh/yanstd888/humanizer-lint)
|
|
19
|
+
[](https://www.skills.sh/yanstd888/humanizer-lint/humanizer-lint)
|
|
15
20
|
[](https://github.com/yanstd888/humanizer-lint/stargazers)
|
|
16
21
|
|
|
17
|
-
[What it does](#what-it-does) | [Install](#install) | [Quick start](#quick-start) | [CLI reference](#cli-reference) | [Detectors](#detectors-and-violation-types) | [Agent skill](#use-as-an-agent-skill) | [FAQ](#frequently-asked-questions)
|
|
22
|
+
[What it does](#what-it-does) | [Try in your browser](#try-in-your-browser) | [Install](#install) | [Quick start](#quick-start) | [CLI reference](#cli-reference) | [Detectors](#detectors-and-violation-types) | [Agent skill](#use-as-an-agent-skill) | [FAQ](#frequently-asked-questions)
|
|
18
23
|
|
|
19
24
|
</div>
|
|
20
25
|
|
|
21
26
|
**humanizer-lint is an open-source natural-text and Markdown prose linter that deterministically identifies style patterns often associated with AI-generated writing in Indonesian and English; it is a style validator, not an authorship detector.**
|
|
22
27
|
|
|
23
|
-
|
|
28
|
+
```sh
|
|
29
|
+
npx skills add yanstd888/humanizer-lint
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Use the command above to install the agent skill. For one-off local linting, run the published `humanizer-lint` CLI below.
|
|
33
|
+
|
|
34
|
+
## Try in your browser
|
|
35
|
+
|
|
36
|
+
Use the official demo: [humanizer.aiclub.ai.id](https://humanizer.aiclub.ai.id).
|
|
37
|
+
|
|
38
|
+
[humanizer-lint.pages.dev](https://humanizer-lint.pages.dev) remains available as a mirror.
|
|
39
|
+
|
|
40
|
+
Open a deterministic sample view directly:
|
|
41
|
+
|
|
42
|
+
| Sample | URL | Expected result |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| AI sample (ID) | [open](https://humanizer.aiclub.ai.id/?sample=ai-id) | `FAIL`, score `< 65` |
|
|
45
|
+
| Human sample (ID) | [open](https://humanizer.aiclub.ai.id/?sample=human-id) | `PASS`, score `>= 88` |
|
|
46
|
+
| AI sample (EN) | [open](https://humanizer.aiclub.ai.id/?sample=ai-en) | `FAIL`, score `< 65` |
|
|
47
|
+
| Human sample (EN) | [open](https://humanizer.aiclub.ai.id/?sample=human-en) | `PASS`, score `>= 88` |
|
|
48
|
+
|
|
49
|
+
Use `?lang=en` or `?lang=id` to open the playground chrome in a chosen language for that visit; it does not overwrite a saved browser preference.
|
|
24
50
|
|
|
25
51
|
It works locally with zero runtime dependencies. Instead of rewriting text through another language model, it reports paragraph- and sentence-level violations with specific correction instructions. Use it to lint LLM-generated documentation, remove robotic AI phrasing from Markdown, check burstiness and lexical diversity, or add a deterministic prose gate to an agent workflow.
|
|
26
52
|
|
|
@@ -105,20 +131,21 @@ Language: en
|
|
|
105
131
|
|
|
106
132
|
and exits with code `0`.
|
|
107
133
|
|
|
108
|
-
##
|
|
134
|
+
## Static `SKILL.md` Humanizers vs. `humanizer-lint` (Closed-Loop CLI)
|
|
109
135
|
|
|
110
|
-
|
|
136
|
+
A static writing prompt can ask a model to vary prose, but it cannot verify the finished draft. `humanizer-lint` takes the smaller, deterministic approach: inspect the exact text after drafting, make only flagged revisions, then check again locally.
|
|
111
137
|
|
|
112
|
-
| Capability |
|
|
113
|
-
|
|
114
|
-
|
|
|
115
|
-
| Measures sentence rhythm |
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
138
|
+
| Capability | Static `SKILL.md` humanizer prompt | `humanizer-lint` closed-loop CLI |
|
|
139
|
+
|---|---|---|
|
|
140
|
+
| Checks the completed draft | No | Yes, exact input is measured |
|
|
141
|
+
| Measures sentence rhythm | Prompt guidance only | CV, adjacent delta, short/long distribution |
|
|
142
|
+
| Measures vocabulary repetition | Prompt guidance only | Adaptive MATTR and repetition checks |
|
|
143
|
+
| Flags configured AI clichés | Model-dependent | Rule IDs and locations |
|
|
144
|
+
| Preserves source text | Depends on rewrite | Yes, analysis only |
|
|
145
|
+
| Runs offline after installation | Depends on agent/model | Yes |
|
|
146
|
+
| Supports EN and ID lexical rules | Prompt-dependent | Yes |
|
|
147
|
+
| Produces JSON and exit codes | Usually no | Yes |
|
|
148
|
+
| Proves human authorship | No | No |
|
|
122
149
|
|
|
123
150
|
If you are looking for an AI writing detector linter, a ChatGPT tone remover CLI, or an open-source alternative to AI humanizers, note the boundary: this tool detects configured style signals and rhythm problems. It does not claim to determine whether a human or model wrote the text.
|
|
124
151
|
|
|
@@ -143,7 +170,7 @@ npm install -g humanizer-lint
|
|
|
143
170
|
The recommended installation for coding agents is through the skills CLI:
|
|
144
171
|
|
|
145
172
|
```sh
|
|
146
|
-
npx skills add yanstd888/humanizer-lint
|
|
173
|
+
npx skills add yanstd888/humanizer-lint
|
|
147
174
|
```
|
|
148
175
|
|
|
149
176
|
The public listing, installation command, and install count are available on [skills.sh](https://skills.sh/yanstd888/humanizer-lint).
|
|
@@ -394,7 +421,7 @@ The skill is indexed on skills.sh and its current listing passes the platform's
|
|
|
394
421
|
|
|
395
422
|
The skills.sh badge at the top of this README is the public source for anonymous installation activity. GitHub's native `Used by` sidebar is generated automatically from its dependency graph; repository owners cannot set that count manually.
|
|
396
423
|
|
|
397
|
-
Because the CLI is
|
|
424
|
+
Because the CLI is published on npm, npm downloads and downstream package manifests are the relevant distribution signals. The skills.sh listing separately represents agent-skill installation activity.
|
|
398
425
|
|
|
399
426
|
## CI and repository automation
|
|
400
427
|
|
|
@@ -460,7 +487,7 @@ It can identify the exact paragraph or sentence that matches a configured phrase
|
|
|
460
487
|
<details>
|
|
461
488
|
<summary><strong>Can I install it from npm?</strong></summary>
|
|
462
489
|
|
|
463
|
-
|
|
490
|
+
Yes. Run `npx humanizer-lint --file draft.md --lang auto` for a one-off command, or install it globally with `npm install -g humanizer-lint`. Install the agent skill separately with `npx skills add yanstd888/humanizer-lint`.
|
|
464
491
|
|
|
465
492
|
</details>
|
|
466
493
|
|
package/SKILL.md
CHANGED
|
@@ -1,116 +1,132 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: humanizer-lint
|
|
3
|
-
description:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
Completion criterion:
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
|
|
116
|
-
|
|
1
|
+
---
|
|
2
|
+
name: humanizer-lint
|
|
3
|
+
description: Deterministic AI text humanizer, anti-slop prose linter, and stylometric analyzer (EN/ID). Fixes uniform sentence rhythm, low burstiness (CV), MATTR vocabulary repetition, and LLM clichés using a local zero-dependency Node.js CLI validator.
|
|
4
|
+
version: 1.1.0
|
|
5
|
+
license: MIT
|
|
6
|
+
compatibility: Node.js >= 18.3.0 (zero external dependencies)
|
|
7
|
+
allowed-tools: Bash(node:*) Read Write
|
|
8
|
+
metadata:
|
|
9
|
+
version: "1.1.0"
|
|
10
|
+
author: "yanstd888"
|
|
11
|
+
domain: "writing"
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# Humanizer Lint
|
|
15
|
+
|
|
16
|
+
Use this skill when writing or revising Indonesian or English prose that must avoid uniform agent rhythm, repeated stock phrases, and excessive translation-style structure. The local analyzer is mandatory. It uses only Node.js built-ins and sends no text over the network.
|
|
17
|
+
|
|
18
|
+
## When to use
|
|
19
|
+
|
|
20
|
+
- Humanize an agent-generated draft in Indonesian or English.
|
|
21
|
+
- Check prose for uniform sentence rhythm and repeated lexical templates.
|
|
22
|
+
- Match a user voice profile generated from writing samples.
|
|
23
|
+
- Verify edited prose before returning it.
|
|
24
|
+
|
|
25
|
+
Do not use it to alter code, commands, structured data, quotations, legal language, or factual identifiers. The sanitizer excludes common Markdown structures, but the agent must still preserve meaning and supported facts.
|
|
26
|
+
|
|
27
|
+
## Trigger Intents & Search Keywords
|
|
28
|
+
|
|
29
|
+
Use this skill for requests such as:
|
|
30
|
+
|
|
31
|
+
- "humanize AI text"
|
|
32
|
+
- "remove AI slop and clichés"
|
|
33
|
+
- "bypass robotic writing patterns"
|
|
34
|
+
- "increase sentence burstiness and perplexity"
|
|
35
|
+
- "lint markdown documentation prose"
|
|
36
|
+
- "humanizer bahasa Indonesia"
|
|
37
|
+
- "perbaiki tulisan AI yang kaku"
|
|
38
|
+
- "match author voice profile"
|
|
39
|
+
|
|
40
|
+
These intents apply across Claude Code, Cursor, Windsurf, Cline, Codex, and Gemini CLI when the request needs deterministic EN/ID prose validation rather than an unmeasured rewrite.
|
|
41
|
+
|
|
42
|
+
## Prerequisites
|
|
43
|
+
|
|
44
|
+
- Node.js 18.3 or newer.
|
|
45
|
+
- Resolve this skill's installed directory as `<skill_dir>` at runtime.
|
|
46
|
+
- Optional custom profile: `<skill_dir>/profiles/custom-voice.json`.
|
|
47
|
+
|
|
48
|
+
## Closed-loop protocol
|
|
49
|
+
|
|
50
|
+
### 1. Resolve context
|
|
51
|
+
|
|
52
|
+
1. Resolve `<skill_dir>` from this `SKILL.md`; never assume the current working directory.
|
|
53
|
+
2. Determine `id`, `en`, or `auto` from the requested output.
|
|
54
|
+
3. If `<skill_dir>/profiles/custom-voice.json` exists, pass it with `--profile`. Otherwise use the bundled default profile.
|
|
55
|
+
4. Keep source facts, names, numbers, dates, quotations, citations, and technical terms unchanged unless the user explicitly requests a factual edit.
|
|
56
|
+
|
|
57
|
+
Completion criterion: language, analyzer path, and optional profile path are known before drafting.
|
|
58
|
+
|
|
59
|
+
### 2. Draft with asymmetric rhythm
|
|
60
|
+
|
|
61
|
+
Write the first draft with concrete subjects and verbs. Mix short 2 to 6 word sentences with longer 26 to 38 word sentences where the meaning supports them. Avoid generic introductions and summary paragraphs that merely repeat earlier content.
|
|
62
|
+
|
|
63
|
+
Do not distort meaning to hit a metric. Sentence-length variation must come from legitimate splitting, merging, or reordering of supported material.
|
|
64
|
+
|
|
65
|
+
Completion criterion: the draft preserves every source claim and contains no invented detail.
|
|
66
|
+
|
|
67
|
+
### 3. Run deterministic verification
|
|
68
|
+
|
|
69
|
+
Prefer stdin so the target repository remains clean:
|
|
70
|
+
|
|
71
|
+
```sh
|
|
72
|
+
node <skill_dir>/scripts/analyze.mjs --stdin --lang auto --json
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Pipe the complete draft to stdin. With a custom profile:
|
|
76
|
+
|
|
77
|
+
```sh
|
|
78
|
+
node <skill_dir>/scripts/analyze.mjs --stdin --lang auto --profile <skill_dir>/profiles/custom-voice.json --json
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Never skip this command. Read `status`, `score`, `metrics`, and every item in `violations`.
|
|
82
|
+
|
|
83
|
+
Completion criterion: a parseable JSON report exists for the exact draft being considered.
|
|
84
|
+
|
|
85
|
+
### 4. Correct only flagged prose
|
|
86
|
+
|
|
87
|
+
If `status` is `FAIL`:
|
|
88
|
+
|
|
89
|
+
1. Group overlapping violations by paragraph. Whole-text statistical diagnostics (`LOW_BURSTINESS`, `MISSING_SENTENCE_RANGE`, `LOW_ADJACENT_DELTA`, and `LOW_LEXICAL_DIVERSITY`) identify the global gate when no single sentence is solely responsible.
|
|
90
|
+
2. Edit only the cited sentences or paragraphs, or make the smallest whole-text rhythm correction named by a statistical diagnostic.
|
|
91
|
+
3. Follow each `fixInstruction` without adding or dropping facts.
|
|
92
|
+
4. Run the analyzer again on the complete revised draft.
|
|
93
|
+
5. Stop after three analyzer iterations.
|
|
94
|
+
|
|
95
|
+
If `status` is `SKIP`, statistical stylometry is unavailable. Fix any lexical violations that are still reported, preserve the short form, and state that the statistical gate was skipped because the text is too short.
|
|
96
|
+
|
|
97
|
+
If the third iteration still returns `FAIL`, do not present the draft as verified. Return the remaining diagnostics and ask whether the user wants a broader rewrite.
|
|
98
|
+
|
|
99
|
+
Completion criterion: return prose only after `PASS`, or an explicitly labeled short-text `SKIP` with no unresolved lexical violations.
|
|
100
|
+
|
|
101
|
+
## Analyzer commands
|
|
102
|
+
|
|
103
|
+
```sh
|
|
104
|
+
node <skill_dir>/scripts/analyze.mjs --file draft.md --lang id --json
|
|
105
|
+
node <skill_dir>/scripts/analyze.mjs --file draft.md --lang en
|
|
106
|
+
node <skill_dir>/scripts/analyze.mjs --stdin --lang auto --json
|
|
107
|
+
node <skill_dir>/scripts/fingerprint.mjs --input samples --output <skill_dir>/profiles/custom-voice.json
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Exit codes:
|
|
111
|
+
|
|
112
|
+
- `0`: `PASS` or `SKIP`.
|
|
113
|
+
- `1`: analyzed successfully and returned `FAIL`.
|
|
114
|
+
- `2`: invalid arguments, unreadable input, or malformed profile.
|
|
115
|
+
|
|
116
|
+
## Pitfalls
|
|
117
|
+
|
|
118
|
+
- A high score does not prove human authorship. It proves only that the configured checks passed.
|
|
119
|
+
- Very short text cannot support statistical stylometry.
|
|
120
|
+
- Technical, legal, and intentionally repetitive prose may require a custom profile.
|
|
121
|
+
- Do not rewrite unflagged paragraphs merely to increase the score.
|
|
122
|
+
- Do not treat `voiceProfileDeviation` as an authorship probability; it is a relative distance from the selected profile.
|
|
123
|
+
|
|
124
|
+
## Verification
|
|
125
|
+
|
|
126
|
+
Before returning revised prose:
|
|
127
|
+
|
|
128
|
+
- [ ] Analyzer ran against the final exact text.
|
|
129
|
+
- [ ] Final status is `PASS`, or an honest lexical-clean `SKIP` for short text.
|
|
130
|
+
- [ ] No source fact, identifier, number, quotation, or citation changed unintentionally.
|
|
131
|
+
- [ ] Only flagged prose was revised after the first analyzer pass.
|
|
132
|
+
- [ ] No network service or external package was used.
|
package/package.json
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "humanizer-lint",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "1.1.0",
|
|
4
4
|
"description": "Closed-loop stylometric linter and anti-AI-slop diagnostic engine for Indonesian and English prose",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"engines": {
|
|
7
7
|
"node": ">=18.3.0"
|
|
8
8
|
},
|
|
9
9
|
"bin": {
|
|
10
|
-
"humanizer-lint": "
|
|
11
|
-
"humanizer-fingerprint": "
|
|
10
|
+
"humanizer-lint": "scripts/analyze.mjs",
|
|
11
|
+
"humanizer-fingerprint": "scripts/fingerprint.mjs"
|
|
12
12
|
},
|
|
13
13
|
"files": [
|
|
14
14
|
"SKILL.md",
|
|
@@ -22,5 +22,26 @@
|
|
|
22
22
|
"test": "node --test tests/test-runner.mjs",
|
|
23
23
|
"build:demo": "node demo/build.mjs"
|
|
24
24
|
},
|
|
25
|
+
"homepage": "https://humanizer.aiclub.ai.id",
|
|
26
|
+
"repository": {
|
|
27
|
+
"type": "git",
|
|
28
|
+
"url": "git+https://github.com/yanstd888/humanizer-lint.git"
|
|
29
|
+
},
|
|
30
|
+
"keywords": [
|
|
31
|
+
"skills-sh",
|
|
32
|
+
"agent-skill",
|
|
33
|
+
"ai-humanizer",
|
|
34
|
+
"anti-slop",
|
|
35
|
+
"prose-linter",
|
|
36
|
+
"stylometry",
|
|
37
|
+
"burstiness",
|
|
38
|
+
"mattr",
|
|
39
|
+
"indonesian-nlp",
|
|
40
|
+
"claude-code",
|
|
41
|
+
"cursor-skill",
|
|
42
|
+
"windsurf",
|
|
43
|
+
"codex",
|
|
44
|
+
"gemini-cli"
|
|
45
|
+
],
|
|
25
46
|
"license": "MIT"
|
|
26
47
|
}
|