Arriving together
Apply the "arriving together" framework for clear, reader-first writing. Use this skill whenever the user asks for help with expository or nonfiction writing, wants feedback on whether their writing is clear, asks why something they wrote feels confusing or hard to follow, wants to revise a draft for clarity, or asks how to explain something to a non-expert audience. Also trigger when the user shares a draft and asks "does this make sense?" or "is this too dense?" or "am I assuming too much?" This skill applies whether the writing is technical documentation, a memo, an essay, a report, or any prose meant to inform or explain.From its SKILL.md
npx -y skills add mehrlander/web-tools --skill arriving-togetherAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.6 KB, as published. Nobody here has run it
Arriving Together: A Framework for Reader-First Writing
Psychologists refer to the curse of knowledge: once you know something, you lose reliable access to what it felt like not to know it. The underlying skill is holding two models in your head simultaneously: what you know, and what your reader knows.
The Four Elements of Good Contextualization
When reviewing or producing writing, check for all four:
1. Announce the topic. Before saying anything about a thing, say what the thing is and why it matters right now. "Here is a tool. Here is the problem it solves. Here is why you will need it." That sequence is load-bearing, not padding.
2. Establish stakes. A reader will not retain information they have no reason to care about. What breaks if they don't know this? Stakes don't have to be dramatic, but they must be present.
3. Signal structure. Small orientation phrases ("one gotcha," "three things to know") tell the reader what kind of thing follows and where they stand in the argument. Use them.
4. Earn transitions. Every paragraph should feel pulled into existence by what came before it. In conversation, the listener can interrupt and ask. In writing there is no such escape valve.
The Prior Question: Is the Gap Crossable?
Before applying the four elements, ask whether adequate context is even possible within this piece. Sometimes a topic sits so far downstream from the reader's experience that the context required would demand an earlier, different essay. The writer who senses this and pushes forward anyway, piling in qualifications and parenthetical explanations, is not contextualizing. They are procrastinating on a structural decision.
The graceful resolution is not the academic disclaimer ("beyond the scope of this paper"), which is an apology. It is a confident pivot: name the boundary, gesture at what lies beyond it, and return the reader to the work at hand.
Principled vs. Evasive Omission
Hemingway: a writer can leave out anything they truly understand, and the absence strengthens the work. McPhee called the underlying discipline selection: not what is true or interesting in the abstract, but what the piece can hold.
Review Questions
Work through these when reviewing or producing a draft:
- Does the opening say what this is and why it matters, before the first substantive claim?
- What breaks if the reader doesn't know this? Are those stakes visible?
- Can the reader track where they are in the argument at all times?
- Does each transition feel pulled forward by what came before it?
- For each term, ask not whether the reader knows what it means, but whether they can be confident on what it means here.
- When a point needs more context than the piece can hold, narrow it, reframe it, or let it go.
Reference
The essay "The Art of Arriving Together" is the source document for this skill and can be shared with users who want the full articulation of these ideas.