human-first-writer Β· diff
v1.1.0 to v2.0.0
43 added, 118 removed. Audit A to A.
---
name: human-first-writer
- description: "Use when the user asks to write natural, human-first, high-converting SEO content, articles, service pages, or local landing pages that completely eliminate AI slop, formulaic rhythms, and synthetic markers. Automatically outputs deliverables into structured markdown (.md) documents with SEO Title, Meta Description, and Focus Keywords. Grounded in Wikipedia's Signs of AI Writing and empirical detection research. Trigger on: write human content, human-first writing, remove AI patterns, natural SEO article, write without sounding like AI, anti-AI slop content."
+ description: "Use when the user asks to write authoritative, evidence-backed, human-first SEO content, articles, service pages, or local landing pages. Grounded in the 30-20-20-15-10-5 Editorial Weighting Model: Research Accuracy (30%), Search Intent (20%), Specificity (20%), Natural Flow (15%), SEO Entities (10%), and Subtle Cleanup (5%). Automatically outputs deliverables into markdown (.md) files with Title, Meta Description, Focus Keyword, and primary source citations. Trigger on: write human content, human-first writing, natural SEO article, write without sounding like AI, evidence-backed content."
metadata:
- version: "1.1.0"
+ version: "2.0.0"
author: "Antigravity AI"
discipline: "content-engineering"
---
- # Human-First Content Writer (Wikipedia-Grounded Anti-Slop System)
-
- A production-grade content writing framework engineered to eliminate machine-learning generation artifacts, predictable syntactic rhythms, and synthetic fluff. Built upon empirical findings from Wikipedia's *Signs of AI Writing* and academic AI detection analysis.
-
- ---
-
- ## π Mandatory File Delivery & Metadata Contract
-
- Whenever writing or drafting content, this skill **MUST**:
- 1. **Write to a Markdown File**: Output the complete, production-ready deliverable into a dedicated `.md` file (e.g., `./content/<keyword-slug>.md` or workspace path) using file creation tools.
- 2. **Include Mandatory Metadata Header**: Prepend every document with structured frontmatter and visual summary:
-
- ```markdown
- ---
- title: "[SEO-Optimized Title | Angle & Scope]"
- meta_description: "[145-160 characters with primary entity, direct value, and practical CTA]"
- focus_keyword: "[Primary Focus Keyword]"
- secondary_keywords: ["[Secondary Keyword 1]", "[Secondary Keyword 2]", "[Entity 3]"]
- search_intent: "Informational | Commercial | Transactional | Navigational"
- word_count: [Target Word Count]
- date: "YYYY-MM-DD"
- file_path: "./content/<keyword-slug>.md"
- ---
-
- # [H1 Title Matching the Target SEO Angle]
-
- **Focus Keyword**: `[Primary Focus Keyword]`
- **Meta Description**: *[145-160 Char Meta Description]*
-
- ---
- ```
-
- ---
-
- ## The 3 Foundations (From Wikipedia Research)
-
- 1. **Probabilistic Assessment Reality**:
- - Detectors measure perplexity and burstiness; they do not possess ground truth.
- - Non-native English and ultra-formal corporate prose trigger false positives; generic paraphrasing produces false negatives.
- - **Core Mandate:** Do not write to "trick" algorithms. Write with high factual density, domain specifics, and varied structural cadence so the content is inherently authentic.
-
- 2. **Wikipedia Field-Guide Anti-Patterns**:
- - Elimination of formulaic triplets ("rule of three" adjective stacks).
- - Elimination of negative parallelism ("not only X, but also Y").
- - Elimination of formulaic em-dash parentheticals.
- - Elimination of ubiquitous AI vocabulary ("delve", "tapestry", "multifaceted", "transformative").
- - Elimination of predictable concluding platitudes ("In conclusion, the future looks bright...").
-
- 3. **Human Perceptual Calibration**:
- - Humans often fail random-chance tests distinguishing machine vs human writing when judging tone alone.
- - Grounded truth lives in **verifiable facts, local operational realities, real constraints, and precise domain mechanics**βelements LLMs cannot synthesize from broad statistical averages.
-
- ---
-
- ## Banned AI Slop Lexicon & Replacements
+ # Human-First Content Writer (The Evidence-First Editorial System)
- | Banned AI Marker | Why It Triggers Detection / Fatigue | Direct Replacement / Fix |
- |---|---|---|
- | `delve / delving` | Statistical over-representation in LLM pre-training | *examine, look at, break down, analyze*, or cut entirely |
- | `tapestry / testament` | Figurative clichΓ© with zero informational value | State the direct relationship or specific timeline |
- | `pivotal / paramount / crucial` | Artificial inflation of importance without proof | Show the financial, operational, or legal consequence |
- | `elevate / transform` | Vague marketing vaporware | State the exact metric or operational outcome |
- | `seamless / effortlessly` | Unrealistic absolute claim; ignores practical trade-offs | Detail the actual integration steps and friction points |
- | `multifaceted / comprehensive` | Generic filler to avoid explaining concrete sub-components | List the actual 2-3 specific elements addressed |
- | `in today's fast-paced world` | Empty introductory placeholder | Start immediately with the core problem, fact, or metric |
- | `not only [X], but also [Y]` | Overused negative parallelism structure | Use two direct independent statements or straightforward conjunctions |
- | `X, Y, and Z` (Adjective triplets) | Symmetrical rule-of-three cadence (e.g. "robust, scalable, and secure") | Keep only the single most accurate adjective, or specify the metric |
- | `β [em dash clause] β` | Punctuation reflex used to mimic conversational sophistication | Use clean periods or natural comma structures |
+ A production-grade editorial system engineered to produce authoritative, high-converting, and genuinely natural content. Rather than relying on rigid mechanical AI evasion, this skill focuses on **empirical verification, verifiable sources, localized operational realities, and natural cadence**.
---
- ## The 6-Layer Human-First Writing Pipeline
+ ## βοΈ The 6-Tier Editorial Priority Framework
```
- [Layer 1: Reality-First Research & Metadata Mapping]
- β
- βΌ
- [Layer 2: Hard Specificity & Evidence Boundaries]
- β
- βΌ
- [Layer 3: Asymmetrical Cadence (Burstiness & Voice)]
- β
- βΌ
- [Layer 4: Strip Synthetic Rhetoric & Tropes]
- β
- βΌ
- [Layer 5: Intent & Entity-Driven SEO (Zero Keyword Stuffing)]
- β
- βΌ
- [Layer 6: Adversarial Self-Audit & .md File Generation]
+ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
+ β 1. Research Accuracy & Citation Integrity (30%) β
+ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
+ β 2. Search Intent & Direct Value (20%) β
+ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
+ β 3. Granular Specificity & Real Mechanisms (20%) β
+ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
+ β 4. Natural Voice & Organic Flow (15%) β
+ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
+ β 5. Technical & Entity-Driven SEO (10%) β
+ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
+ β 6. Subtle AI-Slop Cleanup (5%) β
+ ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
- ### Layer 1: Reality-First Research & Metadata Mapping
- - Map primary focus keyword, search intent, and secondary entities.
- - Prepare frontmatter metadata: SEO Title, Meta Description (145-160 chars), Focus Keyword.
- - Identify concrete domain terms, tools, materials, codes, or regulations.
+ ### 1. Research Accuracy & Citation Integrity (30%) β The Core Anchor
+ - **No Floating Statistics:** Never state a percentage, timeline, or ranking without naming the institution, survey, or source (e.g. Bangladesh Bureau of Statistics, WHO Database, municipal gazettes).
+ - **Nuanced Realism over Absolute Claims:** Replace sweeping absolutes ("100% zero waste", "zero traffic") with actual operational parameters (e.g. "implemented across core municipal wards", "significantly lower peak-hour gridlock along the primary arterial corridor").
+ - **Mandatory Sources Section:** Conclude articles with named public references and methodology notes, NEVER an internal AI audit scorecard.
- ### Layer 2: Hard Specificity & Evidence Boundaries
- - **Anti-Vagueness Rule:** Never state an outcome without the mechanism.
- - *Bad (AI):* "Our team provides comprehensive roofing solutions that withstand extreme weather."
- - *Good (Human-First):* "We install 24-gauge standing seam metal panels with double-lock mechanical seams, rated for 130 mph coastal wind loads under Florida Building Code TAS 125."
+ ### 2. Search Intent Resolution (20%)
+ - Deliver the **Direct Answer Block** in the first 75-100 words. The reader must get their primary answer immediately without introductory throat-clearing.
- ### Layer 3: Asymmetrical Cadence (Burstiness & Natural Rhythm)
- - LLMs default to medium-length sentences with balanced coordinate clauses.
- - **Enforce Rhythm Asymmetry:**
- - One-sentence punchy paragraph.
- - Followed by a detailed 3-sentence breakdown explaining the mechanism.
- - Followed by a fragment or practical note.
- - Vary sentence lengths deliberately: 4 words, 22 words, 11 words, 6 words.
+ ### 3. Granular Specificity & Mechanisms (20%)
+ - Replace vague adjectives with exact materials, tools, official standards, or historical dates.
+ - For local content: Name specific street intersections, wards, regulatory bodies, and regional microclimates.
- ### Layer 4: Strip Synthetic Rhetoric
- - Remove introductory throat-clearing ("When it comes to...", "It is important to remember that...").
- - Cut all repetitive "wrap-up" conclusion summaries. End with immediate next actions, operational caveats, or concrete FAQs.
+ ### 4. Natural Voice & Organic Flow (15%)
+ - Do not artificially ban natural grammar constructs. Writers use em-dashes and compound sentences when rhythm demands it.
+ - Focus on **Burstiness and Voice Variation**: Mix punchy analytical statements with detailed, multi-clause explanations.
- ### Layer 5: Intent & Entity-Driven SEO
- - Satisfy user intent in the first 100 words (the Direct Answer block).
- - Naturally integrate Wikidata/schema entities rather than repeating exact-match keywords.
- - Structure headings (`H2`, `H3`) as clear operational answers, not philosophical questions.
+ ### 5. Entity-Driven SEO (10%)
+ - Prepend the document with Title, Meta Description, Primary Focus Keyword, and LSI entities.
+ - Structure headings (`H2`, `H3`) to match topical search journeys.
- ### Layer 6: Adversarial Self-Audit Pass & File Generation
- Run every draft through the **Wikipedia Signs Audit Checklist**:
- 1. Does any paragraph contain a "not only X, but also Y" sentence? (If yes, rewrite).
- 2. Are there triplet adjective lists? (If yes, reduce to 1 concrete descriptor).
- 3. Are there more than 2 em-dashes across the entire article? (If yes, replace with periods).
- 4. Does the conclusion summarize what was already stated? (If yes, replace with next steps or cut).
- 5. Does every claim have an operational mechanism attached? (If no, add evidence or delete claim).
- 6. **File Delivery Check**: Write the complete markdown deliverable to disk and confirm path to user.
+ ### 6. Subtle AI-Slop Cleanup (5%)
+ - Avoid hollow AI buzzwords (`delve`, `tapestry`, `pivotal`, `paramount`, `elevate`, `seamless`, `in today's fast-paced world`).
+ - Cut empty introductory setup lines and generic "In conclusion" recaps.
---
- ## Operating Command
- When activated, this skill generates the complete deliverable into a `.md` file with Title, Meta Description, and Focus Keywords, presents the content to the user, and confirms zero AI-slop violations.
+ ## π Deliverable Output Contract
+
+ Every content generation MUST:
+ 1. Deliver the final copy into a dedicated `.md` file in the project workspace.
+ 2. Include the metadata frontmatter at the top (Title, Meta, Focus Keyword).
+ 3. Conclude with a verified **Sources & References** section.
+ 4. **NEVER** append internal AI-validation tables or robotic checklists to the public article.