voice-analyze

Analyze text samples to generate machine-readable voice profiles in YAML or JSON.

175|26|Updated Aug 14, 2025
One-click install
npx skills add https://github.com/jmagly/ai-writing-guide --skill voice-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: voice-analyze
Source: https://github.com/jmagly/ai-writing-guide/tree/main/.factory/skills/voice-analyze
Command: npx skills add https://github.com/jmagly/ai-writing-guide --skill voice-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you reverse-engineer voice profiles from sample content by analyzing writing patterns, enabling consistent brand or personal voice across communications and documents.

Core Features & Use Cases

  • Analyze sentence structure, vocabulary sophistication, tone markers, and structural patterns.
  • Extract measurable features and map them to voice dimensions (tone, warmth, formality).
  • Generate a portable voice profile you can reuse to guide writing, branding, or coaching.

Quick Start

Provide a text sample to the voice-analyze skill and receive a voice profile YAML that outlines formality, warmth, confidence, and tone.

Frequently Asked Questions about voice-analyze

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze writing samples to extract a voice profile?

Voice-analyze reverses-engineers voice profiles by examining sentence structure, vocabulary complexity, tone markers, and writing patterns in your text sample. It measures features like sentence length, contraction usage, pronoun frequency, and hedging, then maps these to voice dimensions—formality, confidence, warmth, energy, and complexity—outputting a portable YAML or JSON profile.

What writing patterns does voice analysis measure?

Voice-analyze measures sentence length, vocabulary sophistication, contraction usage, pronoun frequency, question density, hedging language, and exclamation marks. These quantified features map to five voice dimensions: formality, confidence, warmth, energy, and complexity, creating a structured profile of your writing style.

Can I use a voice profile to maintain consistent tone across documents?

Yes. Voice-analyze generates machine-readable profiles (YAML/JSON) designed for downstream tools like voice-apply and voice-create. These portable profiles guide consistent voice alignment across documentation, marketing copy, blogs, and other communications.

What types of content can I analyze for voice profiles?

Voice-analyze works with documentation, marketing copy, blog posts, and any text samples. It's applicable whenever you need to reverse-engineer and formalize an existing writing voice or extract measurable voice characteristics for brand consistency or personal writing coaching.

Does voice analysis require specific input formats?

Voice-analyze accepts text samples as input. No special formatting or dependencies are required. Provide raw text content and the Skill analyzes its structural and linguistic patterns to generate a voice profile.

What can I do with the voice profile output?

The generated YAML/JSON voice profile is portable and machine-readable, enabling integration with downstream tools for voice application, creation, and blending. Use profiles to guide rewriting, train collaborators on brand voice, or feed into automated writing systems.