x-writing

# X Writing Skill

## Overview

Transform your notes, work updates, and observations into engaging X (Twitter) content. This skill analyzes your notes to identify the most shareable insights, then crafts authentic posts that match your voice and drive engagement.

**Supports macOS Notes integration** - Automatically fetch ideas from your Notes app to draft posts.

## Process

### Phase 1: Preparation and Analysis

**1.1 Load Writing Guides (REQUIRED - Load First)**

Before any other work, read ALL THREE reference files:

1. **Growth Principles** (`references/x-strategy.md`) - Content selection criteria, what makes posts shareable, engagement patterns, and what to prioritize from notes. This guides WHAT to share.

2. **Style Guide** (`references/style-guide.md`) - Voice, tone, structure, banned phrases, and signature patterns. This guides HOW to share it.

3. **Anti-Patterns** (`references/anti-patterns.md`) - AI writing patterns to avoid. Critical for ensuring posts sound human and authentic, not AI-generated. Avoid patterns like "It's not X, it's Y", formal transitions, hedging language, and AI-specific vocabulary.

**PRIORITY RULE**: When guides conflict, `references/x-strategy.md` wins. Content value and shareability take precedence over stylistic preferences.

**1.2 Understand the Source Material**

Get clarity on what notes to work with:

- Ask which notes, ideas, or updates they want to transform into posts
- **macOS Notes Integration**: When the user asks to "look in my notes" or "fetch from Notes", use `scripts/fetch-notes.sh get` to pull content from their configured Notes app note (default: "Tweets")
- Read the source material (markdown files, text, pasted content, or Notes app content)
- Identify the core insights, learnings, or updates
- Note any specific tools, projects, numbers, or details mentioned

**Using macOS Notes Integration:**
```bash
# Fetch content from default note (configured in .env.local)
./scripts/fetch-notes.sh get

# Fetch content from