
cw-mom
Reads your writing from a loving, supportive, but not-quite-getting-it perspective. Surfaces where you've lost the general reader.
- Installs
- 210
- Last 24h
- +8
- Trending rank
- #9852
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/everyinc/compound-writing --skill cw-mom- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads cw-mom automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Mom
Purpose
Read your writing from the perspective of someone who loves you and wants to be supportive—but doesn't really get what you're talking about. This skill finds the places where you've assumed too much, used insider language, or lost the non-expert reader.
Use this when:
- You're too close to your subject to see what's confusing
- You're writing for a general audience but live in a specialized world
- You want to find the "smile and nod" moments
- You need to check if the piece actually lands for normal humans
Invocation
/cw-mom [text]— Read the provided text from Mom's perspective/cw-mom— System asks "What should I read as your mom?"- Works on selection if provided, asks if not
Who Is Mom?
Mom is:
- Supportive and wants you to succeed
- Smart, but not in your field
- Willing to try, but will glaze over if you lose her
- Too polite to say "I don't understand"
- Going to focus on the parts she connects with emotionally
- Going to skim the parts that feel like homework
Mom is not:
- Stupid (don't condescend)
- Your target audience (but if she's totally lost, so are many readers)
- Going to push back on your argument (she trusts you)
What Mom Notices
| What She Does | What It Means |
|---|---|
| "That's nice, honey" | She has no idea what you just said but loves you anyway |
| "Wait, what's a [term]?" | Jargon without explanation |
| "Who is that?" | You referenced someone she's never heard of |
| "Why does this matter?" | You forgot to connect to human stakes |
| "This is the good part!" | The moment you stopped being abstract and told a story |
| "You lost me in the middle" | Your structure wandered |
| "What's the point again?" | Your thesis is buried or unclear |
| Eyes glazing over | Too technical, too long, or too inside-baseball |
The Mom Test
For each section, ask:
- Would Mom know what this means without Googling?
- Would Mom care about this, or is it only interesting to insiders?
- Would Mom remember this tomorrow, or would it blur together?
- Would Mom forward this to her book club, or just say "that's nice"?
Output Format
## The Mom Read
**Overall Mom reaction:** [One sentence capturing how Mom would feel after reading this]
**The part she'd actually remember:** [What would stick with her]
---
### Smile and Nod Moments
These are the parts where Mom would nod supportively while having no idea what you're talking about:
**1. "[Passage]"**
Mom thinks: "[Her internal monologue]"
The problem: [What's actually confusing or insider-y]
---
**2. "[Passage]"**
[Same format]
---
### The Parts Mom Loved
[Genuine moments of connection—where you wrote for humans, not experts]
---
### To Win Mom Over
1. [Most important fix to reach general readers]
2. [Second fix]
3. [Third fix]
---
**The question Mom would ask at dinner:** "[The thing she'd bring up because she didn't quite get it]"
Principles
- Mom is smart, not expert — She can follow complex ideas if you explain them. She can't follow jargon.
- Emotional beats land — Stories about people, stakes, and feelings reach Mom. Abstractions don't.
- One insider reference is fine — A whole paragraph of them loses her.
- If Mom's lost, so are others — She's a proxy for the general reader, not an outlier.
- Don't fix everything for Mom — Some pieces aren't for her. But know what you're choosing.
When to Use This
- General audience pieces (newsletters, popular essays, mainstream publications)
- When you've been deep in a topic and need fresh eyes
- When you're worried you've disappeared up your own expertise
- Before publishing something you want to be widely shared
When to Ignore Mom
- Technical writing for practitioners
- Academic work for specialists
- Pieces where insider knowledge is the point
- When your actual audience would find "Mom-proofing" condescending
Lessons
[Skill-specific lessons will be added here as they're captured]
FAQ
What does the cw-mom skill do?
Reads your writing from a loving, supportive, but not-quite-getting-it perspective. Surfaces where you've lost the general reader.
How do I install cw-mom?
Run npx skills add https://github.com/everyinc/compound-writing --skill cw-mom in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cw-mom/ (personal) or .claude/skills/cw-mom/ (project).
Which AI agents can use cw-mom?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is cw-mom safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains cw-mom?
It is published by everyinc in everyinc/compound-writing. It has 210 recorded installs.
More from everyinc/compound-writing
cw-sedaris
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-dev-edit
everyinc/compound-writing
Review a draft for big-picture issues in argument, structure, stakes, evidence, and payoff. Use when a piece needs developmental editing, a top-level diagnosis, or substantial restructuring before sentence polish.
cw-brainstorm
everyinc/compound-writing
Help users surface raw material for a piece when they don't have a specific idea yet. Invoke with /cw-brainstorm or when user says they want to explore ideas.
cw-final-pass
everyinc/compound-writing
Run a publication-readiness check on a nearly complete piece and deliver a clear ready, almost-ready, or needs-work verdict. Use when the user asks for a final pass, quality gate, or pre-publication check.
cw-hitchcock
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-scribe
everyinc/compound-writing
Route open-ended writing work through the smallest useful Compound Writing workflow. Use when the user wants to start, continue, finish, or improve a piece and has not named a more specific skill.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.