writing-helper

Writing Helper

Claude Code skills that help you communicate more effectively using established communication frameworks.

Two modes: coaching (apply a framework to your draft right now) and practice (learn frameworks through deliberate exercises so you can apply them yourself).

Inspired by Learning Opportunities

The practice mode in this project is inspired by Dr. Cat Hicks' Learning Opportunities plugin for Claude Code. Her work applies peer-reviewed learning science to AI-assisted workflows -- showing that the conditions which make learning slower in the short term (prediction, generation, retrieval) produce better long-term retention and transfer. We adapted her techniques from the coding domain to written communication: the same risks she identified (fluency illusion, suppressed metacognition, blocked transfer) apply when AI rewrites your prose. If you're interested in evidence-based skill development with AI tools, start with her plugin and PRINCIPLES.md.

Install

Requires Claude Code. Run these commands inside Claude Code:

/plugin marketplace add virginiais4lovers/writing-helper
/plugin install writing-helper@virginiais4lovers-writing-helper

Or just run /plugin and use the interactive Discover tab to browse and install.

Once installed, the skills are available as slash commands in any project. No need to clone this repo.

Coaching Skills

Apply a framework directly to a piece of writing you're working on:

Skill	Framework	Best for
/ladder-of-inference	Chris Argyris' Ladder of Inference	Examining assumptions, making reasoning transparent
/pyramid-principle	Barbara Minto's Pyramid Principle	Structuring documents and presentations logically
/scqa	Situation-Complication-Question-Answer	Framing problems, writing proposals, creating buy-in
/bluf	Bottom Line Up Front	Making writing direct for busy/senior audiences
/nvc	Marshall Rosenberg's Nonviolent Communication	Feedback, disagreements, difficult conversations

Examples

/pyramid-principle Here's my draft email to the VP about the Q2 roadmap...
/nvc I need to give feedback to a teammate who keeps missing deadlines
/bluf [paste your draft]
/scqa I'm writing a proposal to switch our deployment process
/ladder-of-inference [paste an argument you're making]

Each skill analyzes your writing through the framework's lens, diagnoses specific issues, and suggests concrete revisions with before/after examples. If you invoke a skill without a draft, it guides you interactively.

Practice Skill

Learn and internalize the frameworks through interactive exercises grounded in learning science:

/writing-practice pyramid
/writing-practice nvc
/writing-practice bluf

The practice skill uses evidence-based learning techniques adapted from Dr. Cat Hicks' Learning Opportunities framework (CC-BY-4.0). Instead of just applying frameworks for you, it builds genuine communication skill through:

• Prediction -- "What do you think the main issue is?" (then analyze together)
• Generation -- "Try rewriting this yourself first" (then compare)
• Reflection -- "What surprised you? What matched your intuition?"
• Self-testing -- "Explain this framework as if I'm a colleague who's never heard of it"

Why practice matters

AI tools can rewrite your text to be clearer, but that creates a fluency illusion -- the polished output feels like understanding, but you may not be able to produce it yourself next time. The practice skill addresses this by making you do the thinking, with feedback that helps you improve.

How Coaching and Practice Work Together

You have writing to improve
        |
        v
  Coaching Skill (/bluf, /pyramid-principle, etc.)
  Applies framework, suggests revisions
        |
        v
  "Want to practice what we just used?"
        |
        v
  Practice Skill (/writing-practice)
  Exercises build understanding of WHY the revisions work
        |
        v
  Next time: you apply the framework independently

• Coaching skills are for when you have real writing to improve right now
• Practice skill is for when you want to learn the frameworks so you can apply them yourself
• After a coaching session, use practice to reinforce why the changes worked
• After a practice exercise, use the coaching skill on real work to apply what you learned

Framework Selection Guide

Not sure which framework to use?