Katib — website copywriting skill
Adapted from the "AI Market Research Sprint" (written for a ChatGPT chat) into an agent workflow.
Core rule for every step: argument first, words last — read references/argument-first.md before Step 1.
Fixed order (never skip, never reorder)
0 Intake → 1 Reference review → 2 Research → 3 Avatar → 4 Offer brief → 5 Beliefs → 6 Website copy → 7 Final check
Paths
- Skill files: relative to this skill's base directory (shown when the skill loads). The Reddit tool is
tools/reddit_fetch.pythere — give researchers its absolute path. - Client folder:
<current project root>/katib-clients/<client-slug>/with:00-input.md · 01-reference-review.md · 02-research.md · research-raw/ · 03-avatar.md · 04-offer-brief.md · 05-beliefs.md · 06-website-copy.md
Each step reads the files before it. If the folder already exists, read it and resume from the first missing file (or redo only the step the user names).
Steps
Setup (first run, and whenever it fails) — check PinchTab: pinchtab --version and pinchtab health.
Missing or not signed in → walk the user through references/setup-pinchtab.md step by step before research.
Already working → say nothing, go on.
0. Intake — Ask for anything missing, in one message:
product (what it is, price if known), audience, market/country, output language (Arabic Gulf / Arabic MSA / English / both),
reference page screenshot (or URL), anything the brand already has (reviews, proof, guarantee, story).
Write 00-input.md.
1. Reference review — follow references/sales-page-review.md. Write 01-reference-review.md.
⏸ Gate: show verdict + section map + what to borrow. Wait for OK.
2. Research — follow references/research-method.md and references/research-agents.md.
Launch the 5 researchers in parallel (R1–R4 + R5 Reddit), merge into templates/research-doc.md → 02-research.md.
Instagram, TikTok and signed-in Reddit are read through PinchTab's research profile (read only); fallback: the user's signed-in Chrome (own tab), then Scrapling. If the local market is thin, R1 and R5 widen to the same kind of business worldwide and tag those quotes with the country.
Then write 02-research-summary.md for the user: in the user's language, short sections with emoji headers
(who / dreams / pain / blame / beliefs / best story / competitors / mechanism candidates / warnings / gaps), 1–3 key quotes each with [S#].
⏸ Gate: show the summary block and thin sections. Wait for OK (the user may ask for more digging).
3. Avatar — fill templates/avatar.md from 02-research.md only → 03-avatar.md.
Business buyer → "Monthly revenue"; consumer → "Income / spending power". No gate; show it with Step 4.
More than one segment → one avatar file per segment (03-avatar-<segment>.md); the user says which one leads the copy.
Positioning options (optional, when the user asks) — run the creator-toolkit:personal-brand-expert skill on the brand
(it works for businesses too), using 02-research.md and the avatars. Write 03b-positioning.md with several options;
the user's pick feeds the big idea in Step 4.
4. Offer brief — follow references/offer-brief-guide.md, fill templates/offer-brief.md in order → 04-offer-brief.md.
⏸ Gate after field 6: 3 options each for UMP, UMS, big idea. User picks. Then finish fields 7–20.
5. Beliefs — follow references/beliefs.md → 05-beliefs.md.
⏸ Gate: user approves the beliefs before any copy.
6. Website copy — follow references/website-copy.md, fill templates/website-copy.md → 06-website-copy.md.
7. Final check — run Pass 4 of references/website-copy.md, then show the copy, the
"needs proof from brand" list and open questions. ⏸ User approves or asks for changes.
Hard rules
- Never invent quotes, reviews, numbers, studies, people, prices or guarantees. Missing → ask or flag.
- Every research quote is verbatim with a URL that was opened. Avatar quotes cite
[S#]from the research doc. - Never copy sentences from the reference page; borrow structure only.
- Write copy in the language the user asked. Plain words, short sentences.
- Flag health, finance and legal claims for compliance.
- Talk to the user in their language (usually Gulf Arabic), short and simple. Skill files stay in English.
Later: ads
Not built yet. When asked, reuse 04-offer-brief.md and 05-beliefs.md (one belief or the big idea per ad). No new research.