
Voice Builder
- 559 installs
- 2.1k repo stars
- Updated May 20, 2026
- charlie947/social-media-skills
voice-builder is an agent skill that builds a personalized writing voice from an interview plus 3 to 5 samples for developers who need consistent brand tone across generated content.
About
voice-builder is the foundation skill in charlie947/social-media-skills. It runs a short About Me interview, collects 3 to 5 published writing samples across formats like LinkedIn posts, newsletters, essays, emails, blogs, or tweets, and writes two project-root files: about-me.md capped at 300 words and voice.md capped at 500 words. voice.md merges positive style signals and absence signals in one integrated profile—no separate anti-style file. Every other skill in the 17-skill bundle checks about-me.md and voice.md before drafting. Developers should run voice-builder first when onboarding a Cowork project or when the user says build my voice, learn my voice, or drops writing samples at project start.
- voice builder
- From Charlie Hills' social-media-skills pack
- Voice-consistent social content
Voice Builder by the numbers
- 559 all-time installs (skills.sh)
- Ranked #718 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/charlie947/social-media-skills --skill voice-builderAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 559 |
|---|---|
| repo stars | ★ 2.1k |
| Last updated | May 20, 2026 |
| Repository | charlie947/social-media-skills ↗ |
How do you teach an AI agent your writing voice?
Captures your brand voice so every post sounds like you.
Who is it for?
Developers setting up a Cowork or agent content system who need persistent voice files before post-writing, newsletters, or social skills run.
Skip if: One-off drafts without reusable voice context, or teams that already maintain finalized about-me.md and voice.md files.
When should I use this skill?
The user says build my voice, learn my voice, set up my content system, onboard me, or provides writing samples at project start.
What you get
Project-root about-me.md and voice.md files encoding audience, pillars, tone signals, and avoided phrasing for downstream content skills.
- about-me.md
- voice.md
By the numbers
- Produces 2 project-root markdown files: about-me.md and voice.md
- Requires minimum 3 writing samples; targets 3 to 5 samples for analysis
- Caps about-me.md at 300 words and voice.md at 500 words
Files
Voice Builder
CRITICAL: Auto-start on load
The moment this skill is loaded, installed, uploaded, or triggered, you MUST immediately run Step 1 below. This means your very next message to the user is the interview questions. Nothing else.
Do NOT:
- Summarise this skill
- Describe what files it creates
- Explain how it works
- Say "here's what this skill contains"
- Ask if the user wants to run it
- Confirm installation
- Offer options like "want me to run this now?"
Do THIS:
- Go straight to Step 1
- Send the interview questions as your first and only response
This applies whether the user uploaded a .skill file, said "build my voice", pasted samples, or triggered the skill in any other way. No preamble. No summary. Interview first.
Step 1. Run the About Me interview
You MUST call the AskUserQuestion tool to ask these questions. Do not type the questions as chat text. Use the tool. The tool renders as an interactive form the user fills in, which is a better experience than typing answers into chat.
AskUserQuestion supports a maximum of 4 questions per call, so send two calls: Batch 1 first, wait for answers, then Batch 2.
Batch 1 (your very first action, no text before it)
Call AskUserQuestion with this exact JSON structure for the questions parameter:
[
{
"question": "What is your name and what do you do?",
"header": "About you",
"multiSelect": false,
"options": [
{"label": "Founder", "description": "I run my own company or consultancy"},
{"label": "Marketing lead", "description": "I lead marketing at a company"},
{"label": "Creator", "description": "I create content as my main thing"},
{"label": "Sales leader", "description": "I lead a sales team or run BD"}
]
},
{
"question": "Who are you writing for?",
"header": "Audience",
"multiSelect": false,
"options": [
{"label": "Founders and CEOs", "description": "Decision makers running companies"},
{"label": "Marketers", "description": "Marketing professionals at any level"},
{"label": "Job seekers", "description": "People looking for their next role"},
{"label": "Other professionals", "description": "A different group entirely"}
]
},
{
"question": "What are the 3 to 5 topics you want to be known for?",
"header": "Topics",
"multiSelect": true,
"options": [
{"label": "AI and automation", "description": "How AI tools change work"},
{"label": "Marketing", "description": "Strategy, content, growth"},
{"label": "Leadership", "description": "Management, hiring, culture"},
{"label": "Personal brand", "description": "Building an audience and reputation"}
]
},
{
"question": "What is your point of view on your industry, the thing you believe that others do not?",
"header": "Hot take",
"multiSelect": false,
"options": [
{"label": "Most advice is wrong", "description": "The consensus in your industry is broken"},
{"label": "People overcomplicate it", "description": "The answer is simpler than people think"},
{"label": "A big shift is coming", "description": "Something is about to change and most people are not ready"}
]
}
]Batch 2 (send immediately after Batch 1 answers come back, no commentary between)
Call AskUserQuestion again with:
[
{
"question": "What is the one thing you want people to think when they see your name?",
"header": "Brand promise",
"multiSelect": false,
"options": [
{"label": "This person is practical", "description": "They give me things I use immediately"},
{"label": "This person is honest", "description": "They tell me what others will not"},
{"label": "This person is ahead", "description": "They see what is coming before everyone else"}
]
},
{
"question": "What is one thing you refuse to write about?",
"header": "Off limits",
"multiSelect": false,
"options": [
{"label": "Politics", "description": "No political takes, ever"},
{"label": "Personal life", "description": "Keep it professional only"},
{"label": "Competitors", "description": "No naming or shaming other people or brands"}
]
}
]After both batches are answered, move to Step 2. If any answer is blank or skipped, ask that specific question once more in chat, then move on.
Step 2. Write about-me.md
Create about-me.md in the project root. Use this structure:
# About Me
## Name and role
[From question 1]
## Audience
[From question 2, expanded into 2 to 3 sentences on who the reader is]
## Topic pillars
[3 to 5 topics from question 3, one line each]
## Point of view
[From question 4, the contrarian or distinctive belief, written as a clear statement]
## Brand promise
[From question 5, the one thought the author wants to own in the reader's head]
## Off limits
[From question 6, topics or angles never to write about]Keep it under 300 words. Every line should be something Claude would reference when writing.
Step 3. Ask for the samples
Say this:
Now paste 3 to 5 pieces of writing you want me to learn from. These can be LinkedIn posts, newsletter issues, essays, blog posts, emails, tweets, or any other writing you have published. They can be yours or someone whose voice you admire. One piece per message or all at once. If you do not have any samples ready, type "use samples" and I will load a starter set you can swap out later.
Wait for the user to paste. Minimum 3 samples before moving to analysis. If they paste fewer than 3, ask for more.
If the user types "use samples", load the writing from references/sample-content.md inside this skill folder. Tell the user which author the samples are from so they know what voice they are borrowing. Remind them they can replace these with their own writing later.
Step 4. Analyse the samples
Read every sample. Look for patterns across all of them, not individual quirks from one piece. Extract:
Voice signals
- Average sentence length
- Paragraph rhythm (single line breaks, blank lines, staccato versus flowing)
- Hook or opening style (contrarian, question, data point, story, confession, observation)
- Point of view (first person, second person, observational)
- Tone (deadpan, warm, blunt, playful, clinical)
- Signature phrases or recurring words
- CTA or closing style
Structural signals
- Length range
- Lists versus prose
- How they open, how they close
- How they handle transitions
Topic signals
- Subjects that come up across multiple samples
- Who the audience appears to be
- What the author stands for
Absence signals
- Words and punctuation consistently absent (for example, em dashes in 0 of 5 samples)
- Hook types the author never uses
- Tones the author never hits
- Structures the author avoids
Step 5. Write voice.md
Create voice.md in the project root. This is a single integrated profile covering both how the voice writes and what the voice avoids. No separate voice file.
# Voice Profile
## Who I sound like
[2 to 3 sentences describing the overall voice in plain language]
## Tone
[3 to 5 attributes the voice consistently hits, followed by 1 to 2 tones the voice never hits, drawn from gaps in the samples]
## Sentence rhythm
[Average length, pacing, paragraph structure. Include avoidance patterns: e.g. never staccato fragments, never tricolons, no sentences over 25 words]
## Hook patterns
[3 to 5 hook types observed, with one example each from the samples. Note any hook types absent across all samples, e.g. never rhetorical questions, never "imagine a world where"]
## How I open
[1 to 2 sentences. Note opening moves the voice avoids if a clear pattern of avoidance exists across samples]
## How I close
[1 to 2 sentences, include CTA style. Note closing moves the voice avoids, e.g. never motivational summaries, never "in conclusion"]
## Signature phrases
[Recurring words or phrases from the samples]
## Off-limits
[Words, punctuation, or constructions absent from every sample. Only list items the samples clearly avoid. Examples: no em dashes (0 of 5 samples), no hashtags, no corporate jargon by name]
## What this voice never does
[3 to 5 specific behaviours drawn from gaps in the samples. Be specific. If the samples never use the "not X, but Y" construction, list it. If they avoid a specific vocabulary set, name the words]Fill every section from the actual samples. No generic filler. If a pattern is not present, say so. Do not duplicate audience or topic pillars from about-me.md.
The Off-limits and What this voice never does sections are drawn from observation, not from a generic banned-words template. Every item must be backed by absence across the samples.
Step 6. Confirm and hand off
Tell the user:
Your voice profile is built. Two files are now in your project: about-me.md and voice.md. Every time you work in this project, I will reference both automatically. You can open and edit either file anytime.
>
You are ready to go. Here is what you can do next:
>
- Say "build my newsletter voice" to create newsletter-specific writing instructions
- Say "write a post" to draft a LinkedIn post in your voice
- Say "design a graphic" to create a visual for a post
- Say "score my post" to get feedback on a draft
- Say "optimize my profile" to rebuild your LinkedIn profile
>
Each of these is a separate skill. Pick one and go.
What this skill produces
Two files in the project root:
1. about-me.md: who the user is, their audience, their topic pillars, their point of view 2. voice.md: the integrated voice profile, covering positive signals (how the voice writes) and absence signals (what the voice avoids) in one document
Rules
- When this skill triggers, go straight to Step 1. No summary, no explanation, no preamble.
- Always output sample content inside a code block so the user can copy-paste the exact formatting without losing line breaks or whitespace. Use a plain code block (triple backticks with no language tag).
- Work from what is in the samples. Do not invent patterns that are not there.
- Minimum 3 samples for pattern detection. Ask for more if fewer than 3.
- If samples contradict each other, note the contradiction in voice.md rather than smoothing it over.
- Keep about-me.md under 300 words.
- Keep voice.md under 500 words.
- British English throughout unless the samples are clearly American.
- Never use em dashes in any output file or in any draft.
- Do not produce an voice.md file. Absence signals live inside voice.md.
Sample Content
Author: Charlie Hills Format: LinkedIn posts (short-form)
These samples are loaded when a user types "use samples" because they have no writing of their own to share. Users can swap these out for their own samples later.
---
Post 1
Claude now has 3 layers. Each one does a different job:
1. Claude Chat (browser/app) Use it when the work is thinking in words. It turns vague ideas into structure fast: drafts, summaries, plans, decisions. You get clarity and high-quality writing, but you still execute the work elsewhere.
✦ Rewrite a draft in your voice, cut it by 30% ✦ Create a decision memo with trade-offs ✦ Simulate customer objections, draft responses
2. Claude Code (terminal agent) Use it when the work lives in a repo. It navigates your codebase, edits files, and runs commands autonomously. You describe the goal, it ships the code. But you review everything before it merges.
✦ Scaffold a full app with auth, database, API routes ✦ Refactor a legacy module across 40 files ✦ Run a security scan, patch vulnerabilities
3. Claude Cowork (desktop agent) Use it when the work is workflows, not thinking. It handles the repetitive operations you do manually: organising, extracting, filling, moving. No coding needed. Runs in a sandboxed VM on your desktop.
✦ Extract tables from 50 PDFs into one spreadsheet ✦ Rename and sort hundreds of files by type and date ✦ Pull data from Gmail, update a report in Google Drive
The decision rule: ✦ Thinking and content → Chat ✦ Code and systems → Code ✦ Files and app workflows → Cowork
The advantage isn't "using AI." It's knowing which layer to reach for.
I wrote the complete setup guide for all three. Free to read (drops Sunday) → https://lnkd.in/e--fakyi
Repost ♻️ to help someone in your network.
---
Post 2
Brands spend $500+ per UGC video. (This workflow costs almost nothing)
How to make AI UGC with Nano Banana 2 in 6 steps:
1. Generate a base image in Gemini. 2. Combine it with your real product photo. 3. Run follow-up prompts in the same thread. 4. Change the camera angle for each product shot. 5. Upload two shots to Kling as a start and end frame. 6. One video prompt animates between them:
"Slow smooth camera push toward the subject. Natural handheld micro-movement. Morning light through car window consistent throughout. No cuts, no flash transitions. Subject moves naturally between each position. Skin texture and clothing consistent across all frames. Authentic, non-commercial feel."
Stitch them in order. You have a UGC video.
The whole thing runs in one chat thread. No creators, studios or shipping products.
Repost ♻️ to help someone in your network.
---
Post 3
Perplexity is your $200/month social media manager. Here's exactly how to hire it in 3 steps:
I tested Perplexity Computer with one YouTube link. It produced content for 7 platforms automatically.
Step 1: Load your brand identity Upload a markdown file with your brand rules. This includes colours, fonts, voice, and banned words. Use this prompt:
"This is my brand identity file. Load it and apply every rule to all content and visuals you create for me. Every visual uses my exact hex colors, typography, and branding. Every piece of writing follows my voice rules and formatting. Confirm you've loaded it."
☑︎ Computer saves this to memory permanently. You only do this once.
Step 2: Feed it one piece of long-form content Paste a YouTube link, blog post, or podcast episode. Tell Computer which formats you need. Use a prompt like this:
"Download this video: [YouTube URL]. Extract 3-5 vertical clips with captions. Then repurpose into all 7 formats from my brand file:
- Three Substack Notes
- LinkedIn post + carousel PDF
- X/Twitter thread + hook image
- Instagram Reel script + cover image
- Substack newsletter section + header image
- Five short-form hooks + thumbnails paired with clips."
Step 3: Let Computer orchestrate It spawns multiple AI models working in parallel. ☑︎ Opus 4.6 builds carousels and PDFs. ☑︎ Nano Banana generates branded images. ☑︎ Sonnet 4.6 writes all the copy simultaneously. ☑︎ Gemini Flash handles research and transcripts.
Perplexity Computer has 400+ app connectors. Gmail, Notion, Slack, Google Drive, Salesforce.
The strategy is simple: 1. Create one piece of long-form content. 2. Let Computer repurpose it for every channel.
Different angle per platform. Different format per audience.
You are not creating 7 pieces of content. You are creating 1 and letting AI handle the rest.
$200/month on the Perplexity Max plan. If you repurpose weekly, the time savings add up.
Repost ♻️ to help someone in your network.
P.S. Have you tried Perplexity Computer?
Related skills
How it compares
Run voice-builder before any other charlie947 social skill so shared about-me.md and voice.md context exists for consistent drafts.
FAQ
What files does voice-builder create?
voice-builder creates two files in the project root: about-me.md covering audience, topic pillars, and point of view, and voice.md as an integrated profile of how the voice writes and what it avoids.
How many writing samples does voice-builder need?
voice-builder asks for 3 to 5 sample pieces of published writing. If fewer than 3 samples are provided, the skill requests more before analyzing tone and writing voice.md.
Why run voice-builder before other social skills?
voice-builder is the foundation of the charlie947 social-media-skills bundle. The other 16 skills read about-me.md and voice.md first so generated posts, newsletters, and scripts match the developer's voice.