Write

Writing Style Skill

Expert writing for technical content, social media, and developer documentation. Optimized to avoid AI detection patterns.

How to call specific sections

Use these triggers to activate specific parts of this skill:

Example usage:

• "write:tweet about Convex real-time sync"
• "write:blog on authentication patterns"
• "write:feature for our new search API"

Rule of one

Every piece of content follows this framework:

One person: Write to a specific person, not an audience.

One problem: State the single problem they face.

One cause: Identify the root cause.

One difference: Explain what the solution does differently.

One action: End with one clear next step.

Rule of one checklist

Before publishing, answer these:

• Can I name the one person this is for?
• Can the problem fit in one sentence?
• Is the root cause obvious?
• Can I explain the difference in one breath?
• Is there only one action at the end?

If any answer is no, revise before publishing. Ask the user if they want to proceed with the revision.

When to use this skill

Activate for:

• X/Twitter posts
• LinkedIn content
• Blog posts
• README files
• Git commits
• Product announcements
• Developer documentation
• Feature posts

Important: This is for standalone writing. Don't update project files (files.md, changelog.md, README.md) when using this skill.

Voice styles

Match your voice to the content type:

Core principles

Stand out by being you You don't stand out online by saying the same things as everyone else. You stand out by saying: "This is who I am. Here's what I think, feel, and believe." Consensus takes are forgettable. Your take isn't.

Lead with value

• First sentence does the work
• Don't bury the takeaway
• Readers scroll fast

Be direct, not blunt

• Say what you mean
• Confidence without arrogance
• Contractions are fine

Technical, not alienating

• Define terms when helpful
• Complex ideas deserve simple language
• Let code speak when it can

Share what you actually know

• Personal experience beats generic advice
• Specific examples beat abstract principles
• Acknowledge what you don't know

Format by content type

write:tweet

X/Twitter posts format.

[Clear statement or observation]

[Supporting point or context]

[Optional: question or call to action]

Rules:

• First 2 lines visible in preview. Make them count
• 280 characters forces compression. Use it
• One idea per post
• No hashtags
• No emojis unless requested

write:linkedin

LinkedIn posts format.

[Hook that stops the scroll]

[Story or context in 2-3 short paragraphs]

[Insight or lesson]

[Call to action or question]

Rules:

• Short paragraphs for mobile
• Professional but not corporate
• Personal stories perform well
• One clear takeaway

write:blog

Blog posts format.

# Title (sentence case, max 70 characters)

[Opening that states the value immediately]

## Section heading
[Max 300 words per section]

## Section heading
[Use bullet points or tables where helpful]

Rules:

• Sentence case for all headings
• No H3s unless absolutely necessary
• Fact-check everything
• Lead with why it matters
• Max 5 sections

write:readme

README files format.

# Project name

[One sentence: what this does]

## Getting started
[Minimal steps to run]

## Usage
[Code examples]

## API / Configuration
[Reference docs]

Rules:

• Start with what it does, not what it is
• Code examples over descriptions
• Keep it scannable

write:commit

Git commits format.

[type]: [short description]

[Optional: longer explanation if needed]

Types: feat, fix, docs, style, refactor, test, chore

Rules:

• Present tense ("add feature" not "added feature")
• 50 characters max for subject line
• No period at the end

write:feature

Feature post format. Answer these five things without wandering:

## [Feature name]

**What it is**
[One sentence description]

**Who it's for**
[Specific user or role]

**The problem it solves**
[One problem, clearly stated]

**How it works**
[High-level explanation, 2-3 sentences max]

**Try it**
[One clear action: link, command, or next step]

Rules:

• No wandering. Five sections only.
• Each section answers one question
• Skip the hype. State facts.
• End with a single action

write:docs

Developer documentation format.

# [Task or concept name]

[One sentence: what this page helps you do]

## Before you start
[Prerequisites, if any]

## Steps
1. [Action]
2. [Action]
3. [Action]

## Example
[Code snippet]

## Related
[Links to related docs]

Rules:

• Task-oriented, not feature-oriented
• Show, don't tell
• Working code examples required
• Keep prerequisites minimal

write:convex

Convex-specific content.

New guide or tutorial:

New guide: [topic]

[What you'll learn or build]

[Link]

write:tip format:

Convex tip:

[Pattern in one sentence]

[Code snippet showing it]

[Why this works]

What to avoid:

• Generic praise ("Convex is amazing!")
• Comparisons that trash competitors
• Overpromising
• Screenshots without context
• Sharing customer work without permission
• Empty engagement bait

Content mix for Convex:

• 40% educational (tutorials, tips, patterns)
• 30% community (spotlights, customer stories)
• 20% product (updates, features, changelog)
• 10% personal (projects, learnings, opinions)

Templates

Technical educator style

[Clear headline]

Here's what matters:
- Point 1
- Point 2
- Point 3

[Code snippet or visual]

[Resource link]

Analytical thinker style

[Counterintuitive opening]

[Common belief]

[Your argument with evidence]

[Implications]

Data storyteller style

[Trend observation with specific data point]

[Context: why this matters now]

[Visual reference or chart if applicable]

[What to watch next]

Rules:

• Lead with numbers
• Connect data to broader movements
• End with forward-looking signal

Learn in public style

[Thing I just figured out]

[How I got there (mistakes included)]

[Resources or links for others]

Rules:

• Document the journey
• Share rough drafts
• Credit sources

AI detection avoidance