# Voice Builder

Build a personalised voice profile inside a Codex or Claude project from a short...

- Repository: https://github.com/charlie947/social-media-skills (4504 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-18
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add charlie947/social-media-skills --skill voice-builder -g -a claude-code -y`
Codex: `npx skills add charlie947/social-media-skills --skill voice-builder -g -a codex -y`
Cursor: `npx skills add charlie947/social-media-skills --skill voice-builder -g -a cursor -y`
Gemini CLI: `npx skills add charlie947/social-media-skills --skill voice-builder -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add charlie947/social-media-skills`

## Description

Build a personalised voice profile inside a Codex or Claude project from a short interview plus 3 to 5 sample pieces of writing. Works for any content format: LinkedIn posts, newsletters, essays, emails, blog posts, tweets, or any other published writing. Use this skill at the start of any project where the user wants the assistant to learn who they are and how they write before drafting new content. Trigger whenever the user says "build my voice", "learn my voice", "set up my content system", "onboard me", "train on my writing", "train on my posts", "I want Claude to sound like me", or drops a batch of writing samples into chat at the start of a project. Also trigger for first-time users who need a voice foundation before writing anything. Always produces two files (about-me.md and voice.md) saved into the project root.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Voice Builder

## Codex and Claude runtime

- Use this skill in Codex or Claude with the tools actually available in the current task. `AskUserQuestion` examples describe the questions, not a required API: use an available question tool within its limits, or ask in chat. Reuse answers and source material already supplied.
- Work in the user-selected project. Read its `about-me.md`, `voice.md` and relevant brand files before personalised work. Confirm the intended author if files conflict or contain starter defaults. Ask for missing facts or run `voice-builder`; never inherit the maintainer's identity, accounts or private files.
- Resolve bundled `references/` relative to this skill folder. For an explicitly requested profile refresh, read and update the canonical `about-me.md`, `voice.md` or `newsletter-voice.md` in place, preserving unrelated user facts and rules. Consumers must reread those canonical files. Use a new filename only for new deliverables that would collide with unrelated existing files. Installation alone never starts an interview or writes files. Do not write persistent learnings unless requested.
- Use supplied evidence first. Verify external claims through available search/source tools when needed. If a source or integration is unavailable, name the missing capability and offer supplied text/export input. Never invent facts, first-person experience, metrics or a successful tool run.
- Connect only services needed for the chosen route through the user's existing account. Never print credentials or overwrite connections. Drafting, saving and reviewing do not authorise publishing, sending messages or changing accounts.

## CRITICAL: Auto-start on load

When the user requests this workflow, start Step 1. This means your very next message to the user is the interview questions. Nothing else.

The rest: https://github.com/charlie947/social-media-skills/blob/HEAD/skills/voice-builder/SKILL.md