update-voice

Update voice profiles by adding samples, editing sections, or regenerating from sources.

1|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/brennacodes/brenna-plugs --skill update-voice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-voice
Source: https://github.com/brennacodes/brenna-plugs/tree/main/plugins/mark-my-words/skills/update-voice
Command: npx skills add https://github.com/brennacodes/brenna-plugs --skill update-voice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Voice profiles often need evolution as writing goals change. This workflow guides you to load the current profile, review available voices, and apply updates by adding samples, editing sections, or regenerating the profile to reflect new insights.

Core Features & Use Cases

  • Discover and load the current voice profile from .claude/voices
  • Update voice samples, edit sections (tone, diction, structure), or regenerate the profile from sources
  • Persist changes with updated metadata (last_updated) and maintain a history of edits
  • Use case: refine a voice for a new writing project and apply consistent style across posts
  • Use case: switch the default voice or adjust prompts for upcoming content

Quick Start

Select a voice, choose an update mode, and apply the changes.

Frequently Asked Questions about update-voice

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

FAQPage Schema
How do I update an existing voice profile for new writing projects?

To update a voice profile, you load the current profile from .claude/voices, select a voice, choose an update mode like adding samples or manual edits, and persist changes with updated metadata.

What is the best way to add new writing samples to a voice profile?

Adding new writing samples to a voice profile uses the add-samples update mode, which incorporates the samples and updates the voice profile frontmatter including last_updated and sample_sources fields.

Can I regenerate a voice profile from source materials instead of manually editing it?

Yes, you can regenerate a voice profile from sources using the regenerate mode, which rebuilds the profile to reflect new insights while maintaining the local configuration at .claude/mark-my-words.local.md.

Does updating voice profiles require access to local configuration files?

Updating voice profiles requires access to the local configuration at .claude/mark-my-words.local.md and discovery of voices stored under .claude/voices to load and persist changes.

What sections of a voice profile can I manually edit when refining tone and diction?

When refining a voice profile, you can manually edit sections including tone, diction, and structure, then persist the changes with updated frontmatter metadata like last_updated.

Why should I update my voice profile instead of creating a new one for different content?

Updating an existing voice profile maintains edit history and preserves sample_sources while evolving tone and diction, ensuring consistent style across posts without losing previous profile data.