SKILL.md

$27

Core Messages

Code as craft

Built from scratch, made with intention. Every feature is fit for purpose, and everything has its place.

Made for multiplayer

Code is collaborative. But today, our conversations happen outside the codebase. In Zed, your team and your AI agents work in the same space, in real time.

Performance you can feel

Zed is written in Rust with GPU acceleration for every frame. When you type or move the cursor, pixels respond instantly. That responsiveness keeps you in flow.

Always shipping

Zed is built for today and improved weekly. Each release moves the craft forward.

A true passion project

Zed is open source and built in public, powered by a community that cares deeply about quality. From the team behind Atom and Tree-sitter.

Writing Principles

Most important information first — Start with what the developer needs to know right now: what changed, what's possible, or how it works. Follow with brand storytelling or philosophical context if space allows.

Thoughtful, not performative — Write like you're explaining something you care about, not pitching it.

Explanatory precision — Share technical detail when it matters. Terms like "GPU acceleration" or "keystroke granularity" show expertise and respect.

Philosophy first, product second — Start from an idea about how developers work or what they deserve, then describe how Zed supports that.

Natural rhythm — Vary sentence length. Let ideas breathe. Avoid marketing slogans and forced symmetry.

No emotional manipulation — Never use hype, exclamation points, or "we're excited." Don't tell the reader how to feel.

Structure

When explaining features or ideas:

Lead with the most essential fact or change a developer needs to know.

Explain how Zed addresses it.

Add brand philosophy or context to deepen understanding.

Let the reader infer the benefit — never oversell.

Avoid

AI/marketing tropes (em dashes, mirrored constructions, "it's not X, it's Y")

Buzzwords ("revolutionary," "cutting-edge," "game-changing")

Corporate tone or startup voice

Fragmented copy and slogans

Exclamation points

"We're excited to announce..."

Litmus Test

Before finalizing copy, verify:

Would a senior developer respect this?

Does it sound like something from zed.dev?

Does it read clearly and naturally aloud?

Does it explain more than it sells?

If not, rewrite.

Workflow

Phase 1: Understand the Ask

Ask clarifying questions:

What is this for? (homepage, release notes, docs, social, product page)

Who's the audience? (prospective users, existing users, developers in general)

What's the key message or feature to communicate?

Any specific constraints? (character limits, format requirements)

Phase 2: Gather Context

Load reference files (auto-loaded from skill folder):

rubric.md — 8 scoring criteria for validation

taboo-phrases.md — patterns to eliminate

voice-examples.md — transformation patterns and fact preservation rules

Search for relevant context (if needed):

Existing copy on zed.dev for tone reference

Technical details about the feature from docs or code

Related announcements or prior messaging

Phase 3: Draft (Two-Pass System)

Pass 1: First Draft with Fact Markers

Write initial copy. Mark all factual claims with [FACT] tags:

Technical specifications

Proper nouns and product names

Version numbers and dates

Keyboard shortcuts and URLs

Attribution and quotes

Example:

Zed is [FACT: written in Rust] with [FACT: GPU-accelerated rendering at 120fps]. Built by [FACT: the team behind Atom and Tree-sitter].

Pass 2: Diagnosis

Score the draft against all 8 rubric criteria:

Criterion

Score

Issues

Technical Grounding

Natural Syntax

Quiet Confidence

Developer Respect

Information Priority

Specificity

Voice Consistency

Earned Claims

Scan for taboo phrases. Flag each with line reference.

Pass 3: Reconstruction

For any criterion scoring <4 or any taboo phrase found:

Identify the specific problem

Rewrite the flagged section

Verify [FACT] markers survived

Re-score the rewritten section

Repeat until all criteria score 4+.

Phase 4: Humanizer Pass (Recommended)

For high-stakes content (homepage, announcements, product pages), run the draft through the humanizer skill:

/humanizer

Paste your draft and let humanizer:

Scan for the 24 AI-writing patterns from Wikipedia's "Signs of AI writing" guide

Audit for remaining tells ("What makes this obviously AI generated?")

Revise to add natural voice and rhythm

This catches AI patterns that survive the brand-writer process and adds human texture.

Phase 5: Validation

Present final copy with scorecard:

## Final Copy

[The copy here]

## Scorecard

| Criterion           | Score |

|---------------------|-------|

| Technical Grounding |   5   |

| Natural Syntax      |   4   |

| Quiet Confidence    |   5   |

| Developer Respect   |   5   |

| Information Priority|   4   |

| Specificity         |   5   |

| Voice Consistency   |   4   |

| Earned Claims       |   5   |

| **TOTAL**           | 37/40 |

✅ All criteria 4+

✅ Zero taboo phrases

✅ All facts preserved

## Facts Verified

- [FACT: Rust] ✓

- [FACT: GPU-accelerated] ✓

- [FACT: 120fps] ✓

Output formats by context:

Context

Format

Homepage

H1 + H2 + supporting paragraph

Product page

Section headers with explanatory copy

Release notes

What changed, how it works, why it matters

Docs intro

Clear explanation of what this is and when to use it

Social

Concise, no hashtags, link to learn more

Review Mode

When invoked with --review:

Load reference files (rubric, taboo phrases, voice examples)

Score the provided copy against all 8 rubric criteria

Scan for taboo phrases — list each with line number:

Line 2: "revolutionary" (hype word)

Line 5: "—" used 3 times (em dash overuse)

Line 7: "We're excited" (empty enthusiasm)

Present diagnosis:

## Review: [Copy Title]

| Criterion           | Score | Issues |

|---------------------|-------|--------|

| Technical Grounding |   3   | Vague claims about "performance" |

| Natural Syntax      |   2   | Triple em dash chain in P2 |

| ...                 |       |        |

### Taboo Phrases Found

- Line 2: "revolutionary"

- Line 5: "seamless experience"

### Verdict

❌ Does not pass (3 criteria below threshold)

Offer rewrite if any criterion scores <4:

Apply transformation patterns from voice-examples.md

Preserve all facts from original

Present rewritten version with new scores

Examples

Good