Concrete Language Rewriter

v1.0.0

Rewrite abstract, theoretical, or jargon-heavy passages into sensory, schema-based language the audience can already picture — using three named techniques (...

0· 83·0 current·0 all-time
byHung Quoc To@quochungto

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for quochungto/bookforge-concrete-language-rewriter.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Concrete Language Rewriter" (quochungto/bookforge-concrete-language-rewriter) from ClawHub.
Skill page: https://clawhub.ai/quochungto/bookforge-concrete-language-rewriter
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install bookforge-concrete-language-rewriter

ClawHub CLI

Package manager switcher

npx clawhub@latest install bookforge-concrete-language-rewriter
Security Scan
Capability signals
Crypto
These labels describe what authority the skill may exercise. They are separate from suspicious or malicious moderation verdicts.
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
Name, description, and provided reference materials align: the skill rewrites abstract prose into concrete language and requires no external services, binaries, or credentials to do that.
Instruction Scope
SKILL.md confines runtime actions to asking for the draft and audience context, optionally checking common local files (audience-profile.md, brief.md, persona.md), and producing side-by-side rewrites; it explicitly forbids inventing unsupported sensory details and asks the agent to surface assumption flags.
Install Mechanism
No install spec and no code files—this is instruction-only so nothing is downloaded or written to disk beyond normal output files the agent creates.
Credentials
The skill requires no environment variables, credentials, or config paths; its occasional checks for locally named audience files are proportional to its purpose (anchoring rewrites to audience reference material).
Persistence & Privilege
always:false and no requests to modify agent/system configuration or to persist credentials; autonomous invocation is allowed by platform default but the skill itself does not request elevated persistence.
Assessment
This is a low-risk, instruction-only writing skill. Before installing, note that the agent may read local document files (e.g., audience-profile.md, brief.md, persona.md) if present to build audience anchors — remove or redact sensitive content from those files if you don't want them used. The skill promises not to invent unsupported sensory details, but always review rewrites for any factual assumptions (the output template includes explicit '[assumption — verify]' caveats). Because it is instruction-only, there is no external code being pulled in, and no credentials are requested. If you expect the agent to run unattended with access to a workspace that contains sensitive documents, consider restricting that workspace or providing only the specific passages and audience notes needed.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

📚 Clawdis
analogyvk973pwpzhyemh8avvh0chc5bk584wpqbbookforgevk973pwpzhyemh8avvh0chc5bk584wpqbclarityvk973pwpzhyemh8avvh0chc5bk584wpqbcommunicationvk973pwpzhyemh8avvh0chc5bk584wpqbconcrete-languagevk973pwpzhyemh8avvh0chc5bk584wpqbcopywritingvk973pwpzhyemh8avvh0chc5bk584wpqblatestvk973pwpzhyemh8avvh0chc5bk584wpqbmessagingvk973pwpzhyemh8avvh0chc5bk584wpqbmetaphorvk973pwpzhyemh8avvh0chc5bk584wpqbpitchvk973pwpzhyemh8avvh0chc5bk584wpqbplain-languagevk973pwpzhyemh8avvh0chc5bk584wpqbrewritingvk973pwpzhyemh8avvh0chc5bk584wpqb
83downloads
0stars
1versions
Updated 1w ago
v1.0.0
MIT-0

Concrete Language Rewriter

When to Use

You 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.

Context & Input Gathering

Required Context (must have — ask if missing)

  • The draft: The actual passage(s) to rewrite, verbatim. -> Check prompt for: pasted text, a file path, or attached document -> If missing, ask: "Paste the passage you want rewritten, or give me the file path."
  • The audience: Who will read this and what schemas they already have. -> Check prompt for: role names, job titles, prior experience mentions -> Check environment for: 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?"

Observable Context (gather from environment)

  • Related drafts: Other versions, earlier pitches, or competitor messaging. -> Look for: draft.md, existing-copy.md, core-message.md -> If unavailable: work from the single passage provided.
  • Technique preference: Whether the user wants a pitch, a generative analogy, or a quick explanation. -> Look for: words like "pitch", "one-liner", "culture", "values", "explain" -> If unavailable: infer from the passage type (see Step 2).

Default Assumptions

  • If no audience is given and one cannot be asked for: assume "intelligent non-expert in the domain" and state this in the output.
  • Preserve the user's claim. Do not invent new facts to ground it — find existing audience schemas that match the claim you already have.

Sufficiency Threshold

SUFFICIENT: passage + audience schemas known PROCEED WITH DEFAULTS: passage known, audience assumed as "intelligent non-expert" (noted in output) MUST ASK: no passage provided

Process

Step 1: Flag abstract passages

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):

  • Contains an abstract noun with no example: synergy, excellence, innovation, alignment, value, quality, empowerment, transformation, optimization.
  • Describes a goal without naming an observable behavior or measurable constraint (e.g., "be the best airline" vs "land a 131-passenger jet on La Guardia Runway 4-22").
  • Uses a word the reader cannot picture, touch, or do.
  • Is a cultural value or strategy statement that does not name the daily object, phrase, or action the reader should change.

Artifact: flagged-passages.md — numbered list with the verbatim text of each flagged passage.

Step 2: Pick the technique for 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...UseWhy
Quick comprehension ("what IS this thing?")Schema tapLeverages one existing schema the audience already owns
A one-shot positioning pitch ("how is this different?")High-concept pitchCombines two schemas to place a new idea at their intersection
Behavior that keeps aligning after the message is deliveredGenerative analogySeeds 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:

TechniqueCanonical exemplars from the book (pick the closest fit)
Schema tapthe 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 analogyDisney "cast members" (theme park as stage production); Kris & Sandy (accounting class reframed as investigative journalism)
Behavior-level swapBoeing 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".

Step 3: Rewrite with Technique 1 — Schema tap

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:

  • The familiar thing is visible, touchable, or doable — not another abstraction.
  • The delta is ONE thing, not five.
  • The reader could draw it after reading it.

Step 4: Rewrite with Technique 2 — High-concept pitch

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:

  • Both reference points are genuinely known to the audience (not just to you).
  • The combination actually captures the new thing's main feature, not just its vibe.
  • It fits in one breath.

Step 5: Rewrite with Technique 3 — Generative analogy

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:

  • The source frame has a rich internal vocabulary the audience already knows (theater, kitchen, cockpit, newsroom, emergency room, baseball).
  • At least 3 daily objects or actions can be renamed without forcing it.
  • The new frame steers a behavior the user actually wants (not a behavior that just sounds good).

Step 6: Swap abstract strategy talk for behavior-level language

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:

  • Quality adjective -> measurable constraint (best -> under 200ms p95)
  • Abstract goal -> observable action (empower our users -> every user can publish without asking support)
  • Strategy noun -> verb the reader performs (alignment -> everyone writes the same one-sentence answer when asked what we are building)

Step 7: Produce the side-by-side deliverable

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:

  1. The original text (verbatim).
  2. The technique chosen.
  3. The canonical exemplar from Made to Stick whose pattern this rewrite echoes (e.g., "like the pomelo example", "like Disney cast members", "like Die Hard on a bus", "like Boeing's 727 runway constraint", "like Jane Elliott's blue-eyes exercise", "like Kris & Sandy", "like Aesop's Fox & the Grapes"). REQUIRED — not optional.
  4. The rewrite.
  5. One line explaining why the rewrite uses concrete hooks the original lacked.
  6. (If applicable) A "caveat" line noting any claim the rewrite intentionally did not invent support for.

Table form (REQUIRED columns): Every side-by-side table must have four columns:

OriginalRewriteTechniqueCanonical 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.

Step 8: Self-check for fabricated detail

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.

Inputs

  • Draft: prose passage(s) to rewrite.
  • Audience schemas: what the audience already knows, sees, or does (roles, domain, prior experience).
  • Optional: technique preference (schema / pitch / generative), channel (tagline / memo / slide), tone constraints.

Outputs

  • 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
...

Key Principles

  • Velcro, not paint. Concrete language is not about making prose prettier — it is about attaching the idea to hooks already in the reader's memory. More hooks = better retention. If a rewrite adds adjectives but no new hooks, it has not concretized anything.
  • Borrow schemas, do not manufacture facts. The sensory detail must come from what the audience already owns (pomelo leans on grapefruit + football) or from what the user can honestly claim (Boeing's actual runway constraint). Never invent specifics to make an abstract claim feel more real — that is lying, not concretizing.
  • Three techniques, three jobs. Schema tap = comprehension speed. High-concept pitch = one-shot positioning. Generative analogy = ongoing behavior steering. Picking the wrong technique wastes the rewrite: a high-concept pitch cannot run a culture, and a generative analogy cannot fit on a billboard.
  • Constraints coordinate, adjectives do not. When a passage describes a goal or strategy, the fix is not an analogy — it is a measurable constraint. "Best" cannot coordinate 500 engineers; "fits in under a mile of runway" can. Replace quality adjectives with numbers, dates, or named actions whenever the passage is a goal.
  • Rewriting is audit-able or it is arbitrary. Always show the technique and the reason next to the rewrite. The user needs to be able to reject a rewrite and know why it is wrong, or apply the same move to the next passage tomorrow.
  • Name the lineage. Every rewrite declares which of the 3 techniques it used AND which canonical book exemplar it echoes — "like the pomelo", "like Disney cast members", "like Die Hard on a bus", "like Boeing's 727 runway constraint", "like Jane Elliott's blue-eyes exercise", "like Kris & Sandy", "like Aesop's Fox & the Grapes". This is how users build the catalog mentally while using the skill, not just the technique abstraction. An unlabeled rewrite is an incomplete rewrite.
  • More hooks = more memory. "White things" is vague. "White things in your refrigerator" is concrete. Every additional hook (color, container, location, use) multiplies retention — but only if each hook is real to the audience.

Examples

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."

References

  • For a reusable output template, see references/output-template.md
  • For an expanded catalog of schema-tap, high-concept-pitch, and generative-analogy patterns with more worked examples (Aesop's Fox and Grapes parable compression, Disney cast-member system, Kris & Sandy accounting case, Boeing 727 runway constraint, Jane Elliott blue-eyes exercise), see references/technique-catalog.md

License

This skill is licensed under CC-BY-SA-4.0. Source: BookForgeMade to Stick: Why Some Ideas Survive and Others Die by Chip Heath and Dan Heath.

Related BookForge Skills

This skill is standalone. Browse more BookForge skills: bookforge-skills

Comments

Loading comments...