writing
Developer Writing Playbook
Guidelines for creating technical content that developers can skim first and trust enough to finish.
Philosophy
- Reader-first - Lead with clarity and payoff; assume readers skim before committing
- Scannable - Clear headings, short paragraphs, purposeful emphasis
- Practical - State what the reader will achieve, then show how
- Concise - Keep pages performant with direct copy; avoid walls of text
- Consistent - Maintain brand voice, correct product names, and formatting patterns
Voice & Tone
- Friendly, practical, confident
- Write in first/second person ("I", "you")
- Use active voice and straightforward vocabulary
- Break complex ideas into shorter sentences
- Aim for ~65-character reading width
Quick Reference
| Task | Guide |
|---|---|
| Structural formatting rules | formatting.md |
When to Use Each Guide
Formatting
Use formatting.md when you need:
- Title and heading structure guidelines
- Paragraph and list formatting rules
- Intro and outro patterns
- SEO-aware keyword placement
More from mintuz/claude-plugins
gps-method
Evidence-based goal achievement framework using Goal, Plan, and System methodology. Use when users want to set goals, create actionable plans, build execution systems, or diagnose why they're struggling to make progress on existing goals. Triggers include requests to "set a goal", "help me achieve", "create a plan", "why am I not making progress", or similar goal-setting and achievement queries.
21app-store-scraper
>
19local-ai-models
Comprehensive guide for implementing on-device AI models on iOS using Foundation Models and MLX Swift frameworks. Use WHEN building iOS apps with (1) Local LLM inference, (2) Vision Language Models (VLMs), (3) Text embeddings, (4) Image generation, (5) Tool/function calling, (6) Multi-turn conversations, (7) Custom model integration, or (8) Structured generation.
17web-design
WHEN refining UI layout, typography, color, or polish; NOT code implementation; provides concise principles for intentional, legible design.
17eyes
WHEN users express dissatisfaction with visual appearance or behavior; use Playwright MCP to capture screenshots and collaborate on UI fixes with a structured feedback loop.
13react-testing
WHEN testing React components/hooks/context with React Testing Library; NOT e2e; covers renderHook, providers, forms, and anti-patterns.
12