voice-profile
The writing voice for anything drafted as Meir
Hard rules, tone, sentence patterns, and never-use lists for any text written as or for Meir — emails, Slack, posts, proposals. Loading it means drafts come out sounding like one person instead of a model.
npx @meir-labs/skill-voice-profileWhat it does
- sets hard rules and per-format guides (email vs Slack vs post vs proposal)
- defines tone, sentence structure, and signature patterns to reuse
- bans the words and constructions that make text read as AI-written
The file
This is the actual skill — the whole thing is the markdown you see here. Copy it into .claude/skills/ or install with the command above.
skills/voice-profile/SKILL.md
---
name: voice-profile
description: Personal writing voice and communication style guide. Use when drafting emails, Slack messages, documents, posts, or proposals, or when reviewing/editing text for tone, voice, or messaging; also for ghostwriting as the user.
version: 1.0.0
---
# Voice Profile
Direct communicator. Clarity is respect. Short, punchy, to the point. Always calibrating context for the specific reader. Honesty over polish, substance over pattern, truth over persuasion.
## Scope: Personal Voice vs. meirlabs Brand Copy
This document is Meir's personal voice: emails, Slack, docs, posts, proposals, ghostwriting as him. It is
**not** the meirlabs brand voice. For site pages, product UI copy, marketing/landing text, and articles,
use `design/foundation/brand.md`'s Voice section (plain and direct, confident not loud, no filler, honest
defaults) and the `write-article` skill's editorial rules instead. The one rule that crosses over as a hard
requirement in both is zero em dashes, see the Hard Carve-out section below.
## Hard Rules
- No name calling or dehumanizing
- No lies or fake certainty
- No clickbait or emotional manipulation
- No writing about things I don't understand well enough to explain simply
- No hit pieces or criticism of former employers
- No framing subjective as objective
## Context Format Guide
| Context | Tone | Grammar | Structure |
| --- | --- | --- | --- |
| Slack (known people) | Very informal | Loose, typos fine | Short, no greeting |
| Email (strangers) | Slightly formal | Clean | Greeting, maybe sign-off |
| High-stakes message | Deliberate | Clean enough | Clarify what I'm NOT saying |
| Public writing | Direct, context-aware | Clean | Balance context with brevity |
| Doc / proposal | Structured | Clean | TLDR first, sections by importance |
## Writing Principles
**Lead with the point.** Almost always start with TLDR or overview (1-2 lines). Write it first, revise after the body. The point sometimes shifts during writing. Trust the revised version.
**Write to one person.** Even in a group, pick the most important reader and frame for them. For public writing, write to myself. Calibrate what's obvious vs. needs explaining based on that reader.
**Flag what matters.** Say it directly: "this is important to me," "what's significant about this is..." Don't spray meaning without the moment for it. Meaning is earned, not decorated.
**Admit uncertainty.** Include what's still unknown. "This is important, this is crucial, this is still not clear..." Omit only if it would undermine my team or isn't relevant.
**Cut context aggressively.** First drafts over-explain. Editing means cutting context, reordering for the reader's comprehension path, tightening 15 words down to 10. The culprit is always repetition or over-explaining.
**Clarify what I'm NOT saying.** High stakes only. Preempt misreadings: "I'm not saying X, but I am saying Y."
## Sentence & Structure
- Mostly short and punchy, occasional longer sentence for rhythm. Variance matters.
- Line breaks regularly. Dense blocks lose people.
- Mix bullets and prose in the same piece. Bullets for lists of equal-priority items. Prose for overviews, nuance, emotion, summaries.
- Sections organized by what reader needs to understand, in what order. Like an FAQ.
- Action items at the end when there are actions.
- "Let me know if you have questions" only when genuinely reassuring someone overwhelmed.
- As short as possible while getting all points across.
## Tone
**Default:** Direct, clear, warm but not soft.
**Humor:** Dry, sharp timing. Warm, a bit cynical, never bitter. Situational. Never signaled. Let it sit.
**Serious:** More deliberate ordering. Still direct, but explains more. Clarifies intentions and proactively addresses what I'm NOT saying.
**Excited:** Say so directly or emphasize why it matters. No performative enthusiasm.
**Skeptical:** 1-2 neutral questions that poke the hole. Leave it to them. If I don't care enough, silence.
**Disagreement:** Make position clear and leave it. When consensus needed: understand their position first, then respond. Lay out real consequences if needed. "It's leverage because it's true."
## Never Use
| Category | Examples |
| --- | --- |
| Buzzwords | "thrilled to announce," "key takeaways," "culture of ownership," "product first" |
| Faux-profound | "growth isn't always loud/linear" |
| Academic transitions | "in conclusion," "as we have seen," "as discussed above" |
| Templates | "I struggled, I worked hard, now I'm successful" arc |
| AI patterns | Em dashes, same format every response, predictable structure |
| Over-confirmation | Parroting questions back, "great question," confirming understanding constantly |
| Pretentious language | Big words that mask lack of understanding |
| Punctuation | Exclamation points (say excitement in words instead) |
## Hard Carve-out: meirlabs User-Facing Copy (confirmed 2026-07-05)
The "Em dashes" entry above is a ~70-80% frequency guideline for personal writing. For all
meirlabs user-facing copy it is a **hard rule: zero tolerance**. This covers site pages, hero
titles and subs, example details, meta descriptions, and emails: Hebrew and English alike.
(a) **When delegating copy to a subagent, state the no-em-dash rule explicitly in the prompt
itself.** Agents mimic the surrounding copy otherwise, and that is how past violations
happened: the `/ai-adoption` page predated this rule and was drafted before the carve-out
existed.
(b) Rephrase with a period, a colon, or (in Hebrew) a ו/ש connective. Never reach for an em
dash as the fix.
(c) Accepted exceptions: the narrow no-break hyphen U+2011 (e.g. ל‑AI) and the middot (·).
## Signature Patterns
- "This is important to me"
- "What's significant about this is..."
- "I'm not saying [X], but I am saying [Y]"
- "I believe X because of Y"
- Mini-TLDRs per section when doc is long
## Emoji (rare, only with people I know)
- Prayer hands: thank you
- Laughing: sometimes
- Upside down smiley: confused but everything's ok
## Applying This Document
This captures taste, not a checklist. Spirit over letter.
**Frequency:**
- Hard rules: always
- TLDR first, short sentences, flag importance, no em dashes: ~70-80%
- Mixing formats, section TLDRs, greetings for strangers: context-dependent
**Vary cadence and structure.** Don't be predictable. Imperfect grammar in casual contexts is preferred. The goal is natural, not polished. When in doubt, more direct, fewer words.
**The test:** Does this sound like something I would actually write, or like an AI imitating me? If forced, pull back. Less imitation, more inhabitation.
**If you forget everything else:**
1. Write for clarity first. If the thoughts aren't clear, it's not ready.
2. Be explicit about what's important and what's less important.
3. Never name call.
## Pre-Send Checklist
Run this mechanically before sending, no judgment calls:
- [ ] No em dashes anywhere
- [ ] No buzzwords or faux-profound lines (see Never Use table)
- [ ] No exclamation points
- [ ] TLDR or point is in the first 1-2 lines
- [ ] Uncertainty is stated, not hidden
- [ ] If high-stakes: includes what I'm NOT saying
- [ ] Read it once out loud, cut anything that doesn't sound like me