structural-humanizer

Rewrites discourse-level structure of AI-generated text to remove detectable narrative patterns.

283|23|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/NulightJens/humanizer-stack --skill structural-humanizer-nulightjens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: structural-humanizer
Source: https://github.com/NulightJens/humanizer-stack/tree/main/skills/structural-humanizer
Command: npx skills add https://github.com/NulightJens/humanizer-stack --skill structural-humanizer-nulightjens

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Surface-level editing (fixing words, punctuation, and phrasing) leaves the structural fingerprint of AI writing intact: stated lessons, tidy single-track arcs, embodied-emotion clichés, vague allusions, and uniform shapes across pieces. Research cited in this Skill shows narrative structure alone detects AI text at 93.2% F1, while professional stylistic rewriting moved detection only 1.6 points. ## Core Features & Use Cases - Six structural audits: theme explicitness, structural tidiness, emotion mode, reference specificity, reader engagement, and shape convergence, each run one at a time against an extracted outline of the piece. - Deterministic scanner: scripts/structural_scan.py flags grep-able tells (embodied emotion, stated-lesson markers, tidy closers, vague allusions) with JSON output and a --strict mode for hooks. - Genre calibration and intervention menu: references/genre-calibration.md maps which audits apply to LinkedIn posts, course lessons, blog posts, and emails, and a rotating intervention menu prevents replacing one AI default with another. - Use Case: After running a surface humanizer pass on a LinkedIn post draft, extract its skeleton, run the six audits, pick one intervention (e.g., cut the restated takeaway and end on the number), then verify with python3 scripts/structural_scan.py draft.md. ## Quick Start Ask the AI to run the structural-humanizer pass on your draft, for example: "Run the structural pass on this blog post and remove the AI structural tells."

Frequently Asked Questions about structural-humanizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove AI writing tells from a blog post?

Run two passes in order: a surface pass for vocabulary and punctuation, then this structural pass. Extract the piece's skeleton, run the six audits one at a time, apply 1-2 structural interventions, and verify with the structural_scan.py script.

What is the difference between surface and structural humanizing?

Surface humanizing fixes words and phrasing like em dashes and rule of three. Structural humanizing fixes discourse patterns like stated lessons, linear tidy arcs, and embodied emotion, which research shows are the durable AI fingerprint that survives stylistic rewriting.

How do I scan text for structural AI tells with a script?

Run `python3 scripts/structural_scan.py <file>` to flag embodied emotion, stated-lesson markers, tidy closers, and vague allusions. Use `--json` for machine-readable output or `--strict` to exit with code 1 when any category exceeds its threshold, suitable for hooks.

Does this skill work for short content like LinkedIn posts?

Yes, but with calibration. Under roughly 400 words, focus on audits 1 (theme), 3 (emotion mode), 4 (specificity), and 6 (shape convergence); structural moves like tangents and time jumps need more room. The genre-calibration reference details per-genre rules.

What are the limitations of structural AI detection removal?

The underlying StoryScope study used ~5,000-word fiction, so transfer to short nonfiction is an inference. The skill also does not fix vocabulary, impose a voice, or make text undetectable; it only reduces structural tells through deliberate, varied rewrites.