voice-apply_skill

Overview

This skill applies a voice profile to transform content so it matches a specified tone, vocabulary, structure, and perspective. It loads named voice profiles, analyzes source text when provided, and produces transformed output with measurable voice adjustments. Use it to ensure consistency across documentation, marketing, tutorials, or stakeholder communications.

How this skill works

The skill loads a voice profile from project, user, or built-in locations and analyzes the input text for tone, vocabulary, structure, and perspective. It calculates gaps versus the target profile, applies calibrated changes (formality, confidence, warmth, energy), and adjusts vocabulary and structure accordingly. It can blend profiles with weighted merges and produces an authenticity check that reports tradeoffs, numbers, and constraints where required.

When to use it

• When a user asks “write in X voice” or “use Y tone”
• To transform existing content to a specific audience or reading level
• To standardize output across teams (docs, marketing, release notes)
• When you need a named profile applied or want to derive voice from an example
• To blend multiple profiles (e.g., technical + friendly) for mixed audiences

Best practices

• Choose the closest built-in profile then fine-tune rather than starting from scratch
• Provide a short example or target audience to improve matching accuracy
• When transforming existing text, keep original intent; report any content lost or implied changes
• Use small iterative adjustments (e.g., dial formality by 10–30%) to avoid overcorrection
• Validate authenticity markers (tradeoffs, numbers, constraints) for technical or executive content

Example use cases

• Write release notes in technical-authority voice with version numbers and tradeoffs
• Convert formal API docs into friendly-explainer language for onboarding
• Produce an executive brief summarizing outcomes and decisions in executive-brief voice
• Blend 70% technical-authority and 30% friendly-explainer for user-facing engineering comms
• Dial down formality by 30% for blog or social feed transformations