unslop
npx skills add https://github.com/theclaymethod/unslop --skill unslop
Agent 安装分布
Skill 文档
Unslop
Comprehensive skill for humanizing AI-generated content. Two-pass system: diagnosis â reconstruction with validation.
When to Use
Apply this skill when:
- User asks to “humanize” or “de-slop” text
- Editing AI-generated drafts, emails, articles, or social posts
- Text contains obvious AI patterns (throat-clearing, binary contrasts, emphasis crutches)
- User says text “sounds like AI” or “sounds robotic”
- Reviewing content before publishing
- User asks to “make it sound more natural” or “like a human wrote it”
Arguments
| Argument | Description | Default |
|---|---|---|
--preset |
Voice style: crisp, warm, expert, story |
crisp |
--strict |
Fail if rubric score < 32/40 | false |
| Input | Text to transform (argument, file path, or stdin) | required |
Voice Presets
| Preset | Style | Best For |
|---|---|---|
crisp |
Short, direct, no fluff | Technical writing, documentation |
warm |
Friendly, conversational | Emails, blog posts |
expert |
Authoritative, confident | Thought leadership, articles |
story |
Narrative flow, show don’t tell | Case studies, personal posts |
Workflow
Pass 1: Diagnosis
Before rewriting, analyze the input:
-
Read reference materials from this skill’s directory:
references/taboo-phrases.md– banned phrases and patternsreferences/rubric.md– 8 scoring criteriareferences/fact-preservation.md– what must survivereferences/personality-guide.md– voice and personality guidancereferences/edit-library.md– before/after transformation examples
-
Extract constraints (facts that must survive):
python3 <skill-path>/scripts/extract_constraints.py <<< "$INPUT" -
Scan for AI-isms:
python3 <skill-path>/scripts/banned_phrase_scan.py <<< "$INPUT" -
Read the selected preset from
presets/directory -
Identify: audience, content type, tone target
Pass 2: Reconstruction
Rewrite following these rules:
- Eliminate all AI-isms cataloged in taboo-phrases.md
- Replace all em-dashes with periods, commas, or parentheses (zero em-dashes is the target)
- Follow preset voice characteristics
- Preserve all constraints (numbers, names, dates, URLs)
- Apply rubric criteria:
- Directness: No hedging, no throat-clearing
- Natural rhythm: Vary sentence length (8-25 words)
- Concrete verbs: Specific actions, not abstractions
- Reader trust: No over-explaining
- Human authenticity: No performative emphasis
- Content density: Substance over filler
- Fact preservation: All facts intact
- Template avoidance: No AI structural clichés
Pass 3: Validation
After rewriting, validate:
-
Fact preservation:
python3 <skill-path>/scripts/validate_preservation.py original.txt transformed.txt -
Remaining AI-isms:
python3 <skill-path>/scripts/banned_phrase_scan.py <<< "$OUTPUT" -
Readability metrics:
python3 <skill-path>/scripts/readability_metrics.py <<< "$OUTPUT" -
Change percentage (flag if >40%):
python3 <skill-path>/scripts/diff_check.py original.txt transformed.txt -
Score against rubric (8 criteria à 5 points = 40 max)
Output Format
## Transformed Text
[The humanized version]
## Validation
- Constraints: [X]/[Y] preserved
- AI-isms: [N] remaining
- Readability: Grade [X], variance [Y]
- Change: [X]% from original
- Score: [X]/40
## Changes Made
- [List of major transformations]
Quick Examples
Input:
Here’s the thing: building products is hard. Not because the technology is complex. Because people are complex. Let that sink in.
Output (crisp):
Building products is hard. Not the technology. The people.
Input:
In today’s fast-paced business environment, it’s becoming increasingly important for organizations to leverage their core competencies while navigating the complex landscape of digital transformation.
Output (crisp):
Companies need to use their strengths while going digital.
Common AI Patterns to Eliminate
Em-Dash Overuse (HIGH PRIORITY)
Em-dashes are the most reliable AI punctuation tell. Default to zero.
- Replace em-dashes with periods, commas, or parentheses
- Never allow multiple em-dashes per paragraph
- If one is absolutely necessary, max one per several paragraphs
Throat-Clearing Openers
- “Here’s the thing:” / “Here’s why” / “Let’s dive in” / “Let’s unpack”
- “The uncomfortable truth is” / “It’s no secret that”
- “Let me be clear” / “It turns out”
Emphasis Crutches
- “Full stop.” / “Let that sink in.” / “Make no mistake”
- “Buckle up” / “Food for thought” / “It’s a no-brainer”
Binary Contrasts
- “Not because X. Because Y.” â State Y directly
- “X isn’t the problem. Y is.” â “The problem is Y”
Business Jargon
| Avoid | Use |
|---|---|
| Navigate challenges | Handle problems |
| Leverage | Use |
| Deep dive | Analysis |
| Game-changer | (cut or use specific claim) |
| Delve | Explore, examine |
| Garner | Get, earn |
| Utilize | Use |
| Foster | Build, encourage |
| Resonate with | Matters to, connects with |
Significance Inflation
- “stands as a testament to” â state the fact
- “pivotal moment” â be specific about what happened
- “rich tapestry” â never use
- “groundbreaking” â name the specific first
- “speaks volumes” / “sends a clear message” / “raises the bar” â just state the fact
Promotional Language
- “nestled in the heart of” â give the actual address
- “boasts a” â “has a”
- “world-class” / “state-of-the-art” â describe specifically
- “a hidden gem” â cut
- “at the forefront of” â “leading”
Superficial -ing Analyses
- “, highlighting…” / “, showcasing…” / “, underscoring…” â delete or give actual analysis in its own sentence
Communication Artifacts
- “I hope this helps” / “Certainly!” / “Great question!” â cut (chatbot residue)
Filler Setups
- “The key takeaway:” / “The bottom line:” / “It’s clear that” â just state the point
- “At the intersection of” / “In an era of” â cut entirely
- “Pro tip:” / “Hot take:” / “Unpopular opinion:” â cut (meta-commentary)
AI Vocabulary
- delve, garner, interplay, intricate, tapestry, underscore, multifaceted, paramount, burgeoning
- resonates, sheds light, strikes a balance, paints a picture, double-edged sword
See references/taboo-phrases.md for the complete list (~200 phrases across 24 categories).
Scoring Rubric
| Criterion | Points | What It Measures |
|---|---|---|
| Directness | 1-5 | No hedging or softening |
| Natural Rhythm | 1-5 | Sentence length variance |
| Concrete Verbs | 1-5 | Specific actions |
| Reader Trust | 1-5 | No over-explaining |
| Human Authenticity | 1-5 | No performative emphasis |
| Content Density | 1-5 | Substance over filler |
| Fact Preservation | 1-5 | All facts intact |
| Template Avoidance | 1-5 | No AI structures |
Passing score: 32/40 (80%)
Reference Files
Located in this skill’s directory:
| File | Purpose |
|---|---|
references/taboo-phrases.md |
Banned phrases (~150 across 22 categories) |
references/rubric.md |
Detailed scoring criteria |
references/edit-library.md |
24 before/after transformation examples |
references/fact-preservation.md |
Constraint rules |
references/personality-guide.md |
Voice and personality guidance |
presets/*.md |
Voice preset instructions |
scripts/banned_phrase_scan.py |
AI-ism detection (with severity levels) |
scripts/wiki_sync.py |
Wikipedia source page sync |
scripts/*.py |
Other validation scripts |
assets/examples/*.md |
Extended examples by content type |
Maintenance Commands
| Command | Action |
|---|---|
/unslop --add-phrase "phrase" |
Add banned phrase |
/unslop --add-structure "pattern|fix" |
Add structural pattern |
/unslop --list-phrases |
List all banned phrases |
/unslop --list-structures |
List structural patterns |
/unslop --wiki-sync |
Check Wikipedia for new AI patterns and self-update |
Wiki Sync (/unslop --wiki-sync)
This command syncs the skill’s pattern rules with Wikipedia’s Signs of AI writing page. Run it periodically to pick up new patterns added by Wikipedia editors.
Workflow â execute these steps in order:
-
Check for updates:
python3 <skill-path>/scripts/wiki_sync.py checkIf exit code is 0, report “No updates” and stop.
-
Get structured diff:
python3 <skill-path>/scripts/wiki_sync.py diffParse the JSON output. Each change has
type,section,words. -
For each change with new words/phrases, apply updates:
- Read
references/taboo-phrases.mdâ add new phrases to the matching section (use the section mapping in the diff output). Skip phrases that already exist. - Read
scripts/banned_phrase_scan.pyâ add corresponding entries toBANNED_PHRASESdict with appropriatecategory,severity(“hard” for clear AI tells, “soft” for context-dependent), andsuggestion. - If a change warrants a new before/after example, add it to
references/edit-library.md.
- Read
-
Verify:
python3 <skill-path>/scripts/banned_phrase_scan.py < /dev/nullConfirm no syntax errors. Report what was added.
Important: Only add phrases that are genuine AI writing tells applicable to general prose. Skip Wikipedia-specific patterns (broken wikitext, DOI issues, category errors, etc.) that don’t apply outside Wikipedia.
Key Principles
- Diagnosis before writing – Understand violations before fixing
- Facts are sacred – Never sacrifice accuracy for style
- Presets guide, don’t constrain – Adapt to content
- When in doubt, cut – Shorter is almost always better
- Validation is mandatory – Run the scripts