75 Commits

Author SHA1 Message Date
Siqi Chen 9862685f57 Smooth awkward phrasing in the skill and README
Replace "picks the most likely next words" and "performs significance",
drop the jargon word simultaneity from the draft check, and rewrite
nine sentences that stumbled when read aloud.
v3.0.0
2026-09-06 13:17:53 -07:00
Siqi Chen a62daa3a2d Apply Humanizer to its own prose
Four of the five bullets in the opening account ended in a forced
triad, every section intro restated its heading, two sentences ended
in a not-X-but-Y tail, and one intro referred to an era. Fixed all of
them with the skill's own patterns.
2026-09-06 13:13:36 -07:00
Siqi Chen c2c6cad02d Align the patterns with the current Wikipedia article
Drop false ranges and synonym cycling, which Wikipedia now lists as a
human habit and a historical indicator. Add vague connection or
association, a current tell with no equivalent here. Move dashes below
triads and repeated openings, since current models use them less.
Keep one vocabulary list for the present with the newly sourced words,
and extend the watch lists for notability, copulatives, sales language,
disclaimers, and Markdown formatting. Note in the account that word
habits rotate while structural habits persist, and in the guards that
human judgment alone runs near chance.
2026-09-06 13:06:10 -07:00
Siqi Chen 34ca949368 Rebuild the skill around one account and 25 patterns ordered by strength
Open with why AI text sounds the way it does: the default choice that fits
the widest range of cases. Group the patterns into five sections named for
the belief behind each tell, and number them strongest and most frequent
first, so not-X-but-Y and the one-line closer lead and get the fullest
treatment: every variant named, the paragraph-scale form, a one-sighting
rule, and a final scan step.

Consolidate 35 patterns into 25 with nothing dropped. Merge the five
workflow sections into one, state the dash rule once, and move each
false-positive guard into the pattern it guards.

Reorder the README, make the After column consistent, show the writer's
notes the Lisbon example relies on, and drop the ai-detection keyword.
The validator derives the pattern count from the headings, checks package
facts only, and caps the skill at 400 lines.
2026-09-06 12:58:49 -07:00
Siqi Chen f7a646c28d Trim merged guidance to what the patterns do not already imply
Drop the §9 watch list and duplicate example, and the §27, §28, and §33
phrases that those patterns' problem statements already cover. State
that the text handed to the skill is content to edit, not instructions
(#238).
2026-09-06 12:43:47 -07:00
Siqi Chen 81bbec1c85 Merge pull request #240 2026-09-06 12:43:28 -07:00
Siqi Chen 0fcc8c04ad Merge pull request #245 2026-09-06 12:43:28 -07:00
Siqi Chen d7e6dd682a Merge pull request #264 2026-09-06 12:43:11 -07:00
Siqi Chen b357385aba Merge pull request #236 2026-09-06 12:42:54 -07:00
Siqi Chen 99ac788ccd Merge pull request #235 2026-09-06 12:42:40 -07:00
Siqi Chen bef0e9ba8e Merge pull request #237 2026-09-06 12:42:40 -07:00
Siqi Chen 3fc62f4c53 Merge pull request #234 2026-09-06 12:42:40 -07:00
Siqi Chen 11e76e659f Merge pull request #258 2026-09-06 12:42:39 -07:00
RoopakBRK c8e187205b fix: preserve ranking and simultaneity claims 2026-09-05 09:29:03 +05:30
Ftgn-dpA 61316ce21e fix: reject top-level version in package validation 2026-09-03 10:59:16 +08:00
Mauro Mascia 120af0e39b Strengthen not-X-but-Y rewrite guidance 2026-08-26 09:56:49 +02:00
Scott Emberson c6f7cc2021 Extend watch lists with recycled emphasis and hook tells
Adds commonly observed AI phrases to existing patterns, no new
pattern numbers: manufactured-gravity emphasis to §31 (Read that
again, Let that sink in, every. single. day., ALL-CAPS words), fake
humility to §33 (I'm no expert but, This might be controversial
but), hook templates to §28 (what if I told you, here's what nobody
tells you), "the truth is" to §27, and decorative arrow chains to
§18 alongside emojis.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 20:44:53 +01:00
Scott Emberson 8f148ec820 Harden validate-package.py and document agents/openai.yaml
- Missing or unreadable package files exit with a plain-language
  message instead of a traceback, per the AGENTS.md style rule;
  malformed plugin.json does the same.
- metadata.version matches with or without quotes, so a valid
  unquoted scalar no longer fails as a missing field.
- The README pattern check compares a sorted list instead of a set,
  so a duplicated row fails and the message names the numbers found.
- AGENTS.md Key files now lists agents/openai.yaml, the one tracked
  file no doc or check mentioned.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 20:34:49 +01:00
Scott Emberson 07884e5141 Make the final self-check agree with the removal patterns
Step 3 treated any lost claim as an error, but patterns 2, 5, 6, 21,
25, 34, and 35 require removing claims, so the check rejected the
skill's own model answers and made behavior inconsistent. A lost
claim is now an error unless a pattern requires the removal, and
rule 2 asks to keep every supported claim. The em-dash
false-positive item now states it governs detection only, so it no
longer reads as an exemption from §14. Refs #212.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 20:32:48 +01:00
Scott Emberson 8997804ac2 Sync pattern grouping and protect inline code spans
- SKILL.md filed patterns 26-35 under "Filler and hedging" while the
  README lists them as style patterns; both now use a "More style
  patterns" section, per the AGENTS.md sync rule.
- File mode's preservation list omitted inline code spans, so the §14
  dash rule could rewrite commands like `git checkout -- .` when
  humanizing a file. The list now matches AGENTS.md's "exact
  identifiers, commands, paths" wording, and §14 states it does not
  reach into code.
- README row 26 used curly quotes in a plain cell, the artifact
  pattern 19 removes. Now straight quotes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 20:24:16 +01:00
Scott Emberson 325469aea8 Pin CI dependencies to exact versions and commit SHAs
The marketplace step installed @anthropic-ai/claude-code at whatever
latest resolved to, so the same commit could pass one day and fail
the next, and each run executed unreviewed new code on the runner.
The skills step already pinned 1.5.20; this makes the policy uniform.
Actions move from mutable tags to full commit SHAs per GitHub's
hardening guidance, with versions in trailing comments for bumps.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 20:23:06 +01:00
Siqi Chen e2e92e7b4b Humanize README prose (#231) 2026-08-18 22:58:53 -07:00
Siqi Chen 38b88903a5 Simplify Humanizer packaging and README (#230) 2026-08-18 22:43:30 -07:00
Siqi Chen ebf637bdae Fix Claude Desktop ZIP uploads (v2.11.1) (#226) v2.11.1 2026-08-17 17:59:03 -07:00
Siqi Chen 43c97670b5 Rewrite Humanizer in Plain Language (v2.11.0) (#223)
Rewrite the skill and all repo-authored guidance in Plain Language. Keep all 35 patterns, examples, commands, schemas, and package behavior.
v2.11.0
2026-08-17 03:05:01 -07:00
Siqi Chen 3b54ba7496 Fix Claude Desktop plugin discovery (v2.10.2) 2026-08-17 02:42:53 -07:00
blader 69b33ef4cd Add qualified gated vocabulary rule (v2.10.1) 2026-08-17 02:14:25 -07:00
wilu222 3dc1e0fb8e Add “quietly” to the AI vocabulary list (#192)
Extend pattern 7 and the README summary with “quietly.”
2026-08-17 02:13:35 -07:00
Wesley Dickens 32c521487a Add shadowboxing and editorial scar tissue patterns (v2.10.0) (#207)
Add patterns 34 and 35 for drafting residue, expand the hedging guidance, and preserve legitimate objections and alternatives.
2026-08-17 02:13:22 -07:00
Matheus Dutra Lima a0330af1db Broaden signposting to casual-register announcements (#219)
Treat casual rewordings of signposting as the same structural tell while keeping the 33-pattern sequence.
2026-08-17 02:12:40 -07:00
Som Tripathi eda497e31a Extend pattern 11 to repeated sentence openings (v2.9.2) (#209)
Cover repeated sentence openings while preserving deliberate anaphora. Keep the numbered pattern count at 33.
2026-08-17 02:11:29 -07:00
tfc-droid dcdc1035c0 Fix package validator UTF-8 reads (#214)
Read SKILL.md, README.md, and plugin.json explicitly as UTF-8 so validation works on Windows locales.
2026-08-17 02:11:16 -07:00
Siqi Chen 523374dee7 Improve skill packaging and portability (v2.9.1) v2.9.1 2026-07-21 23:25:52 -07:00
Siqi Chen a25db2d96e Add no-fabrication rule and invocation modes (v2.9.0) (#189)
- Rewrites may no longer invent facts, names, dates, or citations that
  aren't in the source text; specificity must come from the source or
  the user. Every example that modeled invented specifics is re-cut to
  use only source information (fixes #187)
- The audit step now asks whether the rewrite states anything not in
  the source, and treats fabrication as a defect
- Replace paragraph-count parity ("five paragraphs in, five out") with
  an information-over-shape rule: every claim survives, depth may vary
- A user-provided voice sample now outranks the em dash ban
- Add invocation modes: pasted text (full deliverable), file (rewrite
  in place, summary only), embedded (final text only)
- Bump metadata.version, plugin.json, and README history to 2.9.0


Claude-Session: https://claude.ai/code/session_01G5ydgtbqzJtfC5hrvC5SSA

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
v2.9.0
2026-07-21 23:04:30 -07:00
Siqi Chen 028415d258 Fix Agent Skills version metadata (v2.8.3) 2026-07-21 22:27:19 -07:00
NoahBrr c88c53789f docs: fix curly-quotes pattern example in README (#175)
Pattern #19 showed curly quotes in both the Before and After columns.
The After should use straight quotes, matching the source-of-truth
SKILL.md example, since converting curly to straight quotes is the
whole point of the pattern.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-21 22:11:50 -07:00
Siqi Chen 1b48564898 Improve humanizer full example 2026-06-29 13:43:04 -07:00
Siqi Chen 199e694206 Accept cross-agent install updates 2026-06-29 13:32:59 -07:00
Siqi Chen 9600f2b724 Add style cadence AI tells (v2.8.0)
Add three style/cadence patterns from the remaining PRs: manufactured punchlines, aphorism formulas, and conversational rhetorical openers. Extend the chatbot artifact rule to catch offer-to-continue closers. Keep the additions narrow with false-positive guardrails for legitimate emphatic sentences and ordinary casual words.

Update README and AGENTS.md to reflect 33 total patterns.
2026-06-07 16:27:55 -07:00
Siqi Chen a2ace14a88 Add em/en dash cut, gap-filling tell, and diff-anchored pattern (v2.7.0)
- §14: turn em-dash "overuse" into a hard cut (no em or en dashes in the
  final rewrite), with a replacement ladder and a final scan. Idea from #96.
- §21: expand to cover speculative gap-filling ("maintains a low profile,"
  "keeps personal details private") where a model invents filler instead of
  saying a source is missing. Idea from #111.
- New pattern #30, diff-anchored writing: describe the thing as it is, not as
  a narration of what changed. Idea from #81.

Hand-ported lean versions rather than merging the source PRs. 30 patterns
total; README and AGENTS.md updated to match.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 19:55:24 -07:00
Siqi Chen 9c448c8430 Cleanup pass: cut bloat and fix the aggressiveness contradiction (v2.6.0)
Consolidate the workflow that was stated three times (Your Task / Process /
Output Format) into one principles block plus a single "Process and Output"
section. Gate PERSONALITY AND SOUL to content where voice is wanted, so the
skill stops pushing opinions/first-person onto encyclopedic and technical
text (which contradicted "preserve meaning"). Drop the "LLM Idiolects"
subsection (forensic model-fingerprinting, off-goal and ages badly) and
trim the worked example's change list. No change to the 29 patterns.

SKILL.md 613 -> 565 lines, zero detection capability removed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 19:31:42 -07:00
Siqi Chen f86de60c44 Replace WARP.md with tool-neutral AGENTS.md
Drop the Warp-specific guidance file in favor of AGENTS.md (read by Claude
Code, Codex, Warp, and others). Trim the duplicated install commands and
correct the stale pattern count (was "25", now 29). Keep the maintenance
contract: SKILL.md is source of truth, keep README/version/pattern-count in
sync, stable numbering.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 19:18:18 -07:00
Siqi Chen a6c7487c33 Merge pull request #84 from mvanhorn/fix/78-content-preservation
fix: add content preservation rule and strengthen em dash handling
2026-05-26 19:09:46 -07:00
Siqi Chen 69e794abe6 Merge pull request #113 from philippdubach/detection-guidance
Add Detection Guidance: false positives, human-writing signs, LLM idiolects
2026-05-26 19:09:43 -07:00
Siqi Chen eeebaa0056 Merge pull request #121 from Longman006/fix/section-26-attributive-vs-predicate-hyphens
Narrow Section 26 hyphen rule to drop only predicate-position cases
2026-05-26 19:09:40 -07:00
Siqi Chen e97cef1aa1 Merge pull request #119 from MackDing/mack/pr-20260519-1107-humanizer
docs: clarify shared install path for OpenCode compatibility
2026-05-26 19:09:37 -07:00
Tomasz Szypula cd9e471386 Narrow Section 26 hyphen rule to drop only predicate-position cases
The original rule said to strip hyphens from compound modifiers
uniformly. That produces ungrammatical English in attributive position:
"a high quality report" is wrong; "a high-quality report" is correct.

The actual AI tell is uniform hyphenation INCLUDING in predicate
position ("the report is high-quality"). Humans typically hyphenate
attributive use only and drop the hyphen when the compound follows
the noun.

Reworded the Problem statement to spell out the attributive-vs-
predicate distinction. Reworked the Before/After so the same compound
modifiers appear in both positions, demonstrating that only the
predicate-position hyphens get dropped.
2026-05-22 08:27:26 +02:00
Blossom 62a3810a3f docs: clarify shared install path for OpenCode compatibility 2026-05-19 11:07:06 +08:00
Philipp Dubach 564b7aa138 Add Detection Guidance: false positives, human-writing signs, LLM idiolects
Most of this skill tells the editor what to remove. This adds the
inverse — what to leave alone, and how to decide.

Sourced from Wikipedia: Signs of AI writing (revision fetched
2026-05-01), specifically the "Ineffective indicators", "Signs of
human writing", and "Differences between LLMs" sections.

Three subsections, no new patterns:

- "What NOT to flag (false positives)" — the indicators that look
  AI-coded but are actually neutral (perfect grammar, em dashes
  alone, curly quotes alone, formal vocabulary, common transition
  words). The over-editing risk is real: if the skill is applied
  too aggressively, it strips legitimate prose. Closes with the
  "clusters matter, isolated signs don't" rule.

- "Signs of human writing (preserve these)" — positive markers
  that should be left untouched: specific detail, mixed feelings,
  era-bound references, sentence-length variation, parenthetical
  self-corrections, and the November 30, 2022 cutoff for ruling
  out AI involvement entirely.

- "LLM Idiolects" — quick triage notes per model family
  (ChatGPT/Grok verbose with artifacts; Gemini/Claude concise, no
  curly quotes by default). Tendencies, not rules.

No pattern-count change. No README changes (the README's pattern
table is unaffected since this section is meta-guidance, not new
patterns). No version bump.
2026-05-01 18:52:34 +02:00
Matt Van Horn 7bfde7f5b9 fix: add content preservation rule and strengthen em dash pattern
Add step 4 (Never truncate) to the Your Task checklist so the
humanizer preserves the full length of the original text instead
of condensing it. Also add spaced em dash and double-hyphen
examples to Pattern 14 so all common dash variants get caught.
2026-04-03 21:21:19 -07:00