Writing

Setup

On first use, read setup.md for integration guidelines.

When to Use

User needs writing help: drafting, editing, feedback, or style adaptation. Agent remembers their voice and preferences across sessions.

Architecture

Writing preferences persist in ~/writing/ with tiered structure. See memory-template.md for setup.

~/writing/
├── memory.md      # HOT: voice, style, active preferences
├── projects/      # Per-project voice (blog, newsletter, book)
└── archive/       # COLD: decayed patterns

Quick Reference

Detection Triggers

Activate automatically when you notice these patterns:

Help requests → engage writing mode:

• "Can you help me write..."

• "I need to draft..."

• "How does this sound?"

• "Can you edit this?"

• "Make this clearer"

• "Fix my writing"

Voice signals → save to memory.md Voice:

• "I like when you write..."

• "My style is..."

• "I always write like..."

• "Never use X in my writing"

• "Too formal/casual for me"

Format preferences → save to memory.md Formats:

• "For my blog, I..."

• "In emails, I prefer..."

• "Academic papers need..."

• "Marketing copy should..."

Corrections → evaluate for memory:

• "No, that's not my voice"

• "I would never say it like that"

• "Too wordy/short/formal/casual"

• "Change X to Y — that's how I write"

Quick Queries

Core Rules

1. Check Memory First

Read ~/writing/memory.md before any writing task. Apply their documented voice, formats, and preferences.

2. Learn Voice from Examples

When user shares their writing:

1. Read it carefully before responding

2. Note tone, cadence, vocabulary, sentence length

3. Match these patterns in your output

4. Ask: "Does this sound like you?"

3. Never Impose Style

4. Clarity Over Cleverness

• One idea per paragraph

• Simple sentences beat complex ones

• Cut words that add no meaning

• Read aloud to catch awkwardness

5. Context-Aware Writing

6. Edit in Passes

7. Tiered Storage

8. Automatic Promotion/Demotion

• Preference used 3x in 7 days → promote to HOT

• Preference unused 30 days → demote to WARM

• Preference unused 90 days → archive to COLD

• Never delete without asking

9. Transparency

• Cite memory when applying preferences: "Using casual tone (from memory.md)"

• Explain edits when requested

• Show what you learned after sessions

Common Traps

• Imposing your style → Match their voice first, always

• Over-editing → Preserve their personality, don't sanitize

• Passive voice everywhere → Use active by default unless they prefer passive

• Ignoring context → Email differs from blog differs from paper

• Forgetting their preferences → Check memory.md every time

• Assuming formal is correct → Their style IS correct for them

Security & Privacy

Data that stays local:

• Writing preferences in ~/writing/

• Voice patterns and style notes

• Project-specific preferences

This skill does NOT:

• Store written content (only preferences)

• Make network requests

• Access files outside ~/writing/

• Share preferences externally

Related Skills

Install with clawhub install <slug> if user confirms:

• grammar — spelling and grammar checks

• text — text processing and manipulation

• content-marketing — content strategy and creation

Feedback

• If useful: clawhub star writing

• Stay updated: clawhub sync