Social Writer
Create platform-optimized social media content that sounds human, drives engagement, and builds audience.
Quick Navigation
| Topic |
Reference |
| X Single Posts |
x-posts.md |
| X Threads |
x-threads.md |
| X Content Strategy |
x-strategy.md |
| Hook Patterns |
hooks.md |
| LinkedIn |
linkedin.md |
| Threads & Instagram |
threads-instagram.md |
| Facebook |
facebook.md |
| AI Writing Avoidance |
ai-avoidance.md |
| Style Guide |
style-guide.md |
| Technical Blog Styles |
technical-styles.md |
Platform Quick Reference
| Platform |
Limit |
Best Length |
Hashtags |
Key Rule |
| X |
280 chars |
230-280 |
1-2 max |
Hook in first line, use full space |
| LinkedIn |
3,000 chars |
1,300 |
3-5 |
Hook before "see more" |
| Threads |
500 chars |
400-500 |
None |
Conversational, no hashtags |
| Instagram |
2,200 chars |
Varies |
5-15 |
Visual-first, line breaks |
| Facebook |
Unlimited |
<250 |
2-3 |
Community, engagement |
Content Type Router
What are you creating?
│
├─ X?
│ ├─ Single insight/observation → x-posts.md
│ ├─ Multi-part story/tutorial → x-threads.md
│ └─ Content planning → x-strategy.md
│
├─ LinkedIn → linkedin.md
│ └─ Professional, B2B, thought leadership
│
├─ Threads/Instagram → threads-instagram.md
│ └─ Conversational, authentic, visual
│
├─ Facebook → facebook.md
│ └─ Community, engagement, events
│
└─ Technical blog → technical-styles.md
├─ Karpathy style (conversational, personal)
└─ Deep technical (opinion-forward, contrarian)
Writing Workflow
1. Select Platform & Format
Choose based on:
- Audience: Where do they spend time?
- Content depth: Quick insight vs deep dive
- Goal: Engagement, education, announcement
2. Load Style Reference
Before writing:
- Read platform-specific guide
- Read ai-avoidance.md — critical for human voice
- Read style-guide.md for tone
3. Draft Content
Apply platform constraints from start. Style informs structure.
4. Quality Check
Run through checklist below before posting.
Universal Quality Checklist
Voice
Specificity
Structure
Value
X Quick Start
Single Post Pattern
[Hook - stop the scroll]
[Context or specific detail]
[Insight or learning]
[Optional: engagement question]
Example:
Shipped curation v1 for agents.foo today.
Discovery is way harder than app stores. Agents are conversations, not static features.
Had to rebuild around context matching instead of keyword search.
Thread Pattern
1/N [Bold hook - main insight] 👇
2/N [Context or setup]
3-N/N [Key points, one per tweet]
N/N [Summary + CTA]
Rules:
- First tweet MUST end with 👇 or 🧵 to signal thread
- Use N/M numbering (1/7, 2/7... 7/7)
- Each tweet must stand alone
- Max 5-7 tweets (longer = blog post)
High-Engagement Content Patterns
| Pattern |
Structure |
Best For |
| Shipped X, Learned Y |
What shipped + key learning + why it matters |
Project updates |
| How to X |
Problem + steps + key insight |
Tutorials |
| Problem → Solution |
Problem + failed attempts + what worked |
Case studies |
| Contrarian |
Popular belief + why wrong + your evidence |
Thought leadership |
| Tool Recommendation |
Tool + specific benefit + real example |
Resources |
Content Selection: What to Share
Always Share ✓
- Shipped work + learnings
- Non-obvious insights
- Tool recommendations with specifics
- Solutions to common problems
Skip ✗
- Generic progress updates
- Plans before execution
- Obvious observations
- Engagement bait ("RT if you agree")
- Vague hype
Critical Prohibitions
- Do not use words: delve, unleash, harness, leverage, robust, seamless, game-changer, unlock
- Do not use em-dashes (—) anywhere
- Do not use "It's not X, it's Y" pattern
- Do not ask for engagement ("RT if you agree", "What do you think?")
- Do not use formal transitions (Furthermore, Moreover, Additionally)
- Do not write uniform sentence lengths
- Do not skip the hook
Links
- ai-avoidance.md — Most important, read first
- hooks.md — Hook patterns with examples
- x-strategy.md — What to share
1---
2name: social-writer
3description: "Create engaging content for social media platforms: X posts and threads, LinkedIn, Threads, Instagram, Facebook. Includes writing styles, AI-avoidance patterns, hooks catalog, and macOS Notes integration. Use when drafting social media posts, writing thread series, applying engagement hooks, or adapting content for specific platforms. Keywords: social media, X, LinkedIn, threads, posts, hooks, content strategy, AI writing avoidance."
4metadata:
5 version: "1.0.0"
6 release_date: "2026-03-11"
7---
8
9# Social Writer
10
11Create platform-optimized social media content that sounds human, drives engagement, and builds audience.
12
13## Quick Navigation
14
15| Topic | Reference |
16| --------------------- | ------------------------------------------------------- |
17| X Single Posts | [x-posts.md](references/x-posts.md) |
18| X Threads | [x-threads.md](references/x-threads.md) |
19| X Content Strategy | [x-strategy.md](references/x-strategy.md) |
20| Hook Patterns | [hooks.md](references/hooks.md) |
21| LinkedIn | [linkedin.md](references/linkedin.md) |
22| Threads & Instagram | [threads-instagram.md](references/threads-instagram.md) |
23| Facebook | [facebook.md](references/facebook.md) |
24| AI Writing Avoidance | [ai-avoidance.md](references/ai-avoidance.md) |
25| Style Guide | [style-guide.md](references/style-guide.md) |
26| Technical Blog Styles | [technical-styles.md](references/technical-styles.md) |
27
28## Platform Quick Reference
29
30| Platform | Limit | Best Length | Hashtags | Key Rule |
31| ------------- | ----------- | ----------- | -------- | ---------------------------------- |
32| **X** | 280 chars | 230-280 | 1-2 max | Hook in first line, use full space |
33| **LinkedIn** | 3,000 chars | 1,300 | 3-5 | Hook before "see more" |
34| **Threads** | 500 chars | 400-500 | None | Conversational, no hashtags |
35| **Instagram** | 2,200 chars | Varies | 5-15 | Visual-first, line breaks |
36| **Facebook** | Unlimited | <250 | 2-3 | Community, engagement |
37
38## Content Type Router
39
40```
41What are you creating?
42│
43├─ X?
44│ ├─ Single insight/observation → x-posts.md
45│ ├─ Multi-part story/tutorial → x-threads.md
46│ └─ Content planning → x-strategy.md
47│
48├─ LinkedIn → linkedin.md
49│ └─ Professional, B2B, thought leadership
50│
51├─ Threads/Instagram → threads-instagram.md
52│ └─ Conversational, authentic, visual
53│
54├─ Facebook → facebook.md
55│ └─ Community, engagement, events
56│
57└─ Technical blog → technical-styles.md
58 ├─ Karpathy style (conversational, personal)
59 └─ Deep technical (opinion-forward, contrarian)
60```
61
62## Writing Workflow
63
64### 1. Select Platform & Format
65
66Choose based on:
67
68- **Audience**: Where do they spend time?
69- **Content depth**: Quick insight vs deep dive
70- **Goal**: Engagement, education, announcement
71
72### 2. Load Style Reference
73
74Before writing:
75
761. Read platform-specific guide
772. Read [ai-avoidance.md](references/ai-avoidance.md) — critical for human voice
783. Read [style-guide.md](references/style-guide.md) for tone
79
80### 3. Draft Content
81
82Apply platform constraints from start. Style informs structure.
83
84### 4. Quality Check
85
86Run through checklist below before posting.
87
88## Universal Quality Checklist
89
90### Voice
91
92- [ ] Sounds like a person, not AI?
93- [ ] Zero banned words (delve, unleash, harness, leverage)?
94- [ ] Zero em-dashes (—)?
95- [ ] Contractions used naturally?
96
97### Specificity
98
99- [ ] Includes names, numbers, tools, dates?
100- [ ] Concrete examples, not hypotheticals?
101- [ ] Would I bookmark this if someone else wrote?
102
103### Structure
104
105- [ ] Hook in first line?
106- [ ] Sentence lengths vary (5-40 words)?
107- [ ] Each paragraph/tweet can stand alone?
108
109### Value
110
111- [ ] Teaches something specific?
112- [ ] Actionable today?
113- [ ] From real experience?
114
115## X Quick Start
116
117### Single Post Pattern
118
119```
120[Hook - stop the scroll]
121
122[Context or specific detail]
123
124[Insight or learning]
125
126[Optional: engagement question]
127```
128
129**Example:**
130
131```
132Shipped curation v1 for agents.foo today.
133
134Discovery is way harder than app stores. Agents are conversations, not static features.
135
136Had to rebuild around context matching instead of keyword search.
137```
138
139### Thread Pattern
140
141```
1421/N [Bold hook - main insight] 👇
143
1442/N [Context or setup]
145
1463-N/N [Key points, one per tweet]
147
148N/N [Summary + CTA]
149```
150
151**Rules:**
152
153- First tweet MUST end with 👇 or 🧵 to signal thread
154- Use N/M numbering (1/7, 2/7... 7/7)
155- Each tweet must stand alone
156- Max 5-7 tweets (longer = blog post)
157
158## High-Engagement Content Patterns
159
160| Pattern | Structure | Best For |
161| ------------------------ | -------------------------------------------- | ------------------ |
162| **Shipped X, Learned Y** | What shipped + key learning + why it matters | Project updates |
163| **How to X** | Problem + steps + key insight | Tutorials |
164| **Problem → Solution** | Problem + failed attempts + what worked | Case studies |
165| **Contrarian** | Popular belief + why wrong + your evidence | Thought leadership |
166| **Tool Recommendation** | Tool + specific benefit + real example | Resources |
167
168## Content Selection: What to Share
169
170### Always Share ✓
171
172- Shipped work + learnings
173- Non-obvious insights
174- Tool recommendations with specifics
175- Solutions to common problems
176
177### Skip ✗
178
179- Generic progress updates
180- Plans before execution
181- Obvious observations
182- Engagement bait ("RT if you agree")
183- Vague hype
184
185## Critical Prohibitions
186
187- Do not use words: delve, unleash, harness, leverage, robust, seamless, game-changer, unlock
188- Do not use em-dashes (—) anywhere
189- Do not use "It's not X, it's Y" pattern
190- Do not ask for engagement ("RT if you agree", "What do you think?")
191- Do not use formal transitions (Furthermore, Moreover, Additionally)
192- Do not write uniform sentence lengths
193- Do not skip the hook
194
195## Links
196
197- [ai-avoidance.md](references/ai-avoidance.md) — Most important, read first
198- [hooks.md](references/hooks.md) — Hook patterns with examples
199- [x-strategy.md](references/x-strategy.md) — What to share
itechmeat