marketing-copy
Skill227 starsChanged 2 months agoApache-2.0View on GitHub
Write outbound promotional copy for a product or project: launch and update posts for community platforms and social media, store page descriptions and short blurbs, landing page headlines and calls to action, press-style announcements, and the naming of a product for another language or market. Covers what may be disclosed publicly, keeping claims traceable to shipped changes, and writing a headline that carries information instead of hype. Use when drafting or revising anything aimed at people who do not use the product yet, and when deciding whether a link, key, price, or unreleased detail can appear in public copy.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- mia-ppp/PMM-Skillstheir own version, first seen Oct 25, 2026
- woakin/marketing-copytheir own version, first seen Sep 5, 2026
- felvieira/claude-skills-fvtheir own version, first seen Sep 2, 2026
- Agundur-KDE/BonsaiPress2their own version, first seen Jun 21, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- felvieira/claude-skills-fv★ 27same name
- woakin/marketing-copy★ 9same name
- mia-ppp/PMM-Skills★ 2same name
- Agundur-KDE/BonsaiPress2★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository14 other files it gives its agents.
- AGENTS.mdAGENTS.md
- user/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- antigravity-cliSkill
- ask-to-planSkill
- codex-cliSkill
- devin-cliSkill
- grok-cliSkill
- product-writingSkill
- scoped-changeSkill
- talk-like-scarletkcSkill
- ux-writingSkill
- worktree-prSkill
- x-contentSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 46
When a constraint blocks a detail the requester wanted to include, say which detail and why, and let them decide, rather than quietly …
- Distinctive: line 60
Never invent a metric, a benchmark, a user count, a review quote, or a comparison against a named competitor.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Marketing Copy
Outbound copy reaches people who have no product context and no reason to finish reading. It is also the surface where a disclosure mistake is permanent: a post can be deleted, a screenshot of it cannot. Both facts push the same way, toward concrete claims a reader can check.
This covers copy aimed outward. Product-internal strings and documentation
follow
ux-writing;
matching the author's personal voice is
talk-like-scarletkc.
Disclosure comes first
Decide what may be public before writing, because the draft is where a leak gets normalized.
- Keys, invite codes, and credentials are not copy. Anything that grants access belongs in the channel that distributes it under its own terms, never inline in a public post, and never pasted into a draft "to be removed later".
- An unreleased or unlisted URL stays unlisted. A link that has not been announced is not published just because it resolves. The same applies to endpoints, staging hosts, and pages reachable only by those already told.
- Platform rules bind the copy, not just the account. Each destination has its own limits on what may be promoted, linked, priced, or given away, and they differ between platforms carrying the same post. When a rule makes a detail unpostable, drop the detail; hinting at it obliquely to stay within the letter of the rule is the same violation with worse writing.
- Unshipped work is not a feature. Roadmap items, planned platforms, and anything gated behind review get described as what they are, or left out. Announcing a date creates an obligation the copy cannot see.
When a constraint blocks a detail the requester wanted to include, say which detail and why, and let them decide, rather than quietly dropping it or quietly keeping it.
Claims stay traceable
Take substance from what actually shipped: the changelog, the commit range,
the release notes. Every concrete claim traces to one of those, and an
adjective that carries a claim owes what "adjectives need evidence" in
ux-writing asks of it. What outbound adds is the exchange rate: specifics
beat adjectives at the same length, because a number, a mechanism, or a
before-and-after carries conviction that "greatly improved" cannot, and it
survives a reader who checks.
Never invent a metric, a benchmark, a user count, a review quote, or a comparison against a named competitor. When the honest version is thin, that is information about the release, not a prompt to inflate it.
Writing for someone who has never seen it
Say what the thing is before saying why it got better. A reader who cannot tell what the product does has no way to care that it improved, and an update post aimed at existing users reads as noise to everyone else. When a post has to serve both audiences, the identifying sentence costs one line and buys the rest.
Revolutionary, seamless, game-changing, and unleash have stopped carrying meaning in this genre: they appear in every launch post regardless of what shipped, so a reader skips them to look for the specifics underneath. Write the specifics instead. Manufactured urgency and invented scarcity fail the same way, and cost more when the deadline turns out to be arbitrary.
A post may legitimately carry several asks, since a launch often wants the wishlist, the community, and the download at once. Order them by what this particular reader can act on now, and let each one be findable rather than competing for the same sentence.
Naming across languages
A product name rendered for another market is a naming decision, not a translation. Check that the candidate is pronounceable and memorable for that audience, carries no unintended meaning, and does not collide with an existing product in the same category. Prefer a name the audience can search, and once a rendering has shipped anywhere public, keep it stable. A second name for the same product splits every search result and every conversation about it.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

