Files
claude-skills-reference/marketing-skill/copy-editing/references/plain-english-alternatives.md
Alireza Rezvani 52321c86bc feat: Marketing Division expansion — 7 → 42 skills (#266)
* feat: Skill Authoring Standard + Marketing Expansion plans

SKILL-AUTHORING-STANDARD.md — the DNA of every skill in this repo:
10 universal patterns codified from C-Suite innovations + Corey Haines' marketingskills patterns:

1. Context-First: check domain context, ask only for gaps
2. Practitioner Voice: expert persona, goal-oriented, not textbook
3. Multi-Mode Workflows: build from scratch / optimize existing / situation-specific
4. Related Skills Navigation: when to use, when NOT to, bidirectional
5. Reference Separation: SKILL.md lean (≤10KB), refs deep
6. Proactive Triggers: surface issues without being asked
7. Output Artifacts: request → specific deliverable mapping
8. Quality Loop: self-verify, confidence tagging
9. Communication Standard: bottom line first, structured output
10. Python Tools: stdlib-only, CLI-first, JSON output, sample data

Marketing expansion plans for 40-skill marketing division build.

* feat: marketing foundation — context + ops router + authoring standard

marketing-context/: Foundation skill every marketing skill reads first
  - SKILL.md: 3 modes (auto-draft, guided interview, update)
  - templates/marketing-context-template.md: 14 sections covering
    product, audience, personas, pain points, competitive landscape,
    differentiation, objections, switching dynamics, customer language
    (verbatim), brand voice, style guide, proof points, SEO context, goals
  - scripts/context_validator.py: Scores completeness 0-100, section-by-section

marketing-ops/: Central router for 40-skill marketing ecosystem
  - Full routing matrix: 7 pods + cross-domain routing to 6 skills in
    business-growth, product-team, engineering-team, c-level-advisor
  - Campaign orchestration sequences (launch, content, CRO sprint)
  - Quality gate matching C-Suite standard
  - scripts/campaign_tracker.py: Campaign status tracking with progress,
    overdue detection, pod coverage, blocker identification

SKILL-AUTHORING-STANDARD.md: Universal DNA for all skills
  - 10 patterns: context-first, practitioner voice, multi-mode workflows,
    related skills navigation, reference separation, proactive triggers,
    output artifacts, quality loop, communication standard, python tools
  - Quality checklist for skill completion verification
  - Domain context file mapping for all 5 domains

* feat: import 20 workspace marketing skills + standard sections

Imported 20 marketing skills from OpenClaw workspace into repo:

Content Pod (5):
  content-strategy, copywriting, copy-editing, social-content, marketing-ideas

SEO Pod (2):
  seo-audit (+ references enriched by subagent), programmatic-seo (+ refs)

CRO Pod (5):
  page-cro, form-cro, signup-flow-cro, onboarding-cro, popup-cro, paywall-upgrade-cro

Channels Pod (2):
  email-sequence, paid-ads

Growth + Intel + GTM (5):
  ab-test-setup, competitor-alternatives, marketing-psychology, launch-strategy, brand-guidelines

All 29 skills now have standard sections per SKILL-AUTHORING-STANDARD.md:
   Proactive Triggers (4-5 per skill)
   Output Artifacts table
   Communication standard reference
   Related Skills with WHEN/NOT disambiguation

Subagents enriched 8 skills with additional reference docs:
  seo-audit, programmatic-seo, page-cro, form-cro,
  onboarding-cro, popup-cro, paywall-upgrade-cro, email-sequence

43 files, 10,566 lines added.

* feat: build 13 new marketing skills + social-media-manager upgrade

All skills are 100% original work — inspired by industry best practices,
written from scratch in our own voice following SKILL-AUTHORING-STANDARD.md.

NEW Content Pod (2):
  content-production — full research→draft→optimize pipeline, content_scorer.py
  content-humanizer — AI pattern detection + voice injection, humanizer_scorer.py

NEW SEO Pod (3):
  ai-seo — AI search optimization (AEO/GEO/LLMO), entirely new category
  schema-markup — JSON-LD structured data, schema_validator.py
  site-architecture — URL structure + internal linking, sitemap_analyzer.py

NEW Channels Pod (2):
  cold-email — B2B outreach (distinct from email-sequence lifecycle)
  ad-creative — bulk ad generation + platform specs, ad_copy_validator.py

NEW Growth Pod (3):
  churn-prevention — cancel flows + save offers + dunning, churn_impact_calculator.py
  referral-program — referral + affiliate programs
  free-tool-strategy — engineering as marketing

NEW Intelligence Pod (1):
  analytics-tracking — GA4/GTM setup + event taxonomy, tracking_plan_generator.py

NEW Sales Pod (1):
  pricing-strategy — pricing, packaging, monetization

UPGRADED:
  social-media-analyzer → social-media-manager (strategy, calendar, community)

Totals: 42 skills, 27 Python scripts, 60 reference docs, 163 files, 43,265 lines

* feat: update index, marketplace, README for 42 marketing skills

- skills-index.json: 89 → 124 skills (42 marketing entries)
- marketplace.json: marketing-skills v2.0.0 (42 skills, 27 tools)
- README.md: badge 134 → 169, marketing row updated
- prompt-engineer-toolkit: added YAML frontmatter
- Removed build logs from repo
- Parity check: 42/42 passed (YAML + Related + Proactive + Output + Communication)

* fix: merge content-creator into content-production, split marketing-psychology

Quality audit fixes:

1. content-creator → DEPRECATED redirect
   - Scripts (brand_voice_analyzer.py, seo_optimizer.py) moved to content-production
   - SKILL.md replaced with redirect to content-production + content-strategy
   - Eliminates duplicate routing confusion

2. marketing-psychology → 24KB split to 6.8KB + reference
   - 70+ mental models moved to references/mental-models-catalog.md (397 lines)
   - SKILL.md now lean: categories overview, most-used models, quick reference
   - Saves ~4,300 tokens per invocation

* feat: add plugin configs, Codex/OpenClaw compatibility, ClawHub packaging

- marketing-skill/SKILL.md: ClawHub-compatible root with Quick Start for Claude Code, Codex CLI, OpenClaw
- marketing-skill/CLAUDE.md: Agent instructions (routing, context, anti-patterns)
- marketing-skill/.codex/instructions.md: Codex CLI skill routing
- .claude-plugin/marketplace.json: deduplicated, marketing-skills v2.0.0
- .codex/skills-index.json: content-creator marked deprecated, psychology updated
- Total: 42 skills, 27 Python tools, 60 references, 18 plugins

* feat: add 16 Python tools to knowledge-only skills

Enriched 12 previously tool-less skills with practical Python scripts:
- seo-audit/seo_checker.py — HTML on-page SEO analysis (0-100)
- copywriting/headline_scorer.py — headline quality scoring (0-100)
- copy-editing/readability_scorer.py — Flesch + passive + filler detection
- content-strategy/topic_cluster_mapper.py — keyword clustering
- page-cro/conversion_audit.py — HTML CRO signal analysis (0-100)
- paid-ads/roas_calculator.py — ROAS/CPA/CPL calculator
- email-sequence/sequence_analyzer.py — email sequence scoring (0-100)
- form-cro/form_field_analyzer.py — form field CRO audit (0-100)
- onboarding-cro/activation_funnel_analyzer.py — funnel drop-off analysis
- programmatic-seo/url_pattern_generator.py — URL pattern planning
- ab-test-setup/sample_size_calculator.py — statistical sample sizing
- signup-flow-cro/funnel_drop_analyzer.py — signup funnel analysis
- launch-strategy/launch_readiness_scorer.py — launch checklist scoring
- competitor-alternatives/comparison_matrix_builder.py — feature comparison
- social-media-manager/social_calendar_generator.py — content calendar
- readability_scorer.py — fixed demo mode for non-TTY execution

All 43/43 scripts pass execution. All stdlib-only, zero pip installs.
Total: 42 skills, 43 Python tools, 60+ reference docs.

* feat: add 3 more Python tools + improve 6 existing scripts

New tools from build agent:
- email-sequence/scripts/sequence_analyzer.py — email sequence scoring (91/100 demo)
- paid-ads/scripts/roas_calculator.py — ROAS/CPA/CPL/break-even calculator
- competitor-alternatives/scripts/comparison_matrix_builder.py — feature matrix

Improved scripts (better demo modes, fuller analysis):
- seo_checker.py, headline_scorer.py, readability_scorer.py,
  conversion_audit.py, topic_cluster_mapper.py, launch_readiness_scorer.py

Total: 42 skills, 47 Python tools, all passing.

* fix: remove duplicate scripts from deprecated content-creator

Scripts already live in content-production/scripts/. The content-creator
directory is now a pure redirect (SKILL.md only + legacy assets/refs).

* fix: scope VirusTotal scan to executable files only

Skip scanning .md, .py, .json, .yml — they're plain text files
that VirusTotal can't meaningfully analyze. This prevents 429 rate
limit errors on PRs with many text file changes (like 42 marketing skills).

Scan still covers: .js, .ts, .sh, .mjs, .cjs, .exe, .dll, .so, .bin, .wasm

---------

Co-authored-by: Leo <leo@openclaw.ai>
2026-03-06 03:56:16 +01:00

8.0 KiB

Plain English Alternatives

Replace complex or pompous words with plain English alternatives.

Source: Plain English Campaign A-Z of Alternative Words (2001), Australian Government Style Manual (2024), plainlanguage.gov


A

Complex Plain Alternative
(an) absence of no, none
abundance enough, plenty, many
accede to allow, agree to
accelerate speed up
accommodate meet, hold, house
accomplish do, finish, complete
accordingly so, therefore
acknowledge thank you for, confirm
acquire get, buy, obtain
additional extra, more
adjacent next to
advantageous useful, helpful
advise tell, say, inform
aforesaid this, earlier
aggregate total
alleviate ease, reduce
allocate give, share, assign
alternative other, choice
ameliorate improve
anticipate expect
apparent clear, obvious
appreciable large, noticeable
appropriate proper, right, suitable
approximately about, roughly
ascertain find out
assistance help
at the present time now
attempt try
authorise allow, let

B

Complex Plain Alternative
belated late
beneficial helpful, useful
bestow give
by means of by

C

Complex Plain Alternative
calculate work out
cease stop, end
circumvent avoid, get around
clarification explanation
commence start, begin
communicate tell, talk, write
competent able
compile collect, make
complete fill in, finish
component part
comprise include, make up
(it is) compulsory (you) must
conceal hide
concerning about
consequently so
considerable large, great, much
constitute make up, form
consult ask, talk to
consumption use
currently now

D

Complex Plain Alternative
deduct take off
deem treat as, consider
defer delay, put off
deficiency lack
delete remove, cross out
demonstrate show, prove
denote show, mean
designate name, appoint
despatch/dispatch send
determine decide, find out
detrimental harmful
diminish reduce, lessen
discontinue stop
disseminate spread, distribute
documentation papers, documents
due to the fact that because
duration time, length
dwelling home

E

Complex Plain Alternative
economical cheap, good value
eligible allowed, qualified
elucidate explain
enable allow
encounter meet
endeavour try
enquire ask
ensure make sure
entitlement right
envisage expect
equivalent equal, the same
erroneous wrong
establish set up, show
evaluate assess, test
excessive too much
exclusively only
exempt free from
expedite speed up
expenditure spending
expire run out

F

Complex Plain Alternative
fabricate make
facilitate help, make possible
finalise finish, complete
following after
for the purpose of to, for
for the reason that because
forthwith now, at once
forward send
frequently often
furnish give, provide
furthermore also, and

G-H

Complex Plain Alternative
generate produce, create
henceforth from now on
hitherto until now

I

Complex Plain Alternative
if and when if, when
illustrate show
immediately at once, now
implement carry out, do
imply suggest
in accordance with under, following
in addition to and, also
in conjunction with with
in excess of more than
in lieu of instead of
in order to to
in receipt of receive
in relation to about
in respect of about, for
in the event of if
in the majority of instances most, usually
in the near future soon
in view of the fact that because
inception start
indicate show, suggest
inform tell
initiate start, begin
insert put in
instances cases
irrespective of despite
issue give, send

L-M

Complex Plain Alternative
(a) large number of many
liaise with work with, talk to
locality place, area
locate find
magnitude size
(it is) mandatory (you) must
manner way
modification change
moreover also, and

N-O

Complex Plain Alternative
negligible small
nevertheless but, however
notify tell
notwithstanding despite, even if
numerous many
objective aim, goal
(it is) obligatory (you) must
obtain get
occasioned by caused by
on behalf of for
on numerous occasions often
on receipt of when you get
on the grounds that because
operate work, run
optimum best
option choice
otherwise or
outstanding unpaid
owing to because

P

Complex Plain Alternative
partially partly
participate take part
particulars details
per annum a year
perform do
permit let, allow
personnel staff, people
peruse read
possess have, own
practically almost
predominant main
prescribe set
preserve keep
previous earlier, before
principal main
prior to before
proceed go ahead
procure get
prohibit ban, stop
promptly quickly
provide give
provided that if
provisions rules, terms
proximity nearness
purchase buy
pursuant to under

R

Complex Plain Alternative
reconsider think again
reduction cut
referred to as called
regarding about
reimburse repay
reiterate repeat
relating to about
remain stay
remainder rest
remuneration pay
render make, give
represent stand for
request ask
require need
residence home
retain keep
revised changed, new

S

Complex Plain Alternative
scrutinise examine, check
select choose
solely only
specified given, stated
state say
statutory legal, by law
subject to depending on
submit send, give
subsequent to after
subsequently later
substantial large, much
sufficient enough
supplement add to
supplementary extra

T-U

Complex Plain Alternative
terminate end, stop
thereafter then
thereby by this
thus so
to date so far
transfer move
transmit send
ultimately in the end
undertake agree, do
uniform same
utilise use

V-Z

Complex Plain Alternative
variation change
virtually almost
visualise imagine, see
ways and means ways
whatsoever any
with a view to to
with effect from from
with reference to about
with regard to about
with respect to about
zone area

Phrases to Remove Entirely

These phrases often add nothing. Delete them:

  • a total of
  • absolutely
  • actually
  • all things being equal
  • as a matter of fact
  • at the end of the day
  • at this moment in time
  • basically
  • currently (when "now" or nothing works)
  • I am of the opinion that (use: I think)
  • in due course (use: soon, or say when)
  • in the final analysis
  • it should be understood
  • last but not least
  • obviously
  • of course
  • quite
  • really
  • the fact of the matter is
  • to all intents and purposes
  • very