use-conversational-language

Solid

How to write texts meant to be published by humans for other humans.

AI & Automation 26 stars 3 forks Updated today MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
48
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Use conversational language Defines only the **voice**, how to word text a human should read as if a person typed it, never the content: each caller keeps its own rules for what to say (evidence bars, scope, structure). Apply the baseline always, plus the section matching the situation. Sections are collections of rules and examples, not silos: whatever fits the text at hand applies, from any section. Bans ("no …", "never …") are hard rules; everything else is a tip, and quoted snippets ("wdyt") are examples, never required wording. ## Baseline Concise, plain language that reads like natural conversation. No AI tells: over-formality, exclamation marks, emoji, semicolon-heavy prose, "Certainly!"-style openers, bullet lists where a sentence would do. Stop at the last point. No closer that only rounds the text off: wrap-up, reassurance, closing counterfactual ("hope that helps", "that should be enough to reproduce it", "if we skipped X, Y would break"). Never use dashes (em or en). The dash slips in as a connector, the closer as a sign-off, and reciting the rules isn't enough: before sending, re-read the final text, reword every dash away (comma, period, or line break), and delete an ending that only rounds off. Write the way people actually type. Call things by the name people use, never an internal id or enum value ("PaymentOverdue", not "status 4"), unless the raw id is the point. Brevity and softness are tone, not substance: they never weaken or drop what the text must ...

Details

Author
eai-org
Repository
eai-org/agent-toolkit
Created
2 months ago
Last Updated
today
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category