voice-analysis
Extract and document a writer's distinctive voice patterns for consistent reproduction. Use when you need to capture writing voice, analyze writing style, create a voice guide, or write in someone's established style. Keywords: voice, tone, style, writing analysis, fingerprint.
What this skill does
# Voice & Tone Analysis
## Purpose
Extract and document a writer's distinctive voice patterns for consistent reproduction. Creates a "voice guide" that enables authentic writing that sounds like the source, not a generic approximation.
## Core Principle
**Capture spirit, not just mechanics.** The goal is writing that makes the source say "yes, that's me" not "I guess that's accurate."
---
## Phase 1: Sample Collection
### Gather 5-10 Examples from Each Category
**Peak Voice** - Writing they identify as "most them"
**Off-Voice** - Writing that doesn't represent them well
**Different Contexts:**
- Technical/instructional content
- Persuasive/argumentative pieces
- Narrative/storytelling
- Casual communication (emails, messages)
- Formal communication
- Emotional/vulnerable content
### Self-Report Prompts
**Rewrite Exercise:**
Ask: "Rewrite this neutral paragraph in your voice:"
> "The new policy will be implemented next month. It includes several changes to current procedures. Employees should review documentation and submit questions by the deadline."
**Rule Breaking:**
"What writing 'rules' do you consistently ignore? Why?"
**Pet Peeves:**
"What writing choices immediately signal something wasn't written by you?"
**Evolution:**
"How has your writing changed in 5 years? What stayed constant?"
---
## Phase 2: Linguistic Analysis
### Sentence Level
| Pattern | What to Track |
|---------|---------------|
| Average length | Words per sentence |
| Range | Shortest to longest |
| Fragments | Usage frequency, contexts |
| Run-ons | Tendency, intentionality |
| Opening patterns | How sentences typically start |
| Closing patterns | How sentences typically end |
### Paragraph Architecture
| Element | What to Track |
|---------|---------------|
| Average length | Sentences per paragraph |
| Topic sentences | Beginning, middle, end, absent |
| Transitions | Explicit words, implicit flow, abrupt |
| Information order | Build-up, front-load, circular |
### Punctuation Signature
| Mark | Track Usage Pattern |
|------|---------------------|
| Em dash | Interruption, emphasis, list, asides |
| Parentheses | Frequency, content type |
| Semicolon | Presence, absence, alternative |
| Ellipsis | Trailing, pause, omission |
| Exclamation | Frequency, contexts |
| Rhetorical questions | Frequency, function |
---
## Phase 3: Lexical Fingerprinting
### Word Choice Matrix
| Category | Preferred | Avoided | Signature Examples |
|----------|-----------|---------|-------------------|
| Technical terms | | | |
| Colloquialisms | | | |
| Intensifiers | very, extremely, quite... | | |
| Hedging | perhaps, might, seems... | | |
| Abstract/concrete | | | |
### Register Analysis
- [ ] Consistent register (formal/informal throughout)
- [ ] Deliberate register mixing (formal content, casual asides)
- [ ] Context-dependent shifting (formal for X, casual for Y)
### Recurring Constructions
List phrases/patterns appearing 3+ times:
1. ___
2. ___
3. ___
---
## Phase 4: Conceptual DNA
### Metaphor Mapping
| Source Domain | Target Domain | Example | Frequency |
|---------------|---------------|---------|-----------|
| (war, journey, building...) | (ideas, processes...) | | |
### Reference Pool
- **Cultural touchstones:** (movies, books, memes, history...)
- **Time period:** (contemporary, 90s, classic...)
- **Accessibility level:** (mainstream, niche, insider)
- **Domains drawn from:** (sports, cooking, science...)
### Reasoning Patterns
Rate 1-5 for prevalence:
- [ ] Analogical reasoning (like X, therefore Y)
- [ ] First principles (from basics up)
- [ ] Empirical evidence (data, studies)
- [ ] Personal anecdote (I experienced...)
- [ ] Hypotheticals (imagine if...)
- [ ] Socratic questioning (but what if...?)
---
## Phase 5: Emotional Texture
### Enthusiasm Spectrum
| Low | Medium | High |
|-----|--------|------|
| (understated) | (balanced) | (expressive) |
### Criticism Styles
| Style | When Used | Markers |
|-------|-----------|---------|
| Direct | | "This is wrong because..." |
| Diplomatic | | "One consideration might be..." |
| Humorous | | "Well, that's one way to..." |
| Analytical | | "The issue breaks down to..." |
### Vulnerability Patterns
- **Admission phrases:** "I'll admit...", "honestly..."
- **Uncertainty markers:** "I think...", "not sure but..."
- **Personal revelation style:** Direct? Buried in humor? Rare?
---
## Phase 6: Reader Dynamics
### Positioning
The writer positions as:
- [ ] Expert/teacher (I know, let me explain)
- [ ] Peer/collaborator (we're figuring this out together)
- [ ] Student/learner (I'm working through this)
- [ ] Challenger/provocateur (conventional wisdom is wrong)
- [ ] Guide/facilitator (here's how to navigate)
### Assumed Context
- **Shared knowledge level:** Assumes expertise? Explains basics?
- **Cultural assumptions:** In-group references? Universal?
- **Relationship warmth:** Distant professional? Familiar?
### Interactive Patterns
- Questions per 1000 words: ___
- Direct address frequency ("you"): ___
- Imperative usage (commands): ___
- Inclusive language ("we/us"): ___
---
## Phase 7: Voice Guide Synthesis
### Core Voice Statement
_In 2-3 sentences, capture the essence:_
### The Rules That Matter Most
**Always:**
-
**Never:**
-
**Usually, unless:**
-
### Sentence Construction Guide
- **Preferred length:**
- **Variety pattern:**
- **Opening moves:**
- **Power positions:** (where key info lands)
### Word Selection Principles
- **Go-to words for [concept]:**
- **Banned words/phrases:**
- **Register rules:**
### Structural Signatures
- **Paragraph rhythm:**
- **Transition style:**
- **Information architecture:**
### Emotional Register
- **Default tone:**
- **Excitement expression:**
- **Criticism approach:**
- **Vulnerability threshold:**
### The Litmus Test
A piece captures this voice when:
1.
2.
3.
### Red Flags
Definitely NOT this voice when:
1.
2.
3.
---
## Phase 8: Validation
Before finalizing the voice guide:
- [ ] Can identify the author in a blind test?
- [ ] Guided writing feels authentic, not performative?
- [ ] Patterns are descriptive, not prescriptive?
- [ ] Captures spirit, not just mechanics?
- [ ] Source would say "yes, that's me"?
---
## Quick Reference Template
### In Every Piece
-
-
-
### The Heart of the Voice
_[Single paragraph essence]_
### Emergency Voice Recovery
When writing has gone generic, add:
1.
2.
3.
---
## Usage Notes
### For AI Writing
Once the voice guide is complete, include relevant sections in the prompt to guide generation toward authentic voice reproduction.
### For Self-Analysis
Writers can use this framework to understand their own voice, identify what makes their writing distinctive, and consciously apply those patterns.
### For Editing
Use the voice guide as a checklist when editing to ensure consistency and authenticity.
---
## Anti-Patterns
### 1. Mechanics Over Spirit
**Pattern:** Cataloging every linguistic feature without understanding what makes the voice feel distinctive.
**Why it fails:** A perfect inventory of word frequencies and sentence lengths can produce writing that's technically accurate but feels like a parody. Voice is gestalt, not components.
**Fix:** Start from "what makes this voice feel like this?" Work backward to mechanics. The inventory serves understanding; understanding doesn't emerge from inventory alone.
### 2. Single-Context Capture
**Pattern:** Analyzing voice from one type of writing, then applying it to all contexts.
**Why it fails:** Writers shift voice across contexts. Technical writing voice differs from casual email voice. Capturing one context and forcing it everywhere creates uncanny artifacts.
**Fix:** Sample across contexts. Map how voice shifts. Include context-switching rules in the voice guide. Understand which elements are constant vs. context-dependent.
### 3. Frequency as Rule
**Pattern:** If they use em-dashes 8% of the time, the voice guide prescribes 8% emRelated in Image & Video
watch
IncludedWatch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.
physical-ai-defect-image-generation
IncludedUse when the user wants to orchestrate defect image generation, run associated setup, or handle outputs on OSMO. The Day 0 path handles cold-start with USD-to-ROI, image-edit augmentation, and AnomalyGen to create initial PCBA datasets. The Day 1 path performs inference and labeling on real images. This skill helps with first-time asset setup, creation of finetuning checkpoints, and configuring deployment. Trigger keywords: defect image generation, dig workflow, dig pipeline, defect image detection workflow, aoi pipeline, aoi anomalygen, usd2roi anomalygen, day 0 pcba, day 1 pcba, day 1 real-photo alignment, day 1 manual roi, metal surface anomaly, glass defect, anomalygen finetune, setup_pcb, setup_metal, setup_glass, setup_pretrained, dig setup, dig datasets, dig pretrained checkpoint, dig image-edit endpoint.
accelint-react-best-practices
IncludedReact performance optimization and best practices. ALWAYS use this skill when working with any React code - writing components, hooks, JSX; refactoring; optimizing re-renders, memoization, state management; reviewing for performance; fixing hydration mismatches; debugging infinite re-renders, stale closures, input focus loss, animations restarting; preventing remounting; implementing transitions, lazy initialization, effect dependencies. Even simple React tasks benefit from these patterns. Covers React 19+ (useEffectEvent, Activity, ref props). Triggers - useEffect, useState, useMemo, useCallback, memo, inline components, nested components, components inside components, re-render, performance, hydration, SSR, Next.js, useDeferredValue, combined hooks.
elevenlabs-agents
IncludedBuild conversational AI voice agents with ElevenLabs Platform using React, JavaScript, React Native, or Swift SDKs. Configure agents, tools (client/server/MCP), RAG knowledge bases, multi-voice, and Scribe real-time STT. Use when: building voice chat interfaces, implementing AI phone agents with Twilio, configuring agent workflows or tools, adding RAG knowledge bases, testing with CLI "agents as code", or troubleshooting deprecated @11labs packages, Android audio cutoff, CSP violations, dynamic variables, or WebRTC config. Keywords: ElevenLabs Agents, ElevenLabs voice agents, AI voice agents, conversational AI, @elevenlabs/react, @elevenlabs/client, @elevenlabs/react-native, @elevenlabs/elevenlabs-js, @elevenlabs/agents-cli, elevenlabs SDK, voice AI, TTS, text-to-speech, ASR, speech recognition, turn-taking model, WebRTC voice, WebSocket voice, ElevenLabs conversation, agent system prompt, agent tools, agent knowledge base, RAG voice agents, multi-voice agents, pronunciation dictionary, voice speed control, elevenlabs scribe, @11labs deprecated, Android audio cutoff, CSP violation elevenlabs, dynamic variables elevenlabs, case-sensitive tool names, webhook authentication
humanizer
IncludedHumanize AI-generated text by detecting and removing patterns typical of LLM output. Rewrites text to sound natural, specific, and human. Uses 28 pattern detectors, 560+ AI vocabulary terms across 3 tiers, and statistical analysis (burstiness, type-token ratio, readability) for comprehensive detection. Use when asked to humanize text, de-AI writing, make content sound more natural/human, review writing for AI patterns, score text for AI detection, or improve AI-generated drafts. Covers content, language, style, communication, and filler categories.
generating-mermaid-diagrams
IncludedSalesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says "diagram", "visualize", "ERD", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user wants PNG/SVG image output (use generating-visual-diagrams), or asks about non-Salesforce systems.