Skip to content

augchan42/inkstone / skills/marketing-clarity

marketing-clarity

Verified

Clarify marketing messages, website copy and company introductions when readers cannot readily understand the offer or its value. Use for vague positioning, abstract headlines, jargon-heavy explanations, or simple wording that still says little. Focus on meaning and reader understanding rather than proofreading.

FileKindSize
SKILL.mdskill md8.3 KB
references/exercises-and-examples.mdmarkdown4.2 KB

references/exercises-and-examples.md

View on GitHub
# Exercises and Examples

Use these when the message needs clarification before wording can improve,
or when repeated revisions remain generic.

## 1. Sentence completion

Complete the relevant prompts using supplied facts:

- We help...
- People usually struggle with...
- The biggest mistake they make is...
- People come to us because...

These are discovery prompts, not required public-copy sections. Use only
the prompts that illuminate the offer. An opportunity-led business may
have a clearer message without describing a mistake or struggle.

Separate evidence from hypotheses. If the reason customers buy is unknown,
identify that gap rather than inventing customer research.

Look for the connection between the help provided and the useful difference
it makes. That connection is often the strongest basis for the message.

## 2. Explain it to the room

Write a short spoken explanation of what the business does.

Then review it from the perspective of someone without specialist knowledge:

- Which terms would need explaining?
- What would they think they could buy or ask for?
- What useful difference would they expect?
- What might they misunderstand?

Rewrite the confusing parts in ordinary language.

This is an editorial simulation. Actual listener feedback is stronger
evidence and should be described separately when available.

## 3. Build a compact introduction

Start with:

> We help [audience] with [need] so they can [outcome].

Check each part:

- Is the audience recognisable?
- Is the need something the audience would understand?
- Does the outcome follow from the help?
- Is the claim supported?

Then remove the scaffolding and write a natural sentence. Keep an explicit
audience when it helps comprehension; let nearby context supply it when
repeating it would add little.

## 4. Review what the reader receives

Adapted from the workshop's live-review questions:

- What is understandable from the words alone?
- What remains confusing?
- What important information is missing?
- Is the next step apparent?

Evaluate the actual text. Avoid defending an unclear sentence by explaining
what the writer intended to mean.

When reviewing a whole page, prioritise changes that repair missing meaning
before minor stylistic improvements.

## 5. Worked example: a training section

### Context

An AI training page contains three learning areas:

- Understand how AI works.
- Gain practical experience.
- Decide where AI belongs.

Its supporting paragraph explains that training can combine explanation,
practical experience and discussion, with the emphasis agreed for the
audience.

### Original heading

> Learning that connects to the work.

The phrase sounds purposeful but leaves "the work" unspecified. It asks the
reader to infer the connection and the benefit.

### First revision

> What you can learn.

This is readable and direct, but mainly labels the section. It says little
about the provider's contribution.

### Further options

> What our training offers.
>
> What our training covers.

These clarify whose training is being described, but remain catalogue
headings. They can suit a syllabus or course overview; they were not the
right direction for this passage.

### Selected revision

> We make AI easier to understand and use.

This names the provider's action and a useful benefit. The existing
paragraph explains the training format, and the three rows develop the
claim through understanding, experience and judgement.

The improvement came from deciding what the heading should communicate,
not from finding a more polished synonym for "learning".

This is a context-specific example, not a universal headline formula.
Check for repetition with the page opening and nearby sections before
using a similar construction elsewhere.

## 6. When simpler wording is still weak

Ask:

- Does this sentence communicate an offer, action or useful consequence?
- Could the reader understand the words but still wonder what we do?
- Have we replaced an abstract slogan with an equally uninformative label?
- Would a slightly longer sentence remove an important ambiguity?
- Is the supporting content strong enough to justify the heading?

Keep useful specificity. The aim is the least effort needed to understand
the message, not the fewest possible words.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall