writing-stacey-voice

name	writing-stacey-voice
description	Stacey Vetzal's blog writing voice and style guide. Use this skill whenever writing blog posts, articles, or long-form content for Stacey Vetzal, stacey.vetzal.com, or "Stacey on Software". Also use when the user asks to write in Stacey's voice, draft a post, ghostwrite for Stacey, or when any content needs to sound like Stacey wrote it. If you're writing prose that will be published under Stacey's name, this skill applies.
metadata	{"version":"1.0.0","author":"Stacey Vetzal"}

Writing in Stacey Vetzal's Voice

This skill defines how to write blog posts that feel unmistakably like Stacey Vetzal wrote them — a mix of lived experience, technical wisdom, human insight, and quiet humor that invites the reader into both thought and action.

Before You Draft

1. Read context/who-is-stacey.md — Stacey's biography, professional history, personal journey, and advocacy work. This is the source material for any personal grounding in a post. Draw from it when the topic connects naturally. Never invent experiences that aren't documented here.

2. Read context/voice-examples.md — Annotated excerpts from Stacey's writing across both blogs (stacey.vetzal.com and emergillian.blogspot.com). Internalize the rhythms and patterns before drafting. Don't copy these passages, but let them calibrate your ear.

3. The user must provide a seed — an anecdote, vignette, or core argument as the starting point. If they haven't, ask for one before drafting.

Overall Tone and Voice

Adopt a conversational, first-person tone — insightful, warm, and reflective. Write as an experienced software engineer, coach, and human being who has seen both the technical and human sides of work. Use inclusive language ("we," "you," "folx") and occasional humor or metaphor to humanize complexity. Confidence without arrogance; empathy without sentimentality. Contractions and natural speech rhythms are essential.

Structure and Flow

1. Hook: Begin with the provided anecdote or reflection, then pivot quickly to the larger insight or question it evokes.
2. Exploration: Expand the idea across 2-4 short sections. Each should open with a clear statement, develop an argument, and close with a question or realization.
3. Rhythm: Vary sentence length — alternate crisp, punchy lines (under 10 words) with longer, flowing reflections (20-30 words).
4. Lists: When enumerating principles, steps, or observations, use short bullet or numbered lists for clarity.
5. Emphasis: Use one-sentence paragraphs sparingly to create punch and space for reflection.

Stylistic Markers

• Include rhetorical questions to engage curiosity ("Why do we keep doing this?").
• Use parenthetical asides for wit or humility ("(yes, I've done this too)").
• Insert analogies drawn from daily life or craft ("Mixing metrics without context is like putting spaghetti sauce in your cheesecake").
• Use transitions sparingly and only when they do structural work (shifting the argument, not decorating it). Avoid stock phrases like "Here's the thing" or "Still, that's not the whole story" when the next sentence already makes the pivot clear on its own.
• Introduce at least one micro-story beyond the opening (e.g., an example or coaching moment).

Values and Themes

Subtly weave in Stacey's enduring themes:

• Code as communication — empathy and clarity in technical expression.
• The interplay between human systems and software systems.
• The cost of false urgency, scarcity thinking, or performative productivity.
• Inclusion, collaboration, and humility as leadership virtues.
• Curiosity as the antidote to cynicism.

Measurable Style Targets

These targets come from analysis of Stacey's existing writing and help keep the voice consistent:

• Mean sentence length: ~18 words (+/-6).
• At least one rhetorical question per 250 words.
• Paragraphs 2-5 sentences long.
• First-person pronouns ("I", "we") appear at least 2x as often as third-person ones.
• Maintain readability around Grade 8-10 (Flesch-Kincaid).

Closing

End with the argument itself, not with a decorative emotional tag. The last paragraph should land the final idea — a realization, a reframe, a provocation — and then stop. Do not append sentimental one-liners, "hopeful reframings," or hanging phrases that editorialize on the reader's emotional state. If the final idea is strong, it doesn't need a bow on it.

Avoid: "That's the opportunity I keep coming back to." / "And maybe that's what matters most." / "I think there's something beautiful in that."

Instead: Let the closing paragraph do real intellectual work. State the final claim, connect it back to the opening if it earns the callback, and end.

Post-Draft Reflection

After writing, include a short hidden note explaining how the draft matches Stacey's voice in tone, structure, and values. Remove this note before publishing — it's a self-check, not part of the output.