Overview
This is a specialized skill for generating copy for high-converting e-commerce detail pages. 3 modesare supported:
| Mode | Flag | Description |
|---|---|---|
| Default (13 sections) | None | Generate the full 13-section emotional journey copy (backward compatible with existing) |
| Diagnose | --mode diagnose |
Current detail page 7-stage diagnostic score |
| Persona copy | --mode copy |
Generate 2 sets of copy based on JTBD·persona, enforce ratio 25/50/25 |
Supported categories: electronics / fashion / food / beauty / home / supplement / pet / kids / handmade / general
Trigger keywords
detail page, product detail page, e-commerce detail page, shopping mall copy, product detail, product detail page, product description page, detail page, detail copy, online shopping mall product page, emotional journey copy, 13-section detail page, detail page diagnosis, detail page score, 7-stage diagnosis, persona copy, 2 sets of copy, ratio guide
Extended mode workflow (--mode diagnose / --mode copy)
--mode diagnose: 7-stage diagnostic score
When you input the current detail page URL or a captured image, a diagnostic score is calculated based on the 7-stage criteria.
Input: Current detail page URL or screenshot image
7-stage diagnostic criteria:
| Stage | Diagnostic item | Points |
|---|---|---|
| 1 | Hero — Whether value is conveyed within 10 seconds | 15점 |
| 2 | Pain·Problem — Customer empathy + clarity of problem definition | 15점 |
| 3 | Solution·How — Solution + explanation of how it works | 15점 |
| 4 | Proof·Authority — Social proof + evidence of expertise | 15점 |
| 5 | Benefits — Specificity of benefits + differentiation | 10점 |
| 6 | Risk·Compare·Filter — Risk removal + comparison + target filter | 15점 |
| 7 | CTA — Urgency + clarity of call to action | 15점 |
Output format (--mode diagnose):
{
"mode": "diagnose",
"url": "{진단 URL 또는 이미지}",
"total_score": 67,
"grade": "B",
"stages": [
{"stage": 1, "name": "Hero", "score": 12, "max": 15, "issue": "서브카피 없음", "suggestion": "10초 내 USP 한 줄 추가"},
{"stage": 2, "name": "Pain·Problem", "score": 8, "max": 15, "issue": "고통점 묘사 추상적", "suggestion": "구체 상황 예시 추가"},
{"stage": 3, "name": "Solution·How", "score": 13, "max": 15, "issue": "작동 방식 3단계 중 2단계만 있음", "suggestion": "3단계 완성"},
{"stage": 4, "name": "Proof·Authority", "score": 10, "max": 15, "issue": "리뷰 인용 없음", "suggestion": "실제 구매 리뷰 3개 삽입"},
{"stage": 5, "name": "Benefits", "score": 7, "max": 10, "issue": "혜택 4개 중 2개 중복", "suggestion": "중복 혜택 제거 후 차별화"},
{"stage": 6, "name": "Risk·Compare·Filter", "score": 8, "max": 15, "issue": "보증 정책 미표기", "suggestion": "환불 정책 + 비추천 대상 추가"},
{"stage": 7, "name": "CTA", "score": 9, "max": 15, "issue": "긴급성 요소 없음", "suggestion": "한정 수량 또는 마감일 추가"}
],
"priority_fixes": ["stage4 리뷰 추가", "stage1 서브카피", "stage6 보증 정책"],
"next_step": "--mode copy 로 개선된 카피 2세트 생성 권장"
}
--mode copy: 2 sets of persona copy (enforce ratio 25/50/25)
Takes JTBD·persona (commerce-jtbd-persona output) and the current detail page as input and generates 2 sets of copy for the main and secondary personas.
Enforce ratio guide (HARD):
- Problem·Empathy section: 25% (Hero + Pain + Problem)
- Core·Proof section: 50% (Solution + How + Proof + Authority + Benefits)
- FAQ·CTA section: 25% (Risk + Compare + Filter + CTA)
Input slots (--mode copy):
| Item | Required | Example |
|---|---|---|
| JTBD result | Required | commerce-jtbd-persona --mode jtbd output |
| 3 personas | Required | commerce-jtbd-persona --mode persona output |
| Current detail page | Recommended | URL or --mode diagnose result (reflecting improvements) |
Output format (--mode copy):
{
"mode": "copy",
"ratio_guide": "25/50/25",
"persona_sets": [
{
"persona": "메인 (박지연, 32세, 직장인)",
"jtbd_focus": "F1 — 성분 안전성",
"sections": {
"problem_empathy_25pct": {
"hero": {...},
"pain": {...},
"problem": {...}
},
"core_proof_50pct": {
"solution": {...},
"how": {...},
"proof": {...},
"authority": {...},
"benefits": {...}
},
"faq_cta_25pct": {
"risk": {...},
"compare": {...},
"filter": {...},
"cta": {...}
}
}
},
{
"persona": "보조1 (김수현, 27세, 대학원생)",
"jtbd_focus": "E2 — 클린 라이프스타일",
"sections": {"...": "..."}
}
],
"slop_review": {
"status": "passed",
"changes_made": 3,
"notes": "ai-slop-reviewer 검수 완료"
}
}
ai-slop-reviewer automatic chaining (HARD): --mode copy The output is, after all copy generation, moai-coworker:ai-slop-reviewerautomatically chains.
Existing mode (13 sections, backward compatibility maintained)
When invoked without flags, the existing 13-section emotional journey copy mode runs. The existing workflow, output format, and ai-slop-reviewer chaining all remain the same.
Copy quality guide
Good examples vs examples to avoid (detail page checklist)
✅ Good examples
"하루 종일 피곤하고 집중력이 떨어지시나요?
많은 직장인들이 같은 고민을 하고 있습니다.
100% 자연 성분으로 만든 저희 에너지 드링크는
카페인 부작용 없이 6시간 동안 지속되는 활력을 선사합니다."
→ Concisely includes problem statement + empathy + solution + differentiator. Steps 1, 2, and 3 of the 7-step structure form one flow.Concisely includes problem statement + empathy + solution + differentiator. Steps 1, 2, and 3 of the 7-step structure form one flow.
❌ Examples to avoid
"최고 품질의 에너지 드링크입니다.
맛있고 효과적입니다.
많은 분들이 구매하셨습니다.
빨리 구매하세요."
→ Listing only abstract phrases without concrete proof or differentiators. Fails to clearly perform any of the 7 steps.
PAS copy formula mapping
Mapping between the 7-step structure and the PAS (Problem-Agitate-Solution) copy formula:
| 7 steps | PAS mapping | Psychological strategy |
|---|---|---|
| 1. Problem awareness | P (Problem) | Accurately describe the problem the target already recognizes in their own language. Do not talk about the product |
| 2. Empathy | A (Agitate) | Make the problem bigger and more painful. "What happens if you don't solve it now?". Loss aversion bias works |
| 3. Core message | Introduce S (Solution) | Present the solution. As benefits, not features |
| 4. Proof | Reinforce S | Finish with social proof. Statistics, reviews, experts |
| 5. Usage/benefits | Apply the value equation | (what you gain - what you lose) × trust |
| 6. FAQ/handling objections | Zero-risk bias | e.g., "30-day money-back guarantee" |
| 7. Purchase inducement | Loss aversion + anchoring | Compared with deadlines, discounts, and price increases |
3-step benefit language transformation method
Most copy stops at step 1 (features). Only by reaching step 3 does identity purchase motivation work.
| Step | Transformation result | Example (waterproof material) |
|---|---|---|
| Step 1 — Direct result of the feature | Product → What can it do | Waterproof material → Does not get wet in the rain |
| Step 2 — Change in the result | Result → What changes in daily life | Does not get wet in the rain → The worry of carrying an umbrella disappears |
| Step 3 — Emotion of the change (identity) | Change → What kind of person you feel you become | The worry disappears → The feeling of becoming a person who goes out lightly even on rainy days |
Steal the language from customer reviews: "My back pain is gone" is weaker benefit language than "I no longer grimace when I get up in the morning." The words customers actually used resonate the strongest.
Copywriting Checklist (7-Step Integration)
After generating copy for each step, self-review:
- Steps 1·2 (25%): Accurately describe the customer's problem in their own language + empathy
- Steps 3·4·5 (50%): Emphasize differentiators + concrete proof (data, reviews, ingredients) + 3-stage benefit transformation
- Steps 6·7 (25%): Answer anticipated questions + clear CTA + urgency·anchoring
- PAS flow check (Problem clear → Agitate strengthen → Solution derive)
- 3-stage benefit language transformation complete (feature → change → emotion)
- Avoid prohibited expressions: Abstract phrases such as "highest quality·delicious and effective·buy quickly" ❌
- Concrete evidence included: 100% natural ingredients, lasts 6 hours, 92% satisfaction, etc. ✅
Required Input Information (Existing Mode)
The orchestrator collects the following information from the user in advance (using AskUserQuestion before invoking the skill):
| Item | Required or Not | Example |
|---|---|---|
| Product name | Required | "Smartwatch X200" |
| Category | Recommended | electronics, fashion, food, beauty, home, supplement, pet, kids, handmade, general |
| Key USP | Required | "30-hour battery + ANC + IPX5 waterproof" |
| Target customer | Recommended | "Office workers in their 20s-40s, those who enjoy exercising" |
| Price range | Optional | "129,000 won" |
| Brand tone | Optional | "Trustworthy and professional" / "Young and lively" |
| Sales channel | Optional | Coupang / Smart Store / Own mall / General purpose |
| Warranty/AS policy | Optional | "1-year free A/S" |
Workflow
Step 1: Product DNA Analysis
Extract the following from the entered product information:
ProductDNA:
physical:
form: 상품 형태
colors: 대표 색상
material: 소재
signature_angle: 대표 각도/뷰
positioning:
tier: mass / premium_indie / luxury
tone: 어조 앵커 (신뢰/흥미/따뜻함/혁신)
brand_archetype: 브랜드 원형
palette:
primary: 대표 색상
background: 배경 색상
Step 2: Apply Category Brief
Apply visual and copy principles by category (seereferences/category-briefs.md ):
- electronics: Precise·innovative tone, spec-focused, technical trust
- fashion: Emotional·lifestyle, use of whitespace, editorial tone
- food: Warmth·abundance, texture·aroma description, handmade·natural keywords
- beauty: Radiance·clean beauty, ingredient emphasis, beauty routine connection
- home: Coziness·intentional living, interior context, emotional lifestyle
- supplement: Trust·scientific evidence, ingredient clarification, safety assurance
- general: Clean·general purpose, product-focused, modern minimal
Step 3: Generate 13-Section Copy
references/13-sections.mdWrite copy following the rules for each section of
Copy elements by section
| # | Section | Key elements |
|---|---|---|
| 1 | Hero | Main headline (deliver value within 10 seconds) + subcopy + CTA button text + urgency badge |
| 2 | Pain | Empathy headline + 4 pain points (bullets) + emotional connection copy |
| 3 | Problem | Twist hook headline + 3 root causes (numbered) + transition copy |
| 4 | Story | Before state description + turning point label + After state + proof metrics |
| 5 | Solution | Product name + one-line solution + target fit tagline |
| 6 | How | How it works in 3 steps (title + short description) + result highlight |
| 7 | Proof | 3 statistics + 3 reviewer quotes + editorial-tone introduction |
| 8 | Authority | Founder/expert quote + name + title + credentials |
| 9 | Benefits | 6 benefits (icon + label) + bonus items + total value statement |
| 10 | Risk | Guarantee headline + 5 FAQs (Q&A) + official statement |
| 11 | Compare | 3 Without points vs 3 With points |
| 12 | Filter | 3 recommended-for targets + 3 not-recommended-for targets |
| 13 | CTA | Final headline + urgency copy + price/benefit statement + CTA button + closing tagline |
Step 4: ai-slop-reviewer automatic chaining (HARD)
Right before producing all text copy, moai-coworker:ai-slop-revieweris called.
Review items:
- Remove AI-specific repetitive expressions ("Of course", "excellent", "innovative", etc.)
- Refine excessive adjective clichés
- Adjust to natural Korean e-commerce phrasing
- Revise marketing exaggeration into fact-based statements
Output format
Copy JSON structure
{
"product": {
"name": "상품명",
"category": "electronics",
"usp": "핵심 USP",
"target": "타겟 고객",
"price": "가격대",
"tier": "premium_indie"
},
"sections": [
{
"id": "hero",
"label": "Hero (긴급성 헤더)",
"headline": "메인 헤드라인",
"subheadline": "서브카피",
"cta": "CTA 버튼 문구",
"badge": "긴급성 뱃지 문구"
},
{
"id": "pain",
"label": "Pain (공감)",
"headline": "공감 헤드라인",
"bullets": ["고통점1", "고통점2", "고통점3", "고통점4"],
"bridge": "감정 연결 문구"
},
{
"id": "problem",
"label": "Problem (문제 정의)",
"hook": "반전 훅 헤드라인",
"causes": ["원인1", "원인2", "원인3"],
"transition": "전환 문구"
},
{
"id": "story",
"label": "Story (Before→After)",
"before": "Before 상태 묘사",
"turning_point": "전환점 레이블",
"after": "After 상태 묘사",
"stat": "증거 수치"
},
{
"id": "solution",
"label": "Solution (솔루션 소개)",
"product_name": "상품명",
"one_liner": "한 줄 솔루션",
"tagline": "타겟 핏 태그라인"
},
{
"id": "how",
"label": "How It Works (작동 방식)",
"steps": [
{"title": "1단계 제목", "desc": "설명"},
{"title": "2단계 제목", "desc": "설명"},
{"title": "3단계 제목", "desc": "설명"}
],
"result": "결과 하이라이트"
},
{
"id": "proof",
"label": "Social Proof (사회적 증거)",
"stats": ["통계1", "통계2", "통계3"],
"reviews": [
{"quote": "리뷰 인용", "reviewer": "리뷰어명"},
{"quote": "리뷰 인용", "reviewer": "리뷰어명"},
{"quote": "리뷰 인용", "reviewer": "리뷰어명"}
]
},
{
"id": "authority",
"label": "Authority (권위/전문성)",
"quote": "전문가 인용",
"name": "이름",
"title": "직함",
"credentials": "자격/경력"
},
{
"id": "benefits",
"label": "Benefits (혜택)",
"items": [
{"label": "혜택1", "desc": "설명"},
{"label": "혜택2", "desc": "설명"},
{"label": "혜택3", "desc": "설명"},
{"label": "혜택4", "desc": "설명"},
{"label": "혜택5", "desc": "설명"},
{"label": "혜택6", "desc": "설명"}
],
"bonus": "보너스 항목",
"total_value": "총 가치 표현"
},
{
"id": "risk",
"label": "Risk Removal (리스크 제거)",
"guarantee_headline": "보증 헤드라인",
"faqs": [
{"q": "질문1", "a": "답변1"},
{"q": "질문2", "a": "답변2"},
{"q": "질문3", "a": "답변3"},
{"q": "질문4", "a": "답변4"},
{"q": "질문5", "a": "답변5"}
]
},
{
"id": "compare",
"label": "Before/After Final (최종 대비)",
"without": ["포인트1", "포인트2", "포인트3"],
"with": ["포인트1", "포인트2", "포인트3"]
},
{
"id": "filter",
"label": "Target Filter (타겟 필터)",
"recommend": ["추천 대상1", "추천 대상2", "추천 대상3"],
"not_recommend": ["비추천 대상1", "비추천 대상2", "비추천 대상3"]
},
{
"id": "cta",
"label": "Final CTA (최종 CTA)",
"headline": "최종 헤드라인",
"urgency": "긴급성 카피",
"price_display": "가격/혜택 표현",
"cta_button": "CTA 버튼 문구",
"closing": "마감 태그라인"
}
],
"slop_review": {
"status": "passed",
"changes_made": 0,
"notes": "ai-slop-reviewer 검수 결과"
}
}
Markdown preview
After JSON output, provide a markdown preview for user confirmation, section by section.
codex CLI optional backend
codex If the CLI is installed and an OAuth session is active, it can be used as a supplementary aid in the analysis stage.
If not installed, Claude generates the copy entirely on its own. In both cases, there is no quality difference.
Check command: codex --version (if absent, run Claude alone)
Usage examples
- "Write copy for a wireless earbuds detail page — ANC, 30-hour battery, office worker target"
- "Make a vegan skincare set product page — category beauty"
- "Handmade wooden cutting board e-commerce detail page — handmade category, premium tone"
- "Dog probiotics detail page copy — has vet recommendation point"
Quality checklist (extended mode)
--mode diagnose:
- Score output for all 7 steps
- At least 1 line of improvement suggestion per step
- Specify 3 priority revision items
--mode copy:
- Include all 7 steps (no missing sections)
- 1 set each for main and secondary personas = 2 sets total
- Follow the 25/50/25 ratio (problem·empathy / core·proof / FAQ·CTA)
- ai-slop-reviewer review trace (slop_review block)
Related skills
Chaining: commerce-jtbd-persona --mode persona → commerce-detail-page-copy --mode diagnose → commerce-detail-page-copy --mode copy → commerce-product-naming
commerce-jtbd-persona— JTBD·Persona (enter --mode copy)moai-seller:commerce-detail-page-image— Composites a 13-section image based on the generated copymoai-seller:commerce-marketplace-coupang— Coupang policy application optimizationmoai-seller:commerce-marketplace-naver— SmartStore/open market optimizationmoai-marketer:content-copywriting— General ad copymoai-seller:commerce-product-detail— shadcn/ui-based web detail pagemoai-coworker:ai-slop-reviewer— Text review (automatically called in this skill)moai-writer:korean-humanize— Korean AI-ness removal (after slop review, required)
When not to use this skill
- Landing page (marketing one-pager):
moai-marketer:marketing-landing-pageuse - Blog posting:
moai-marketer:content-bloguse - SNS content:
moai-marketer:content-sns-contentuse - When only image compositing is needed:
moai-seller:commerce-detail-page-imageuse directly