voice-apply

The Voice Apply skill is a powerful orchestration tool within the AIWG framework designed to normalize, transform, and calibrate textual content to align with established voice profiles. Whether you are crafting technical documentation, casual blog posts, executive summaries, or educational tutorials, this skill ensures that your writing maintains a consistent tone, vocabulary, and structural integrity across all platforms. By utilizing a hierarchy of configuration locations—ranging from project-specific overrides to built-in templates—it allows users to enforce strict adherence to brand guidelines or shift narrative perspective dynamically. It is particularly valuable for teams, marketers, and developers who need to switch between professional, technical, or approachable styles without manual editing, leveraging sophisticated calibration logic to blend multiple profiles into a singular, cohesive output. Key features include:

• Multi-profile blending with weighted calibration for tone, formality, and energy levels.
• Support for custom voice profile definitions in YAML format, allowing for granular control over vocabulary preferences and avoidance lists.
• Automated analysis of source content to identify current tone patterns and perform targeted gap analysis against a desired target voice.
• Built-in templates for common communication types like technical-authority, friendly-explainer, and executive-brief.
• Native integration with AIWG's command-line interface, supporting explicit triggers and automated batch transformation flows.

Usage and operational notes:

• The skill follows a strict resolution order for profiles: checking the local .aiwg/voices/ project directory first, then user-level configs, and finally built-in framework templates.
• When performing transformations, the agent evaluates formality, vocabulary, sentence structure, and perspective (e.g., first-person vs. third-person) to ensure authenticity.
• It is recommended to use specific trigger phrases such as 'write in technical voice' or 'make this sound more casual' to invoke the skill's capabilities directly.
• Output reports provide a transparent breakdown of changes, including formality shifts, specific word replacements, and structure modifications.
• This utility works seamlessly with writing-quality addons and SDLC templates, making it an essential component for high-quality, professional-grade artifact generation.