voice-create

Generate custom voice profiles as validated YAML files from natural language descriptions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generates new voice profiles from descriptions to match audiences and contexts.

Core Features & Use Cases

  • Dimension mapping: Formality, confidence, warmth, energy, complexity.
  • Vocabulary guidance: Preferred/avoid terms and signature phrases.
  • Output: YAML voice-profile ready for usage.

Quick Start

Create a beginner-tutorial voice for onboarding content.

Frequently Asked Questions about voice-create

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

FAQPage Schema
How do I create a custom voice profile for my writing?

Voice profiles define tone, formality, warmth, and vocabulary for specific audiences. Use natural language descriptions of your desired voice—such as 'friendly tutorial for beginners' or 'formal executive brief'—and the Skill generates a validated YAML file mapping dimensions like confidence, energy, and complexity. Save it to your project or user config directory to apply it across your content.

What dimensions can I control in a voice profile?

Voice profiles cover five core dimensions: formality, confidence, warmth, energy, and complexity. You also specify preferred vocabulary, terms to avoid, and signature phrases. The Skill outputs these as structured YAML conforming to voice-profile.schema.json, letting you tailor tone precisely for technical documentation, marketing, tutorials, or executive content.

Can I generate voice profiles for different audiences and content types?

Yes. The Skill handles audience-specific and context-specific voice creation—tutorials, technical documentation, marketing content, executive briefs, and other formats. Describe your audience and writing goal in natural language, and the Skill generates a profile that aligns tone, formality, and domain language to match that context.

What format does the voice profile output use?

Voice profiles are validated YAML files saved as {name}.yaml, conforming to voice-profile.schema.json. They're stored in project directories (.aiwg/voices/) or user config directories (~/.config/aiwg/voices/), making them reusable across your content generation workflow.

Do I need to manually write YAML to define a voice, or can I describe it naturally?

You describe your voice in natural language—no manual YAML writing required. The Skill parses your description and automatically generates the structured YAML profile, handling dimension mapping, vocabulary guidance, and schema validation so the output is ready to use immediately.