Myvoice Skill

myvoice — a portable writing-voice skill

`myvoice` teaches an AI agent to write like *you*.

It keeps a plain-text file called **`MYVOICE.md`** in whatever folder you are working in. That file holds your rules: tone scores, who you are, who you write for, words you never want, formatting per platform. The agent reads it before every draft.

It also **learns**. When you finish editing a draft, the skill compares its first version to your final version, spots the changes you keep making, and offers them back as new rules. You approve; it writes them into `MYVOICE.md`.

One folder can hold several voices — `/myvoice BLOGVOICE.md` loads a different file.

Works with **Claude Code**, **Claude.ai**, and **OpenAI Codex CLI**.

---

Install

Claude Code

Copy the `myvoice` folder into your skills directory.

Personal (all projects):

cp -r myvoice ~/.claude/skills/myvoice

Copy-Item -Recurse myvoice "$HOME\.claude\skills\myvoice"

Project only (shared with your team through the repo):

mkdir -p .claude/skills && cp -r myvoice .claude/skills/myvoice

Restart Claude Code. Type `/myvoice` to start.

Claude.ai (web and desktop)

1. Use the ready-made zip: dist/myvoice-skill.zip
2. Go to Settings → Capabilities → Skills.
3. Click + → Create skill and upload the zip.

The zip has the `myvoice/` folder at its root. That is the layout Claude.ai expects.

OpenAI Codex CLI

cp -r myvoice ~/.codex/skills/myvoice

Copy-Item -Recurse myvoice "$HOME\.codex\skills\myvoice"

Codex picks up new skills automatically. Ask it to "use the myvoice skill" or type `/myvoice`.

Shared location (both agents, one copy)

Some builds of Claude Code and Codex also read `~/.agents/skills/`. If yours does, install there once instead of twice:

cp -r myvoice ~/.agents/skills/myvoice

Scripts

`install.sh` and `install.ps1` do the copying for you:

./install.sh claude     # or: cod