name: seo-copywriting description: > Standalone copywriting formulas skill. Drafts, rewrites, and audits text using 14 core copy frameworks (AIDA, PAS, BAB, FAB, etc.) with native Vietnamese Tone & Style guides. triggers: "copywriting formulas, viết quảng cáo, công thức viết, công thức content, viết aida, viết pas, công thức copywriting" last_updated: "2026-06-08"

SEO Copywriting — Copywriting Formulas Skill

Purpose

Provides a standalone suite of copywriting tools inside the Antigravity SEO Kit. Enables content writers, advertisers, and the AI agent to draft new marketing copies, rewrite existing drafts, or audit copy structures using 14 core copywriting frameworks optimized specifically for natural Vietnamese communication.

Commands

The skill is exposed via two Python scripts under scripts/:

1. Generating & Rewriting Copy

Run copywriting_orchestrator.py to create new text or rewrite existing text.

# Generate a new copy with persuasion triggers
python -m scripts.copywriting_orchestrator write --formula <formula_name> --topic "<topic>" --tone "<tone>" --persuasion "<triggers>"

# Rewrite an existing text file with persuasion triggers
python -m scripts.copywriting_orchestrator rewrite --formula <formula_name> --file "<path_to_file>" --tone "<tone>" --persuasion "<triggers>"

Note: --persuasion accepts a comma-separated list of triggers (e.g. "Curiosity Gap, Loss Aversion").

2. Auditing & Refurbishing Copy

Run copywriting_auditor.py to review an existing draft against a copywriting formula, identify psychological triggers, and scan for Power Words overuse.

python -m scripts.copywriting_auditor audit --formula <formula_name> --file "<path_to_file>"

14 Copywriting Formulas Library

Group	Formula	Components	Focus
Sales & CRO	AIDA	Attention → Interest → Desire → Action	Classic marketing funnel
	PAS	Problem → Agitate → Solve	Emotional pain-point relief
	BAB	Before → After → Bridge	Outcome validation
	FAB	Features → Advantages → Benefits	Feature to benefit conversion
	4P	Picture → Promise → Prove → Push	Vision-led conversion
	3S	Star → Story → Solution	Narrative & PR
Editing & Hooks	4U	Urgent → Unique → Useful → Ultra-specific	Headlines & Email Subjects
	4C	Clear → Concise → Compelling → Credible	Copyediting check
	APP	Agree → Promise → Preview	Article intro hooks
Logic & Persuasion	A FOREST	Alliteration, Facts, Opinions, Repetition, Examples, Statistics, Threes	In-depth thought leadership
	5 Obstacles	No Time, No Money, No Need, No Trust, No Hurry	Objection handling
	3 Whys	Why you?, Why this?, Why now?	Landing page pressure points
Kênh & Hành trình	4A	Aware → Attitude → Action → Act again	Customer lifecycle
	5A	Aware → Appeal → Ask → Act → Advocate	Digital customer touchpoints

NLP & Psychological Persuasion Triggers

The skill supports lồng ghép 10 kỹ thuật NLP và 18 hiệu ứng tâm lý học thuyết phục vào lời văn thông qua persuasion_manifest.json nhằm gia tăng tỷ lệ chuyển đổi (CRO):

1. 10 Kỹ thuật NLP Copywriting

Presupposition (Giả định mặc nhiên): Giả định khách hàng sẽ dùng sản phẩm.
Embedded Command (Mệnh lệnh ẩn): Lồng mệnh lệnh hành động vào câu thường.
Open Loop (Vòng lặp mở): Khêu gợi tò mò bắt người đọc kéo xuống.
Pacing & Leading (Khớp & Dẫn dắt): Khớp trải nghiệm khách hàng rồi dẫn dắt giải pháp.
Sensory Language (Ngôn ngữ giác quan): Kích thích 5 giác quan.
Double Bind (Ràng buộc kép): Đưa ra 2 lựa chọn có lợi cho sản phẩm.
Power Words (Từ kích thích): Dùng các từ kích xúc cảm mạnh.
Identity Labeling (Gán nhãn bản sắc): Gán nhãn tích cực để hướng hành động.
Negative Future Pacing (Tương lai tiêu cực): Vẽ viễn cảnh tệ nếu không dùng sản phẩm.
Social Currency (Tiền tệ xã hội): Viết nội dung giúp người chia sẻ cảm thấy có ích.

2. 18 Hiệu ứng Tâm lý học

Loss Aversion (Mất mát ác cảm): Tận dụng tâm lý sợ mất mát hơn là được nhận.
Scarcity (Khan hiếm): Giới hạn thời gian, số lượng.
Social Proof (Bằng chứng xã hội): Đánh giá, số liệu người dùng cũ.
Authority (Uy quyền): Trích dẫn ý kiến của các chuyên gia.
Anchoring (Neo giá trị): Neo mốc giá gốc ban đầu để giá sau hấp dẫn hơn.
FOMO (Sợ bỏ lỡ): Sợ bị tụt hậu so với đám đông.
Future Pacing (Tương lai tích cực): Tưởng tượng viễn cảnh tốt đẹp sau khi dùng sản phẩm.
Curiosity Gap (Khoảng trống tò mò): Hé lộ một phần bí mật để tạo tò mò.
Decoy Effect (Hiệu ứng chim mồi): Tạo các gói giá trị trung gian.
Các hiệu ứng khác: Reciprocity (Có qua có lại), Contrast (Tương phản), Commitment (Cam kết bước nhỏ), Cognitive Ease (Dễ nhận thức), Risk Reversal (Đảo ngược rủi ro), Narrative Transport (Cuốn theo chuyện kể), Pattern Interrupt (Ngắt mẫu), Halo (Hào quang), Specificity (Con số cụ thể).

Power Words & Anti-Cliché Auditing

Bộ quét tĩnh copywriting_auditor.py thực hiện kiểm định cục bộ không cần API để bảo vệ chất lượng bài viết:

Power Words Overuse Warning: Hệ thống quét 8 từ kích thích cảm xúc phổ biến (bí mật, độc quyền, đột phá, duy nhất, hoàn hảo, tuyệt đối, tất cả, ngay lập tức). Nếu tổng tần suất xuất hiện vượt quá 5 lần, auditor sẽ phát cảnh báo ⚠️ và hạ điểm bài viết xuống FAIL để ép người viết/AI điều chỉnh về mức tự nhiên.
Persuasion Triggers Detected: Hiển thị bảng checklist thống kê tất cả các mỏ neo thuyết phục được phát hiện trong bản nháp.

Integration with seo-writer

While this skill operates as a standalone utility, its manifest and scripts are designed to be callable by the main seo-writer pipeline during Step 2 (Outline) and Step 3 (Draft) to dynamically enrich heading outlines and section drafting.

Style Guidelines (Vietnamese)

All outputs must adhere to the Vietnamese Copywriting DNA:

Tone options: chuyên nghiệp (B2B, tech, finance) or thân thiện (B2C, lifestyle, conversational).
Natural Transitions: Use native Vietnamese connectives instead of direct English translations (e.g. use "Thấu hiểu nỗi lo đó..." instead of a direct translation of "Agitating your problem").
Objection Resolution: Incorporate actual social evidence and specific Vietnamese context (price in VND, localized testimonials) where required by formulas.