Install
openclaw skills install bookforge-concrete-language-rewriterRewrite abstract, theoretical, or jargon-heavy passages into sensory, schema-based language the audience can already picture — using three named techniques (schema tap, high-concept pitch, generative analogy). Use this skill whenever a draft sounds abstract, strategy-level, or theoretical and the user wants it grounded in concrete imagery the reader can see, hear, touch, or do. Activate when the user says "this sounds abstract", "make it more concrete", "feels jargon-y", "how do I explain this", "rewrite this pitch", "too theoretical", "simplify the language", "ground this", "make it tangible", "the reader can't picture it", "I'm stuck at the strategy level", "translate this into plain language", "make this vivid", "needs an analogy", "give me a one-liner pitch", "explain this to a 5-year-old", "we need a metaphor for this", or provides an abstract passage plus an audience and asks to concretize it. Also triggers when a mission statement, value prop, policy memo, product page, cultural value, onboarding doc, or training scenario reads like a thesaurus of abstractions (synergy, excellence, alignment, optimize, empower, leverage, robust, scalable, best-in-class). The skill does NOT invent fake sensory details to ground a claim the user has not actually made, does NOT score the whole SUCCESs rubric (that is the stickiness-audit skill), and does NOT write full narrative stories (that is the story-framing skill) — it produces a side-by-side before/after rewrite of each flagged abstract passage with the technique used and why.
openclaw skills install bookforge-concrete-language-rewriterYou have a draft — a pitch, value prop, mission statement, explainer, internal memo, training doc, or product page — containing passages that sound abstract, theoretical, or jargon-heavy. The user wants those passages rewritten into sensory, schema-based language the audience can already picture. Before starting, confirm: (1) which passages are to be rewritten (user-flagged or agent-flagged), (2) who the audience is and what reference points they already share, (3) whether the user wants a one-shot pitch (high-concept), an idea that keeps producing behavior (generative analogy), or fast comprehension (schema tap).
The core mechanic: abstract ideas only stick when they hook onto concrete things already in the reader's memory (the "Velcro theory of memory" from Chapter 3). The more sensory hooks, the better the retention. "White things" is vague; "white things in your refrigerator" is concrete. This skill turns the first into the second.
audience-profile.md, brief.md, persona.md
-> If still missing, ask: "Who is the audience? What do they already know and see every day that I can anchor this to?"draft.md, existing-copy.md, core-message.md
-> If unavailable: work from the single passage provided.SUFFICIENT: passage + audience schemas known PROCEED WITH DEFAULTS: passage known, audience assumed as "intelligent non-expert" (noted in output) MUST ASK: no passage provided
ACTION: Read the draft and mark every passage that is (a) a pure abstraction with no sensory anchor, or (b) strategy-level language that does not specify observable behavior. Output a numbered list of flagged passages. If the user already flagged specific passages, use their list and skip scanning.
WHY: Rewrites fail when applied to the wrong target. Concrete language is not always better — a correctly concrete sentence should be left alone. Flagging first forces an explicit decision about what actually needs work and produces an auditable list the user can challenge before any rewriting starts.
Flag tests (any one triggers a flag):
synergy, excellence, innovation, alignment, value, quality, empowerment, transformation, optimization.Artifact: flagged-passages.md — numbered list with the verbatim text of each flagged passage.
ACTION: For each flagged passage, choose ONE of three techniques based on the decision rule below. Record the choice and the one-sentence reason.
WHY: The three techniques are not interchangeable — they solve different problems. Schema tap is for explaining what a thing is in under five seconds. High-concept pitch is for positioning a new thing relative to two familiar things. Generative analogy is for seeding a mental model that will keep producing decisions long after the user stops reading. Mixing them up produces rewrites that are clever but do not fit the job.
Decision rule:
| If the user needs... | Use | Why |
|---|---|---|
| Quick comprehension ("what IS this thing?") | Schema tap | Leverages one existing schema the audience already owns |
| A one-shot positioning pitch ("how is this different?") | High-concept pitch | Combines two schemas to place a new idea at their intersection |
| Behavior that keeps aligning after the message is delivered | Generative analogy | Seeds a frame that the audience re-uses to make new decisions autonomously |
IF the passage is a product tagline, cold-open, or elevator line -> High-concept pitch ELSE IF the passage is a cultural value, onboarding frame, or ongoing team norm -> Generative analogy ELSE -> Schema tap
Artifact: Extend flagged-passages.md with a technique:, why:, and canonical exemplar: line under each entry.
MANDATORY — name the lineage. Every rewrite must cite BOTH (a) the technique used, and (b) the closest canonical exemplar from Made to Stick that the rewrite echoes. This is not optional decoration — it is how the user builds the catalog mentally while using the skill, and how a reviewer can trace the rewrite back to the book's proven patterns. Use this map:
| Technique | Canonical exemplars from the book (pick the closest fit) |
|---|---|
| Schema tap | the pomelo example (grapefruit crossed with a football); Aesop's Fox & the Grapes (parable as packed schema) |
| High-concept pitch | "Die Hard on a bus" (the movie Speed); other "X meets Y" Hollywood pitches |
| Generative analogy | Disney "cast members" (theme park as stage production); Kris & Sandy (accounting class reframed as investigative journalism) |
| Behavior-level swap | Boeing 727 constraint ("seat 131 passengers, fly Miami–NYC nonstop, land on La Guardia Runway 4-22"); Jane Elliott's blue-eyes / brown-eyes exercise (felt experience replaces lecture) |
Every rewrite's output row MUST carry a phrase like "Schema tap — like the pomelo example" or "Generative analogy — like Disney cast members".
ACTION: If the chosen technique is schema tap, find one thing the audience already owns in memory that shares the most critical feature of the abstract idea, then describe the abstract idea in terms of that thing plus a minimal delta.
WHY: A new abstraction with zero sensory hooks fails to stick regardless of how accurately it is stated. Tapping an existing schema inherits all of the hooks from the familiar thing for free — the reader does not have to build new memory, only modify existing memory.
Template: {new thing} is like {familiar thing} except {one delta}.
Example — pomelo: Instead of "a large citrus fruit native to Southeast Asia with a thick rind and mild flavor", say "a pomelo is a grapefruit crossed with a football." The reader owns both "grapefruit" and "football" — size, shape, and category arrive in one sentence.
Checklist for a good schema tap:
ACTION: If the chosen technique is a high-concept pitch, find two familiar things from the audience's cultural library whose intersection captures the new idea, and write it as "{familiar thing A} meets {familiar thing B}" or equivalent.
WHY: High-concept pitches are the Hollywood trick: they let a producer green-light a new project in 30 seconds because both reference points are already fully loaded in the audience's head. The pitch is doing the work of a five-paragraph positioning statement by paying in two words of borrowed context.
Templates:
{A} meets {B}{A} for {new domain}The {A} of {new domain}{A}, but {B}Example — "Die Hard on a bus": The movie Speed was pitched as "Die Hard on a bus." Both reference points are concrete and already loaded in every producer's head (action-hero hostage thriller + claustrophobic single-location constraint). The audience knew the genre, the pacing, and the stakes immediately.
Checklist for a good high-concept pitch:
ACTION: If the chosen technique is a generative analogy, choose a source frame whose internal vocabulary, roles, and daily actions will re-apply to the target domain in ways that keep generating decisions after the message is stated. Then rewrite the passage to install the analogy and, optionally, list 2–4 specific objects or actions it renames.
WHY: Generative analogies are the highest-leverage concrete technique because the analogy keeps doing work after the user is gone. A good generative analogy lets frontline employees make dozens of small decisions correctly without ever checking back with a manager — the frame tells them what to do.
Example — Disney "cast members": Disney reframed the theme park as a stage production. Employees became "cast members", customers became "guests", uniforms became "costumes", walking areas became "onstage" vs "backstage". An 18-year-old hired last week knows — without being told — that you do not step "offstage" in costume, that you perform your role even on a bad day, and that guests are your audience, not your transaction counterparty. The analogy generates the policy for situations no handbook covered.
Checklist for a good generative analogy:
ACTION: For flagged passages that describe a strategy or goal rather than a schema — e.g., "be the leading provider of X" — do not apply an analogy. Instead, rewrite the passage as a measurable constraint or observable behavior. Replace quality adjectives with numbers, dates, or named actions.
WHY: Strategy-level statements ("be the best", "excellence in Y", "world-class Z") do not coordinate behavior because they cannot be pictured, measured, or disputed. A concrete constraint can be shared across teams that never meet — it acts as a self-coordinating reference point. This is why Boeing's 727 design goal was "seat 131 passengers, fly nonstop Miami–NYC, land on La Guardia Runway 4-22" rather than "best passenger plane in the world". Thousands of engineers across specialties could self-coordinate from the constraint; no one could coordinate from the adjective.
Transform:
best -> under 200ms p95)empower our users -> every user can publish without asking support)alignment -> everyone writes the same one-sentence answer when asked what we are building)ACTION: Write the final artifact as a side-by-side before/after table (or structured markdown), with technique, canonical exemplar, rationale, and any caveats. For each flagged passage, include:
Table form (REQUIRED columns): Every side-by-side table must have four columns:
| Original | Rewrite | Technique | Canonical Exemplar |
|---|
The Canonical Exemplar column is non-optional — a row missing it is an incomplete deliverable and must be rejected during Step 8.
WHY: A rewrite without the reasoning is a magic trick — the user cannot apply it to the next passage, and cannot tell whether to accept or reject it. Showing the technique and its rationale turns the deliverable from a one-shot fix into a teachable artifact.
Artifact: concrete-rewrite.md — see template in references/output-template.md.
ACTION: Re-read each rewrite and verify that no sensory detail was invented to prop up a claim the original did not make. If a rewrite added a number, a name, a physical feature, or a specific example that is not in the source material or the user's knowledge, either flag it as [assumption — verify] or remove it.
WHY: Concrete language can become a lie if it invents specifics the user cannot defend. "We serve 10,000 customers daily" is concrete and sticky — and catastrophic if the user only has 400 customers. This skill is explicitly out-of-scope for fabricating details; Step 8 is the enforcement step. A rewrite that needs invented detail means the user must supply the detail or the technique was wrong.
IF any rewrite contains fabricated specifics -> mark [assumption — verify] inline or replace with a schema tap that uses only the audience's existing knowledge
ELSE -> mark the artifact complete.
flagged-passages.md — numbered list of abstract passages with assigned technique and reason.concrete-rewrite.md — the side-by-side deliverable. Template:# Concrete Rewrite
Audience: {audience description}
## Summary table
| Original | Rewrite | Technique | Canonical Exemplar |
|---|---|---|---|
| {verbatim original} | {rewrite} | {schema tap / high-concept pitch / generative analogy / behavior-level swap} | like {pomelo / Disney cast members / Die Hard on a bus / Boeing 727 runway constraint / Jane Elliott blue-eyes / Kris & Sandy / Aesop's Fox & the Grapes} |
## Passage 1
**Technique:** {schema tap | high-concept pitch | generative analogy | behavior-level swap}
**Canonical exemplar:** like {pomelo example | Disney cast members | Die Hard on a bus | Boeing 727 runway constraint | Jane Elliott blue-eyes exercise | Kris & Sandy | Aesop's Fox & the Grapes}
**Before:**
> {verbatim original}
**After:**
> {rewrite}
**Why this works:** {one line — which existing hook(s) the rewrite taps, and how it echoes the exemplar's pattern}
**Caveats:** {any `[assumption — verify]` flags, or "none"}
## Passage 2
...
Scenario: abstract value proposition for a developer tool
Trigger: User says "our landing page hero feels too abstract — it says 'unified observability platform for cloud-native workloads' and nobody gets it. Audience: backend engineers at mid-size startups."
Process: (1) Flag the passage — "unified observability platform for cloud-native workloads" is three stacked abstractions. (2) Choose high-concept pitch — it is a product tagline. (3) Rewrite: "Datadog for teams that can't afford Datadog" — two familiar reference points (known product + known pain), instant positioning. (4) Self-check: "can't afford Datadog" is a claim about audience economics, not about our product — safe.
Output: concrete-rewrite.md row — Technique: high-concept pitch; Canonical exemplar: like "Die Hard on a bus" (the Speed pitch); Rationale: "leverages the audience's existing schema of Datadog and its known price-point pain, placing the new product at a specific intersection in one breath — the same two-schema collision trick that let a Hollywood producer green-light Speed in 30 seconds."
Scenario: mission statement for customer support reorg
Trigger: User shares a draft values doc: "We aim to empower partnership-oriented interactions that drive mutual long-term value with our customer community." Audience: customer support agents.
Process: (1) Flag — entire sentence is strategy-level abstraction with zero behavior. (2) Choose generative analogy — it is meant to shape ongoing behavior, not a one-shot pitch. (3) Rewrite: reframe support agents as "co-pilots, not gate agents." List renames: tickets -> "missions", SLAs -> "flight plans", escalations -> "hand-offs to the captain". (4) Self-check — no invented facts; all renames are metaphor, not claim.
Output: concrete-rewrite.md row — Technique: generative analogy; Canonical exemplar: like Disney "cast members" (theme park as stage production); Rationale: "the co-pilot frame keeps generating decisions the way Disney's cast-member frame tells a brand-new hire they do not step offstage in costume — a co-pilot does not close a mission before the captain lands safely, which maps to 'do not close a ticket until the customer confirms resolution.' Daily vocabulary (tickets -> missions, SLAs -> flight plans, escalations -> hand-offs) renames at least 3 objects, clearing the Disney-style test from Step 5."
Scenario: training material for new product managers
Trigger: User asks, "How do I teach new PMs what it feels like when another team blocks their work? It keeps coming out as a lecture about stakeholder alignment."
Process: (1) Flag — "stakeholder alignment" is the core abstraction. (2) Choose schema tap — the goal is comprehension, not positioning. (3) Rewrite: design a short in-class simulation modeled on Jane Elliott's blue-eyes/brown-eyes exercise (Chapter 3) — split the PMs into two teams, give team A the tooling and team B the deadline, force team B to request every build from team A for 20 minutes. (4) Self-check — simulation rules are concrete and can be run with no invented facts about the PMs.
Output: concrete-rewrite.md row — Technique: schema tap (delivered as a felt experience); Canonical exemplar: like Jane Elliott's blue-eyes / brown-eyes exercise (Chapter 3); Rationale: "a felt experience (being blocked by another team's schedule) builds direct memory the way Elliott's blue-eyes / brown-eyes exercise made discrimination concrete for a classroom of 8-year-olds — lecturing about 'alignment' does not. The PMs now own a 20-minute schema they can tap when the abstract word 'stakeholder' resurfaces."
This skill is licensed under CC-BY-SA-4.0. Source: BookForge — Made to Stick: Why Some Ideas Survive and Others Die by Chip Heath and Dan Heath.
This skill is standalone. Browse more BookForge skills: bookforge-skills