writing-coach

📁 sunnypatneedi/claude-starter-kit 📅 Jan 27, 2026
3
总安装量
2
周安装量
#57369
全站排名
安装命令
npx skills add https://github.com/sunnypatneedi/claude-starter-kit --skill writing-coach

Agent 安装分布

mcpjam 2
neovate 2
gemini-cli 2
antigravity 2
windsurf 2
zencoder 2

Skill 文档

Writing Coach

Complete framework for writing clearly, editing ruthlessly, and communicating ideas with maximum impact.

When to Use

  • Writing emails, documents, or reports
  • Editing drafts for clarity and impact
  • Improving writing style
  • Overcoming writer’s block
  • Learning to write for specific audiences
  • Developing consistent writing habits

Core Writing Principles

Clarity First:

BEFORE: "It is important to note that the implementation of the new
         system will be occurring in the near future."

AFTER:  "We're launching the new system next month."

One Idea Per Sentence:

BAD:  "The project was delayed because the vendor didn't deliver on
       time and we had to find a new supplier, which took two weeks,
       and then there were quality issues."

GOOD: "The project was delayed by four weeks. Our vendor missed their
       delivery date. Finding a replacement took two weeks. Quality
       issues caused another two-week delay."

Active Voice > Passive Voice:

PASSIVE: "The report was written by Sarah."
ACTIVE:  "Sarah wrote the report."

PASSIVE: "Mistakes were made."
ACTIVE:  "We made mistakes."

Workflow

Step 1: Pre-Writing (Clarify Your Thinking)

Before writing a single word, answer:

## Writing Brief

**Purpose**: Why am I writing this?
- [ ] To inform
- [ ] To persuade
- [ ] To instruct
- [ ] To entertain

**Audience**: Who will read this?
- Role:
- Knowledge level:
- What they care about:
- What they need to know:

**Key Message**: If they remember one thing, what should it be?
[One sentence]

**Desired Outcome**: What should happen after they read this?
[Specific action or understanding]

**Constraints**:
- Length: [Word count or time to read]
- Tone: [Formal / Casual / Technical / Friendly]
- Format: [Email / Report / Article / Docs]

Example:

Purpose: Persuade stakeholders to approve project
Audience: Executive team (busy, non-technical, care about ROI)
Key Message: This project will save $200K annually
Desired Outcome: Approval to proceed
Constraints: 1-page summary, professional tone

Step 2: Structure First (Pyramid Principle)

Lead with the conclusion, then support it.

STRUCTURE:
1. Main point (conclusion)
2. Supporting argument 1
3. Supporting argument 2
4. Supporting argument 3
5. Evidence for each

NOT:
1. Background
2. History
3. Context
4. Analysis
5. Finally, the point (reader already lost)

Email Structure Example:

Subject: [Action needed] [Topic] by [Date]

Hi [Name],

[Main point: What you need and by when]

[Background: Why this matters - keep short]

[Next steps: Specific actions]

Thanks,
[Name]

Document Structure Example:

## Executive Summary
[Key point in 2-3 sentences - the conclusion]

## Background
[Just enough context for the reader to understand]

## Analysis/Findings
[Your work, organized logically]

## Recommendation
[What you think should happen]

## Next Steps
[Specific actions, owners, dates]

Step 3: Write the Terrible First Draft

Permission to write badly:

RULE: Your first draft's job is to exist, not to be good.

DO:
- Write without editing
- Get all ideas down
- Don't worry about word choice
- Keep momentum
- Write badly on purpose

DON'T:
- Edit as you write
- Delete anything
- Worry about perfection
- Stop to look things up (mark with [TK])

Overcoming Writer’s Block:

Technique 1: Brain Dump

Set timer for 10 minutes.
Write everything you know about the topic.
No structure, no quality filter.
Just dump it all on the page.

Technique 2: Talk It Out

Imagine explaining to a friend.
Record yourself talking through the topic.
Transcribe (or use voice-to-text).
Edit the transcript.

Technique 3: Start in the Middle

Can't write the intro? Skip it.
Write the easiest section first.
Build momentum.
Come back to hard parts.

Step 4: Edit Ruthlessly (Three-Pass System)

Pass 1: Structure (The Big Picture)

## Structural Edit Checklist

**Opening:**
- [ ] Does it hook the reader?
- [ ] Is the main point clear in first paragraph?
- [ ] Would a busy person keep reading?

**Body:**
- [ ] Does each section have one clear purpose?
- [ ] Is the flow logical?
- [ ] Are there gaps in logic?
- [ ] Is anything out of order?

**Closing:**
- [ ] Does it reinforce the main point?
- [ ] Are next steps clear?
- [ ] Does it leave the reader satisfied?

**Cut Ruthlessly:**
- [ ] Does every section serve the purpose?
- [ ] What can be removed without losing meaning?

Pass 2: Clarity (Line-by-Line)

## Clarity Edit Checklist

**Sentences:**
- [ ] Can any sentences be split? (1 idea per sentence)
- [ ] Are there words that can be cut?
- [ ] Is jargon necessary or can it be simplified?
- [ ] Are pronouns clear? (what does "it" refer to?)
- [ ] Are transitions smooth?

**Paragraphs:**
- [ ] One main idea per paragraph?
- [ ] Is the first sentence a clear topic sentence?
- [ ] Do sentences flow logically?

**Word Choice:**
- [ ] Are verbs active, not passive?
- [ ] Are nouns concrete, not abstract?
- [ ] Is language simple and direct?

Common Clarity Fixes:

Weak Strong
“It is believed that…” “We believe…”
“There are many ways to…” “You can…”
“In order to” “To”
“At this point in time” “Now”
“Due to the fact that” “Because”
“In the event that” “If”
“Has the ability to” “Can”
“Make a decision” “Decide”
“Utilize” “Use”
“Facilitate” “Help”

Vague → Specific:

Vague Specific
“Soon” “By Friday”
“Many” “47”
“Significant improvement” “30% faster”
“Various factors” “Cost, timeline, and quality”
“In the near future” “Next month”

Pass 3: Style (Polish)

## Style Edit Checklist

**Voice:**
- [ ] Is the voice consistent?
- [ ] Is the tone appropriate for the audience?
- [ ] Does it sound like a human wrote it?

**Rhythm:**
- [ ] Do I vary sentence length?
- [ ] Does it read well aloud?
- [ ] Are there any awkward phrases?

**Polish:**
- [ ] Is there unnecessary repetition?
- [ ] Are transitions smooth?
- [ ] Does every word earn its place?

**Final Check:**
- [ ] Read aloud (catches awkward phrasing)
- [ ] Print and read on paper (see with fresh eyes)
- [ ] Have someone else read it (get feedback)

Step 5: Style by Context

Technical Writing:

GOALS: Accuracy, clarity, completeness

DO:
- Define terms on first use
- Use consistent terminology
- Include examples
- Show, don't just tell
- Use code blocks, diagrams
- Prioritize accuracy over elegance

EXAMPLE:
"The API endpoint `/users/:id` accepts a GET request and returns
a user object. The `:id` parameter is the user's unique identifier.

Example request:
GET https://api.example.com/users/123

Example response:
{
  "id": 123,
  "name": "John Doe",
  "email": "john@example.com"
}"

Business Writing:

GOALS: Clarity, brevity, action

DO:
- Lead with the ask
- Keep it short (1 page max for most docs)
- Use bullet points
- End with clear next steps
- Make it skimmable

EXAMPLE:
"We need $50K to hire 2 engineers by Q2.

Benefits:
• Ship product 2 months faster
• Reduce technical debt
• Hit revenue target

Next steps:
• Finance review budget (Jane, by March 1)
• Post job listings (Tom, by March 5)
• Begin interviews (Team, March 15)"

Persuasive Writing:

GOALS: Convince, motivate action

STRUCTURE:
1. Open with their problem
2. Present your solution
3. Provide evidence
4. Address objections
5. Call to action

EXAMPLE:
"You're losing $10K/month to manual processes. [Problem]

Our automation tool eliminates 80% of manual work. [Solution]

Companies like yours saw ROI in 6 weeks. [Evidence]

Yes, it requires training, but we provide onboarding support. [Objection]

Let's schedule a demo this week. [CTA]"

Writing Templates

Email Template (Professional)

Subject: [Specific topic] - [Action if needed]

Hi [Name],

[Purpose in one sentence]

[Context in 2-3 sentences if needed]

[Request or information]

[Next steps or CTA]

Best,
[Your name]

Email Template (Request)

Subject: Request: [What you need] by [When]

Hi [Name],

Quick request: [Specific ask]

Context: [Why you need it, why it matters]

This would help by: [Benefit to them or shared goal]

Timing: [When you need it, any flexibility]

Let me know if you have questions.

Thanks,
[Name]

Document Template

# [Title]

## Summary
[3 sentences: What, Why, So What]

## Background
[Just enough context]

## Details
### Section 1
[Point, evidence, example]

### Section 2
[Point, evidence, example]

## Conclusion
[Reinforce main point]

## Next Steps
- [ ] Action 1 - Owner - Date
- [ ] Action 2 - Owner - Date

Feedback Template

## Feedback on [Document]

### What's Working
- [Specific positive 1]
- [Specific positive 2]

### Suggestions for Improvement
- [Specific suggestion 1 with example]
- [Specific suggestion 2 with example]

### Questions for Clarification
- [Question 1]
- [Question 2]

Common Writing Mistakes

Don’t Do
Edit while drafting Draft first, edit later
Bury the lede Lead with the main point
Use passive voice Use active voice
Use jargon unnecessarily Use plain language
Write long paragraphs Keep paragraphs 3-5 sentences
Use weak verbs (“is”, “was”) Use strong verbs
Be vague (“soon”, “many”) Be specific (“Friday”, “47”)
Assume reader has context Provide necessary background
Write like you talk Write like you talk, then edit

Writing Habit System

Daily Writing Practice:

## 30-Day Writing Challenge

**Goal**: Write every day for 30 days

**Week 1: Quantity**
- Write 250 words/day
- Any topic
- Don't edit
- Build the habit

**Week 2: Clarity**
- Write 250 words/day
- Edit for clarity
- Remove jargon
- One idea per sentence

**Week 3: Style**
- Write 250 words/day
- Vary sentence length
- Use active voice
- Read aloud

**Week 4: Purpose**
- Write 250 words/day
- Write for specific audience
- Have clear purpose
- Get feedback

**Track Progress:**
Day 1: ✅
Day 2: ✅
...

Tools & Resources

Writing Tools:

  • Hemingway Editor (readability scoring)
  • Grammarly (grammar and tone)
  • Notion / Google Docs (drafting)
  • iA Writer (distraction-free writing)

Reading for Writers:

  • “On Writing Well” by William Zinsser
  • “The Elements of Style” by Strunk & White
  • “Bird by Bird” by Anne Lamott
  • “On Writing” by Stephen King

Practice:

  • Write every day (even 100 words)
  • Read good writing in your field
  • Analyze what makes it work
  • Get feedback on your writing

Related Skills

  • /learning-coach – Improve faster with deliberate practice
  • /copywriter – Writing for marketing and persuasion
  • /habit-design – Build consistent writing habits

Last Updated: 2026-01-22