Skip to content
Notifications
Clear all

TIL: You can feed Writesonic your own style guide in a simple text file.

1 Posts
1 Users
0 Reactions
4 Views
(@infra_switcher)
Estimable Member
Joined: 1 month ago
Posts: 109
Topic starter   [#106]

I've been running Writesonic through its paces for generating technical documentation and blog outlines for our engineering team. The biggest pain point, as anyone who's tried to automate content knows, is getting the output to sound like *us* and not like generic, fluffy marketing copy. Our style guide is brutalist: active voice, no adverbs, no exclamation points, get to the point, and use specific technical terms correctly.

I found the "Custom Brand Voice" feature, but uploading a PDF of our 50-page brand bible was a mess. It hallucinated rules and the output was inconsistent. The breakthrough was realizing the "Upload" button in the long-form editor is way more literal than they market it.

You don't need a complex PDF. You can feed it a plain text file with direct instructions. The key is to write it like you're giving orders to a very literal, slightly pedantic junior engineer.

Here's the exact `style_guide.txt` I crafted and now use as my starting point for any new piece:

```text
STYLE DIRECTIONS - FOLLOW EXACTLY
- Voice: Direct, authoritative, assume reader is technical.
- Tone: No-nonsense. No marketing fluff. No "leverage," "utilize," "empower," "solution." Use "use," "create," "run."
- Sentences: Short. Avoid subclauses. One idea per sentence.
- Paragraphs: Maximum 4 sentences. Use bullet points for lists.
- Formatting: Use backticks for code, commands, and technical terms. Use H2 and H3 headers for structure.
- Forbidden Phrases: "In today's fast-paced world," "unlock potential," "seamlessly integrate," "revolutionize."
- Required Phrases: Use "migration pain," "hard truths," "observability," "cost monitoring," "trade-offs."
- Adverbs: Eliminate all -ly words unless technically critical.
- Examples: Always include a concrete, real-world example or a code block.
- Structure: Problem -> Diagnosis -> Concrete Steps -> Pitfalls -> Conclusion.
```

You upload this *in the same session* as your article prompt. The process looks like this:

1. Open the long-form editor.
2. Paste your initial content prompt (e.g., "Write a 500-word blog intro on the trade-offs between managed and self-hosted Kafka on Kubernetes").
3. *Before generating*, click "Upload" and select your `style_guide.txt`.
4. The system processes it silently. There's no confirmation, but it's ingested.
5. Now hit "Generate."

The output is radically different. It follows the sentence structure, adopts the vocabulary, and strips out the filler. It's not perfect—you still need to fact-check technical details—but it eliminates 80% of the stylistic editing grunt work.

The pitfalls:
* You have to re-upload the guide for *every new chat session*. It doesn't permanently attach to your profile.
* If your prompt contradicts the guide, the prompt often wins. Be consistent.
* It works best for long-form content. Short-form like ads seems to ignore it more often.

This turns Writesonic from a generic idea generator into a usable drafting tool for technical teams. The cost is the upfront work to distill your style into machine-readable commands. Think of it like writing a Terraform module or a Kubernetes ConfigMap for your content. Define your specs declaratively.

---


Been there, migrated that


   
Quote