style-guide


Type	Skill
Plugin	awl-writing · v0.0.12
Invoke	`/awl-writing:style-guide`
Tools	Read, Write, Edit
Source	plugins/awl-writing/skills/style-guide/SKILL.md

When Claude uses it

Applies AWL brand voice and gender-inclusive language rules for German (Gendersternchen *) and French (point median ·) content. Covers tone, abbreviations, technical terms, and common mistakes. Use when writing or reviewing “german content”, “french content”, “blog post”, “gendern”, “style check”, “AWL tone”, or any AWL branded text.

Trigger phrases: german content · french content · blog post · gendern · style check · AWL tone

Definition

Production-grade writing for AWL: clear, authentic, direct, inclusive.

Quick Start

Gender-inclusive: Use Mitarbeiter*innen (DE) or auteur·ices (FR)
Lowercase “du”: Never capitalize du/dich/dein
No absolutes: Avoid “immer”, “nie”, “früher”
Hyphenate compounds: Web-App, Tech-Stack, Know-how

Core Principles

Principle	Application
Verständlich	Short sentences, no jargon, explain abbreviations
Authentisch	No corporate speak, context matters, no formulas
Direkt	Active voice, clear statements, no “immer”/“nie”
Frisch	No “das haben wir immer so gemacht”

Critical Rules

1. Gender-Inclusive Language (German)

✅ Correct

- Mitarbeiter\*innen (employees)
- Designer\*innen (designers)
- Nutzer\*innen / Nutzende (users)
- Mitarbeitende (employees - neutral)

❌ Wrong

- Mitarbeiter (male-only form)
- die Designer (male-only form)

Placement: Star goes where male→female form differs:

Mitarbeiter → Mitarbeiter*innen
jede*r (everyone)

Prefer plural: Die Lehrer*innen not der*die Lehrer*in

Avoid with umlauts: Not Ärzt*in (missing Arzt)

2. Neutral Formulations (Alternative to Gendersternchen)

✅ Neutral Options

- Mitarbeitende (substantivized verb)
- Team / Publikum / Jury (collective terms)
- Leitung / Produktion (activities not functions)
- tanzende Menschen (adjective + noun)
- Wer die Ausstellung besucht (relative clause)

3. Gender-Inclusive Language (French)

✅ Correct

- les auteur·ices (authors)
- Les étudiant·es (students)

Point médian: ·
Copy from here: « · »

4. AWL-Specific Terms (German)

✅ Always gender

- Designer\*in (not Designer)
- Manager\*in
- User\*in (except "User Research" as fixed term)
- Projektmanager\*innen / Personen aus dem Projektmanagement Team
- Entwickler\*innen / Personen aus dem Entwicklungsteam

✅ Grammar

- DIE richtige Partnerin (not DER richtige Partner)
  → Because: die Agentur, die Aktiengesellschaft

5. Address Style

✅ Correct

- Use "du" (lowercase)
- Direct, friendly tone
- No capitals: "du", "dich", "dein"

❌ Wrong

- "Du", "Dich", "Dein" (capitalized)
- "Sie" form (unless specific context requires formal)

6. Abbreviations

✅ In blogs/references/official communication

- "In der Regel" not "i.d.R."
- "Beispielsweise" not "bspw."
- "und so weiter" not "usw."

✅ Exception: Internal docs where brevity needed

7. Technical Terms

✅ Correct

- die App (from die Applikation)
- Web-App (not WebApp, not Web App)
- Progressive Web-App (capitalize Progressive)
- Cross-Plattform App
- Tech-Stack
- Know-how (not KnowHow, not Know How)

❌ Wrong

- Webapp, WebApp
- Cross Platform, Crossplatform
- Tech Stack

Quick Reference: German Gendering

With Gendersternchen

Designer*innen arbeiten eng mit Entwickler*innen zusammen.
(Designers work closely with developers.)

Für jede\*n ist etwas dabei.
(There's something for everyone.)

With Neutral Forms

Mitarbeitende arbeiten im Team.
(Employees work in teams.)

Das Publikum war begeistert.
(The audience was thrilled.)

Personen aus dem Designteam präsentieren die Lösung.
(People from the design team present the solution.)

Quick Reference: Language Style

✅ AWL Style

✅ Short, clear sentences
Wir entwickeln Apps. Sie sind schnell und nutzerfreundlich.

✅ No corporate speak
Schreib uns → not "Wir freuen uns auf Ihre werte Zuschrift"

✅ No absolutes
Oft ist es sinnvoll → not "Das machen wir immer so"

✅ Context matters
Individual response → not template emails

❌ Anti-Patterns

❌ Long, nested sentences
❌ "Wir freuen uns, Ihnen mitteilen zu dürfen..."
❌ "Das haben wir schon immer so gemacht"
❌ "nie", "immer", "früher" (absolutes)
❌ Ungendered: "Die Mitarbeiter sind..."
❌ Capitalized: "Du kannst Dich bei uns bewerben"

Common Mistakes

Gendering Errors

❌ Die Entwickler arbeiten...
✅ Die Entwickler\*innen arbeiten... / Die Entwickelnden arbeiten...

❌ Jeder kann sich bewerben
✅ Jede\*r kann sich bewerben / Alle können sich bewerben

❌ Der richtige Partner für dein Projekt
✅ Die richtige Partnerin für dein Projekt

Technical Terms

❌ WebApp
✅ Web-App

❌ Cross Platform
✅ Cross-Plattform

❌ Knowhow, Know How
✅ Know-how

❌ Tech Stack
✅ Tech-Stack

Style Errors

❌ Wir haben das schon immer so gemacht
✅ Bisher war das für uns erfolgreich

❌ Das machen wir nie
✅ Das ist nicht unser üblicher Ansatz

❌ i.d.R. funktioniert das gut
✅ In der Regel funktioniert das gut

❌ Du kannst Dich bei uns melden
✅ Du kannst dich bei uns melden