Write in a voice you recognize.
Voice Forge is an agent skill for writing, editing and learning your prose style in English and Spanish. Start with a private profile, teach it through your own rewrites, then use the same rules to draft and review.
New here? You need an agent that reads skills, Git and Python 3. The plugin repository is private, so installation requires repository access. Your personal writing lives in a separate, private voice home.
From installation to a first round
Run these commands in your terminal. They put the app in ~/voice-forge and link its skills to Claude Code, Codex and Kilo.
git clone https://github.com/randrescastaneda/voice-forge ~/voice-forge
cd ~/voice-forge
python3 scripts/build.py install
Open your agent and send these messages one at a time. These are skill calls, not shell commands. In Codex, replace / with $.
/vf-setup
/vf-new explainer-en
/vf-train explainer-en
Setup finds or creates your private voice home. New asks for a brief. Train gives you a short passage to rewrite, then proposes up to three lessons for your approval. Follow the full installation guide, including the Claude plugin option.
Choose your next step
| Your task | Start here |
|---|---|
| I am setting this up for the first time | Installation and your first profile |
| I already have papers, chapters or posts | Study your existing writing |
| I want to practice or learn from real edits | Train & learn |
| I need a draft, a light edit or a rule check | Draft, edit & review |
| I write in English and Spanish | Derive across languages |
| I want to know whether this actually sounds like me | Test your voice |
| I need exact fields, methods or commands | The complete reference library |
Three ideas to carry with you
One profile for one context. An academic paper and an everyday email need different briefs. Voice Forge loads one profile at a time, plus a few shared base rules. Profiles do not form a live inheritance tree.
Your approval makes the rule. Analysis and rewrites supply evidence. A lesson stays a candidate until there is enough training and you approve the full rule. You can also state a rule directly and approve its exact wording.
Checks answer different questions. A valid profile can still produce prose that does not sound like you. Structure, compliance, voice fidelity, quality and meaning are evaluated separately.
What the plugin can do
The main voice-forge skill holds the rules and routes your request. Fifteen shortcuts make each task explicit. The invocation cookbook covers all of them, with copyable examples for each supported client.
The skill is Markdown plus Python helpers. It uses your agent's model and file tools. It does not train model weights, supply a model, guarantee voice fidelity, or automatically turn every observed habit into a rule. PDF and Word analysis depends on what your agent can read.
Nonfiction has a defined ten section schema. Fiction profiles are supported as free layouts with the same rule fields; a dedicated fiction schema is not defined yet. Understand the scope.