Files
claude-skills-reference/marketing-skill/content-humanizer/references/voice-techniques.md
Alireza Rezvani 52321c86bc feat: Marketing Division expansion — 7 → 42 skills (#266)
* feat: Skill Authoring Standard + Marketing Expansion plans

SKILL-AUTHORING-STANDARD.md — the DNA of every skill in this repo:
10 universal patterns codified from C-Suite innovations + Corey Haines' marketingskills patterns:

1. Context-First: check domain context, ask only for gaps
2. Practitioner Voice: expert persona, goal-oriented, not textbook
3. Multi-Mode Workflows: build from scratch / optimize existing / situation-specific
4. Related Skills Navigation: when to use, when NOT to, bidirectional
5. Reference Separation: SKILL.md lean (≤10KB), refs deep
6. Proactive Triggers: surface issues without being asked
7. Output Artifacts: request → specific deliverable mapping
8. Quality Loop: self-verify, confidence tagging
9. Communication Standard: bottom line first, structured output
10. Python Tools: stdlib-only, CLI-first, JSON output, sample data

Marketing expansion plans for 40-skill marketing division build.

* feat: marketing foundation — context + ops router + authoring standard

marketing-context/: Foundation skill every marketing skill reads first
  - SKILL.md: 3 modes (auto-draft, guided interview, update)
  - templates/marketing-context-template.md: 14 sections covering
    product, audience, personas, pain points, competitive landscape,
    differentiation, objections, switching dynamics, customer language
    (verbatim), brand voice, style guide, proof points, SEO context, goals
  - scripts/context_validator.py: Scores completeness 0-100, section-by-section

marketing-ops/: Central router for 40-skill marketing ecosystem
  - Full routing matrix: 7 pods + cross-domain routing to 6 skills in
    business-growth, product-team, engineering-team, c-level-advisor
  - Campaign orchestration sequences (launch, content, CRO sprint)
  - Quality gate matching C-Suite standard
  - scripts/campaign_tracker.py: Campaign status tracking with progress,
    overdue detection, pod coverage, blocker identification

SKILL-AUTHORING-STANDARD.md: Universal DNA for all skills
  - 10 patterns: context-first, practitioner voice, multi-mode workflows,
    related skills navigation, reference separation, proactive triggers,
    output artifacts, quality loop, communication standard, python tools
  - Quality checklist for skill completion verification
  - Domain context file mapping for all 5 domains

* feat: import 20 workspace marketing skills + standard sections

Imported 20 marketing skills from OpenClaw workspace into repo:

Content Pod (5):
  content-strategy, copywriting, copy-editing, social-content, marketing-ideas

SEO Pod (2):
  seo-audit (+ references enriched by subagent), programmatic-seo (+ refs)

CRO Pod (5):
  page-cro, form-cro, signup-flow-cro, onboarding-cro, popup-cro, paywall-upgrade-cro

Channels Pod (2):
  email-sequence, paid-ads

Growth + Intel + GTM (5):
  ab-test-setup, competitor-alternatives, marketing-psychology, launch-strategy, brand-guidelines

All 29 skills now have standard sections per SKILL-AUTHORING-STANDARD.md:
   Proactive Triggers (4-5 per skill)
   Output Artifacts table
   Communication standard reference
   Related Skills with WHEN/NOT disambiguation

Subagents enriched 8 skills with additional reference docs:
  seo-audit, programmatic-seo, page-cro, form-cro,
  onboarding-cro, popup-cro, paywall-upgrade-cro, email-sequence

43 files, 10,566 lines added.

* feat: build 13 new marketing skills + social-media-manager upgrade

All skills are 100% original work — inspired by industry best practices,
written from scratch in our own voice following SKILL-AUTHORING-STANDARD.md.

NEW Content Pod (2):
  content-production — full research→draft→optimize pipeline, content_scorer.py
  content-humanizer — AI pattern detection + voice injection, humanizer_scorer.py

NEW SEO Pod (3):
  ai-seo — AI search optimization (AEO/GEO/LLMO), entirely new category
  schema-markup — JSON-LD structured data, schema_validator.py
  site-architecture — URL structure + internal linking, sitemap_analyzer.py

NEW Channels Pod (2):
  cold-email — B2B outreach (distinct from email-sequence lifecycle)
  ad-creative — bulk ad generation + platform specs, ad_copy_validator.py

NEW Growth Pod (3):
  churn-prevention — cancel flows + save offers + dunning, churn_impact_calculator.py
  referral-program — referral + affiliate programs
  free-tool-strategy — engineering as marketing

NEW Intelligence Pod (1):
  analytics-tracking — GA4/GTM setup + event taxonomy, tracking_plan_generator.py

NEW Sales Pod (1):
  pricing-strategy — pricing, packaging, monetization

UPGRADED:
  social-media-analyzer → social-media-manager (strategy, calendar, community)

Totals: 42 skills, 27 Python scripts, 60 reference docs, 163 files, 43,265 lines

* feat: update index, marketplace, README for 42 marketing skills

- skills-index.json: 89 → 124 skills (42 marketing entries)
- marketplace.json: marketing-skills v2.0.0 (42 skills, 27 tools)
- README.md: badge 134 → 169, marketing row updated
- prompt-engineer-toolkit: added YAML frontmatter
- Removed build logs from repo
- Parity check: 42/42 passed (YAML + Related + Proactive + Output + Communication)

* fix: merge content-creator into content-production, split marketing-psychology

Quality audit fixes:

1. content-creator → DEPRECATED redirect
   - Scripts (brand_voice_analyzer.py, seo_optimizer.py) moved to content-production
   - SKILL.md replaced with redirect to content-production + content-strategy
   - Eliminates duplicate routing confusion

2. marketing-psychology → 24KB split to 6.8KB + reference
   - 70+ mental models moved to references/mental-models-catalog.md (397 lines)
   - SKILL.md now lean: categories overview, most-used models, quick reference
   - Saves ~4,300 tokens per invocation

* feat: add plugin configs, Codex/OpenClaw compatibility, ClawHub packaging

- marketing-skill/SKILL.md: ClawHub-compatible root with Quick Start for Claude Code, Codex CLI, OpenClaw
- marketing-skill/CLAUDE.md: Agent instructions (routing, context, anti-patterns)
- marketing-skill/.codex/instructions.md: Codex CLI skill routing
- .claude-plugin/marketplace.json: deduplicated, marketing-skills v2.0.0
- .codex/skills-index.json: content-creator marked deprecated, psychology updated
- Total: 42 skills, 27 Python tools, 60 references, 18 plugins

* feat: add 16 Python tools to knowledge-only skills

Enriched 12 previously tool-less skills with practical Python scripts:
- seo-audit/seo_checker.py — HTML on-page SEO analysis (0-100)
- copywriting/headline_scorer.py — headline quality scoring (0-100)
- copy-editing/readability_scorer.py — Flesch + passive + filler detection
- content-strategy/topic_cluster_mapper.py — keyword clustering
- page-cro/conversion_audit.py — HTML CRO signal analysis (0-100)
- paid-ads/roas_calculator.py — ROAS/CPA/CPL calculator
- email-sequence/sequence_analyzer.py — email sequence scoring (0-100)
- form-cro/form_field_analyzer.py — form field CRO audit (0-100)
- onboarding-cro/activation_funnel_analyzer.py — funnel drop-off analysis
- programmatic-seo/url_pattern_generator.py — URL pattern planning
- ab-test-setup/sample_size_calculator.py — statistical sample sizing
- signup-flow-cro/funnel_drop_analyzer.py — signup funnel analysis
- launch-strategy/launch_readiness_scorer.py — launch checklist scoring
- competitor-alternatives/comparison_matrix_builder.py — feature comparison
- social-media-manager/social_calendar_generator.py — content calendar
- readability_scorer.py — fixed demo mode for non-TTY execution

All 43/43 scripts pass execution. All stdlib-only, zero pip installs.
Total: 42 skills, 43 Python tools, 60+ reference docs.

* feat: add 3 more Python tools + improve 6 existing scripts

New tools from build agent:
- email-sequence/scripts/sequence_analyzer.py — email sequence scoring (91/100 demo)
- paid-ads/scripts/roas_calculator.py — ROAS/CPA/CPL/break-even calculator
- competitor-alternatives/scripts/comparison_matrix_builder.py — feature matrix

Improved scripts (better demo modes, fuller analysis):
- seo_checker.py, headline_scorer.py, readability_scorer.py,
  conversion_audit.py, topic_cluster_mapper.py, launch_readiness_scorer.py

Total: 42 skills, 47 Python tools, all passing.

* fix: remove duplicate scripts from deprecated content-creator

Scripts already live in content-production/scripts/. The content-creator
directory is now a pure redirect (SKILL.md only + legacy assets/refs).

* fix: scope VirusTotal scan to executable files only

Skip scanning .md, .py, .json, .yml — they're plain text files
that VirusTotal can't meaningfully analyze. This prevents 429 rate
limit errors on PRs with many text file changes (like 42 marketing skills).

Scan still covers: .js, .ts, .sh, .mjs, .cjs, .exe, .dll, .so, .bin, .wasm

---------

Co-authored-by: Leo <leo@openclaw.ai>
2026-03-06 03:56:16 +01:00

8.7 KiB

Voice Techniques Reference

Techniques for injecting authentic brand voice into content. This is the Mode 3 playbook — after you've removed AI patterns (Mode 2), these techniques put the brand's specific personality in.


Step 1: Extract the Voice Profile

Before writing anything, extract the voice from examples. Ask for one piece of content the brand considers representative. Then answer these questions about it:

Question What to look for
Average sentence length? Count words per sentence across 10 sentences. ≤15 = punchy. ≥25 = flowing.
Formality level? Count contractions ("it's" vs "it is"). Count first-person. Count slang.
Use of humor? Dry wit (unexpected juxtapositions). Self-deprecating (acknowledges own limitations). Provocateur (picks fights). None.
Relationship to reader? Peer (we're both figuring this out). Expert (I know, you're learning). Challenger (you're probably wrong about this).
Signature phrases? Phrases or constructions that appear more than once. That's the brand's verbal tic.
What do they avoid? Listen for what's conspicuously absent.

Document this as a voice profile before editing. Reference it throughout.


The Core Voice Types

Voice Type 1: The Direct Expert

Profile: Short sentences. Confident claims. No hedging. No qualifications unless the qualification is the point. Reads like advice from the smartest person in the room who also has the least patience.

Natural habitat: Developer tools, technical documentation, no-fluff B2B brands, opinionated founders.

Techniques:

  • Lead every section with the conclusion, not the setup
  • Make claims without softening them: "Most onboarding is broken" not "Many onboarding flows may have room for improvement"
  • Use "you" relentlessly — direct address, always
  • Short paragraphs. Often 1-2 sentences.
  • When listing, use the smallest number of words possible
  • No rhetorical questions unless you're about to immediately answer them
  • Swear if the brand does (a well-placed "this is genuinely terrible" signals authenticity)

Before: "It's important to consider that implementing an effective onboarding strategy can have significant positive impacts on user retention rates."

After: "Fix your onboarding. It's where you're losing them."


Voice Type 2: The Thoughtful Peer

Profile: Longer sentences when the thought requires it. Occasional vulnerability. Shares the thinking, not just the conclusion. Treats the reader as someone at roughly the same level.

Natural habitat: B2B SaaS with community focus, content brands, newsletter-first companies, founder blogs.

Techniques:

  • Show the reasoning: "Here's how I think about this..." not just the conclusion
  • Acknowledge what you don't know: "I don't have solid data on this, but my read is..."
  • Share the mistake before the lesson: "We tried X first and it failed. Here's what we learned."
  • Longer transitions: connect ideas, don't just jump to the next point
  • Questions that earn their keep — rhetorical only when you're genuinely pointing at a tension
  • First person plural ("we") where appropriate — but only if there actually is a "we"

Before: "Companies should invest in customer success to improve retention."

After: "I spent two years thinking retention was a marketing problem. It wasn't. Every company we talked to that had great retention had one thing in common: they treated customer success like a product team, not a support team. The product mindset made all the difference."


Voice Type 3: The Provocateur

Profile: Challenges received wisdom. Takes positions most people avoid. Enjoys being right when everyone else was wrong. Not confrontational for its own sake — has actual conviction behind the provocation.

Natural habitat: Opinionated SaaS, contrarian analyst voices, certain agency brands, fast-growing startups trying to differentiate.

Techniques:

  • Open with the unpopular claim: "Most SEO advice is wrong" not "There are many perspectives on SEO"
  • Name the thing people don't say: "The reason nobody talks about X is because..."
  • Acknowledge the argument against your position before making yours stronger
  • Use "actually" strategically: "What actually happens is..."
  • When everyone agrees on something, be specific about what they're getting wrong
  • Let the evidence land without fanfare — state the uncomfortable number, then wait

Before: "There are various approaches to content marketing that teams may find valuable."

After: "Your competitors' content marketing budgets are wasted. The average B2B blog post gets 300 views and zero conversions. The top 10% of pieces generate 90% of the value. Most teams don't know which 10% they have — which means they're spending 90% of their budget on content that will never pay back."


Voice Type 4: The Enthusiastic Practitioner

Profile: Genuine excitement about the craft. Energized by the detail. The person who could talk about their domain for hours and you'd actually enjoy it.

Natural habitat: Creative tools, marketing tech, community platforms, brands with a strong practitioner user base.

Techniques:

  • Allow enthusiasm to come through without forcing it: "This is the part I love about cohort analysis..."
  • Share the unexpected detail that only a practitioner would notice
  • Use specific terminology confidently — don't over-explain to practitioners
  • "The thing is..." as a transition — signals you're about to share the real insight
  • Parenthetical asides that reveal depth: "(And yes, I know about [edge case] — that's a separate problem)"
  • Let the complexity show when the complexity is interesting

Before: "Segmenting your audience allows for more targeted communication."

After: "Here's where audience segmentation gets genuinely interesting. Most people segment by company size or industry. That's fine. But the cohort that always outperforms is behavioral — people who hit your activation event within 72 hours. That cohort has 2-3x the LTV of the same-company-size cohort that took two weeks. The behavior tells you more than the firmographic ever will."


Specific Techniques Regardless of Voice Type

The Personal Anecdote Injection

Every brand can use a personal anecdote — even B2B technical brands. The format:

Setup: "When we [did X thing in context]..." What happened: "[Specific unexpected thing occurred]." The lesson: "[The principle that explains it]."

The anecdote doesn't have to be dramatic. It just has to be real and specific. "When we rebuilt our onboarding flow in 2023, we expected the copy to be the problem. It was the loading time."

The Honest Admission

Instantly humanizing. Rarely done by brands because it feels like weakness. But readers trust brands that admit:

  • What they got wrong
  • What they don't know
  • What they tried that failed
  • What surprised them

The format: "We thought X. We were wrong. What actually happened was Y."

The Contrarian Setup

Works for any voice type. Setup: state the conventional wisdom. Then undercut it.

"Everyone says [thing]. The data shows [opposite thing]."

Or more subtle: "The conventional wisdom is [X]. That's mostly true. Except when [specific condition] — and that's where it gets interesting."

Sentence Rhythm Signature

After analyzing the brand voice, identify the rhythm pattern and apply it:

  • Staccato brand: Short sentence. Shorter. Done.
  • Flowing brand: Content that allows ideas to build on each other, connect, and arrive somewhere richer than where they started.
  • Mixed cadence (most natural): Long sentence establishing context. Short punch. Then another long one that goes somewhere. Then: done.

Once you know the pattern, apply it consistently throughout the piece.

The Earned Ending

The last sentence of a piece should land. Not summarize. Not encourage. Land.

Techniques:

  • The hard cut: State the core truth one final time, nakedly. No wrap-up.
  • The reversal: Setup expectation, then subvert it in the last line.
  • The action: Name the single most important thing to do next. One thing.
  • The honest admission: "We're still figuring this out too."

Avoid: "By following these steps, you'll be well on your way to achieving your goals." Nobody reads that. Nobody trusts it.


Voice Injection Quality Check

After applying voice:

  • Read the piece aloud — does it sound like a person you'd actually follow?
  • Is every paragraph distinguishable from the others? (Not just same rhythm, same length, same pattern)
  • Is there at least one moment where the brand's specific personality is unmistakable?
  • Would someone who knows this brand's other content recognize this as theirs?
  • Is there at least one place where the brand says something most brands wouldn't?