Agent skill

Voice Capture

by robertguss in robertguss/claude-code-toolkit

This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style.

MITAuto-check passedWriting & Content

Install Voice Capture

skills CLI
$ npx skills add robertguss/claude-code-toolkit --skill voice-capture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install robertguss/claude-code-toolkit voice-capture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/robertguss/claude-code-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/compound-writing/skills/voice-capture .claude/skills/voice-capture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
voice-capture
GitHub stars
123
Token cost
~1.7k tokens
SKILL.md length
557 words
Files
5 (incl. references, assets)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style.

  • Works in 4 steps: Collect Samples → Analyze Dimensions → Document Patterns → …
  • Tasks that involve Brand voice and tone
  • SKILL.md covers When to Use This Skill, Core Philosophy, Voice Profile Structure and Extraction Process, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Voice Capture is an agent skill from robertguss/claude-code-toolkit. This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style. It applies when users provide sample text and want to capture the voice for future use.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files and assets (for example `assets/voice-profile-template.yaml`, `references/analysis-dimensions.md` and `references/example-profiles.md`).

It sits in Writing & Content, covering Brand voice and tone. The repository describes itself as: A collection of custom skills that extend Claude's capabilities with specialized workflows, methods, and domain knowledge. The licence is MIT.

When your agent uses it

  • Tasks that involve Brand voice and tone

Example prompts

  • “/voice-capture”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Collect Samples
  2. Analyze Dimensions
  3. Document Patterns
  4. Create Profile

What it can do on your machine

Read from SKILL.md and the folder at commit f7fd35e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Voice Capture loads about 1.7k tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 557 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from robertguss/claude-code-toolkit at commit f7fd35e, republished under its MIT licence (© robertguss). 557 words, ~1,684 tokens.

Download SKILL.mdSave it as .claude/skills/voice-capture/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
voice-capture
description
This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style. It applies when users provide sample text and want to capture the voice for future use.

Voice Capture Skill

Extract and encode writing voice from sample text into reusable voice profiles. This skill transforms examples of writing you like into documented patterns that can guide future writing.

When to Use This Skill

This skill applies when:

  • A user provides sample text and asks "write like this"
  • Creating a voice profile from existing content
  • Documenting a brand voice for consistency
  • Capturing an author's style for future reference
  • Analyzing differences between two writing styles

Core Philosophy

Voice isn't just word choice. It's sentence rhythm, paragraph structure, emotional register, and a thousand small decisions that create a distinctive sound.

This skill captures those decisions systematically so they can be applied to new content.

Voice Profile Structure

A complete voice profile has three layers. See voice-profile-template.yaml for the full template.

Layer 1: Immutable Traits

Core characteristics that define the voice:

yaml
traits:
  - direct           # vs. indirect, circumspect
  - conversational   # vs. formal, academic
  - technically-informed  # level of assumed expertise

register: informal   # formal / semiformal / informal

prohibited:
  - "synergy"
  - passive voice in openings
  - exclamation marks (except in quotes)
Layer 2: Channel Guidance

How the voice adapts by medium:

yaml
channels:
  blog:
    length: "1000-2000 words"
    personality: "full"
    storytelling: "encouraged"

  newsletter:
    length: "300-500 words"
    personality: "high - direct address okay"
    storytelling: "personal anecdotes"

  social:
    length: "280 chars or thread"
    personality: "punchy, hooks required"
    storytelling: "minimal - punchlines only"

  documentation:
    length: "as needed"
    personality: "minimal"
    storytelling: "none - clarity first"
Layer 3: Example Library

Exemplars that demonstrate the voice:

yaml
exemplars:
  - path: "samples/great-opening.md"
    why: "Concrete example first, theory second"
    demonstrates: ["hook", "pacing"]

  - path: "samples/transition.md"
    why: "Invisible transition technique"
    demonstrates: ["flow", "structure"]

  - path: "samples/closing.md"
    why: "Strong CTA without being salesy"
    demonstrates: ["conclusion", "call-to-action"]

Extraction Process

Step 1: Collect Samples

Minimum: 3 samples (ideally 5-10) Total words: At least 2,000 words Variety: Different topics, same author/brand

Step 2: Analyze Dimensions

Reference analysis-dimensions.md for the full framework.

Vocabulary Analysis
  • Complexity: Simple ↔ Complex
  • Formality: Casual ↔ Formal
  • Jargon: Technical ↔ Accessible
  • Signature words: Frequently used phrases
Sentence Analysis
  • Length: Average words per sentence
  • Variety: Standard deviation of sentence length
  • Structure: Simple vs. compound vs. complex ratio
  • Fragments: Used for emphasis? How often?
Paragraph Analysis
  • Length: Average sentences per paragraph
  • Opening patterns: How do paragraphs typically start?
  • Closing patterns: How do paragraphs typically end?
Rhythm Analysis
  • Pacing: Quick (short sentences) vs. measured (longer)
  • Punctuation style: Dashes, semicolons, parentheses
  • White space: Dense vs. airy paragraphs
Emotional Analysis
  • Tone: Optimistic, skeptical, neutral, passionate
  • Distance: Intimate (I, you) vs. distant (one, they)
  • Stakes: High urgency vs. calm reflection
Step 3: Document Patterns

For each dimension, document:

  1. The observed pattern
  2. A concrete example
  3. A counter-example (what this voice avoids)
Step 4: Create Profile

Use extraction-templates.md to structure your findings.

Output: .claude/voice-profiles/[name].yaml

Using Voice Profiles

Show full SKILL.md (224 more words)Show less
In Writing Commands
yaml
# In /writing:draft
style:
  voice_profile: "kieran-blog"
  # OR
  voice_profile: ".claude/voice-profiles/client-name.yaml"
For Voice Guardian

The voice-guardian agent uses profiles to:

  • Score voice consistency (0-100)
  • Identify drift points
  • Suggest specific fixes

Target score: 85+

For New Writers

When onboarding writers to match an existing voice:

  1. Share the voice profile
  2. Share the exemplars
  3. Run voice-guardian on their drafts

Quick Extraction Workflow

For rapid voice capture (when you need a profile fast):

markdown
## Quick Profile: [Name]

**Based on**: [X] samples totaling [Y] words

### Core Traits
- [Trait 1]
- [Trait 2]
- [Trait 3]

### Sentence Patterns
Average length: [X] words
Common patterns:
- [Pattern 1]
- [Pattern 2]

### Vocabulary Markers
**Signature words**: [list]
**Avoided words**: [list]

### Tone
[Brief description]

### Quick Examples
Good: "[example that nails the voice]"
Bad: "[example that would violate it]"

Common Extraction Challenges

Challenge: Too Few Samples

Problem: Can't identify patterns from 1-2 samples. Solution: Ask for more content or analyze published work from the same source.

Challenge: Inconsistent Source

Problem: The sample voice varies significantly. Solution: Either document the variation (multiple profiles) or focus on the most recent/best examples.

Challenge: Style vs. Voice

Problem: Confusing topic-specific style with core voice. Solution: Analyze samples on different topics. What stays constant? That's the voice.

Challenge: Unconscious Patterns

Problem: Author doesn't know what makes their voice distinctive. Solution: Compare to other writers. What's different? That's often the key.

Quality Checklist

A voice profile is complete when:

  • All three layers are populated
  • At least 3 exemplars are documented
  • Prohibited patterns are explicit
  • Channel variations are noted
  • A test passage can be evaluated against it
  • Someone unfamiliar with the voice could use it

References

© robertguss, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references, assets) in plugins/compound-writing/skills/voice-capture of robertguss/claude-code-toolkit.

  • SKILL.md
  • assets/voice-profile-template.yaml
  • references/analysis-dimensions.md
  • references/example-profiles.md
  • references/extraction-templates.md

Open the folder on GitHubat commit f7fd35e

Compare with similar skills

Voice Capture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Voice Capture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Voice Capture this skillrobertguss/claude-code-toolkit123—~1.7kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
Khazix WeChat Article WriterKKKKhazix/khazix-skills21k2 repos~2.9kAutomated safety check: PassMIT
BrandOhh-889/skyroc79513 repos~733Automated safety check: PassMIT
Writing Guidelinesvercel-labs/agent-skills32k7 repos~309Automated safety check: PassNone
Unslop AI Writing Cleanuptheclaymethod/unslop512—~1.7kAutomated safety check: PassMIT

Similar skills

  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • Khazix WeChat Article Writer

    KKKKhazix/khazix-skills

    Writes long-form WeChat official account articles in the personal style of the Khazix account, from briefs, links, PDFs or rough notes, with a topic quality check.

    21k GitHub starsUsed in 2 repos~2.9k tokens
    Writing & ContentAuto-check passed
  • Brand

    Ohh-889/skyroc

    Brand voice, visual identity, messaging frameworks, asset management, brand consistency.

    795 GitHub starsUsed in 13 repos~733 tokens
    Writing & ContentAuto-check passed
  • Writing Guidelines

    vercel-labs/agent-skills

    Official

    Review docs/prose for Writing Guidelines compliance. An agent skill from vercel-labs/agent-skills.

    32k GitHub starsUsed in 7 repos~309 tokens
    Writing & ContentAuto-check passed
  • Unslop AI Writing Cleanup

    theclaymethod/unslop

    Removes AI writing tells from prose through an audit-first flow, routing to a two-pass rewrite, a report-only cleanup, voice teaching or mimicry depending on the sub-command used.

    512 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Brand Voice Guide

    luongnv89/claude-howto

    Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when…

    42k GitHub stars~609 tokensUpdated 8 days ago
    Writing & ContentAuto-check passed

More from robertguss/claude-code-toolkit

All 14 skills in this repo
  • Brainstorm

    robertguss/claude-code-toolkit

    Collaborative brainstorming partner for multi-session ideation projects.

    123 GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed
  • Dhh Writing

    robertguss/claude-code-toolkit

    This skill should be used when writing in the distinctive style of David Heinemeier Hansson (DHH).

    123 GitHub stars~1.6k tokensUpdated 22 days ago
    Auto-check passed
  • Pragmatic Writing

    robertguss/claude-code-toolkit

    This skill should be used when writing technical content in the style of Hunt/Thomas (The Pragmatic Programmer) and Joel Spolsky (Joel on Software).

    123 GitHub stars~1.5k tokensUpdated 22 days ago
    Auto-check passed
  • Writing Orchestration

    robertguss/claude-code-toolkit

    This skill should be used when orchestrating complex writing workflows with multiple phases.

    123 GitHub stars~1.9k tokensUpdated 22 days ago
    Auto-check passed
  • App Store Opportunity Research

    robertguss/claude-code-toolkit

    Full-pipeline iOS App Store opportunity research. An agent skill from robertguss/claude-code-toolkit.

    123 GitHub stars~5.6k tokensUpdated 22 days ago
    Auto-check passed
  • Book Architect

    robertguss/claude-code-toolkit

    Design the structural and emotional architecture for nonfiction books.

    123 GitHub stars~2.1k tokensUpdated 22 days ago
    Auto-check passed

Questions about Voice Capture

What does Voice Capture do?

This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style. Voice Capture is an agent skill from robertguss/claude-code-toolkit. This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style.

When should I use Voice Capture?

Voice Capture fits situations like: tasks that involve Brand voice and tone.

How do I install Voice Capture in Claude Code?

Run `npx skills add robertguss/claude-code-toolkit --skill voice-capture -a claude-code`. Or copy the skill folder (plugins/compound-writing/skills/voice-capture in robertguss/claude-code-toolkit) into .claude/skills/voice-capture in your project. Claude Code loads it when a task matches its description.

How do I install Voice Capture in Codex?

Run `npx skills add robertguss/claude-code-toolkit --skill voice-capture -a codex`. Or copy the skill folder (plugins/compound-writing/skills/voice-capture in robertguss/claude-code-toolkit) into .agents/skills/voice-capture in your project. Codex loads it when a task matches its description.

Can I use Voice Capture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add robertguss/claude-code-toolkit --skill voice-capture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/voice-capture, .gemini/skills/voice-capture, .github/skills/voice-capture and .opencode/skills/voice-capture in your project.

What does Voice Capture need to run?

SKILL.md names no scripts, command-line tools or credentials: Voice Capture is instructions for the agent only.

Does Voice Capture access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Voice Capture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Voice Capture use?

Voice Capture is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Voice Capture use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Voice Capture?

Skills that share tags, products or a category with Voice Capture: Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars), Khazix WeChat Article Writer (KKKKhazix/khazix-skills, 21k stars), Brand (Ohh-889/skyroc, 795 stars) and Writing Guidelines (vercel-labs/agent-skills, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Voice Capture?

robertguss (a GitHub user) maintains it in robertguss/claude-code-toolkit, which has 123 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 16, 2026.

Source: robertguss/claude-code-toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.