Agent Skills: Product Spec Generator

Product Spec Generator

Purpose

Transform unstructured product information into structured, modular specs that can generate:

• Landing pages
• Marketing copy
• User guides
• Sales materials

Entry Points

/product-spec [url]         → Extract from website
/product-spec [brief]       → Convert brief to spec
/product-spec audit [slug]  → Audit existing spec
/product-spec update [slug] → Update specific module

Data Location

• Templates: data/products/_templates/
• Products: data/products/[slug]/
• Index: data/products/index.csv

Module Structure

| Module | Purpose | Generates | | ------------- | ------------------------------- | ------------- | | core.md | Identity, problem, solution | Hero, about | | audience.md | Personas, JTBD, pains | Targeting | | offer.md | Pricing, value stack, guarantee | Pricing cards | | copy.md | Headlines, hooks, CTAs | Landing, ads | | faq.md | Objections & responses | FAQ sections | | guide.md | How to use | User docs |

Process: Brief → Spec

Phase 1: Extract Information

From input (brief, URL, document), identify:

IDENTITY
├── What is it? (type, name)
├── Who made it? (brand, creator)
└── What category? (workshop/course/membership/product)

PROBLEM
├── Surface pains (observable symptoms)
├── Root cause (deeper issue)
└── Cost of inaction (what happens if unsolved)

SOLUTION
├── Core approach (how you solve it)
├── Key mechanism (specific method)
└── Dream outcome (transformation)

AUDIENCE
├── Primary persona (who exactly)
├── Jobs to be done (functional/emotional/social)
├── Pains & gains (specific)
└── Triggers (when they buy)

OFFER
├── Price & model
├── What's included (value stack)
├── Delivery method
├── Guarantee
└── Scarcity/urgency

PROOF
├── Credentials
├── Results/metrics
└── Testimonials

Phase 2: Ask Clarifying Questions

If information is missing, ask:

Identity:

• "Đây là loại gì? (workshop/course/membership/product)"
• "Target segment nào? (AI Office/Vibe Coder/both)"

Problem:

• "Vấn đề cụ thể họ đang gặp là gì?"
• "Nếu không giải quyết thì chuyện gì xảy ra?"

Solution:

• "Cách tiếp cận của bạn khác gì competitor?"
• "Kết quả cuối cùng (dream outcome) là gì?"

Offer:

• "Giá bao nhiêu? Model nào (one-time/monthly)?"
• "Có guarantee không? Loại nào?"

Phase 3: Generate Modules

For each module, use template from data/products/_templates/

Output:

1. Create folder: data/products/[slug]/
2. Generate each module file
3. Update data/products/index.csv

Process: URL → Spec

Step 1: Fetch & Parse

WebFetch URL → Extract:
- Headlines, taglines
- Feature lists
- Pricing information
- Testimonials
- FAQ content

Step 2: Map to Structure

Website Section → Module
─────────────────────────
Hero/Header    → core.md (one-liner, dream outcome)
About/Story    → core.md (problem, solution)
Features       → core.md (differentiators), offer.md (value stack)
Pricing        → offer.md (price, model, guarantee)
Testimonials   → copy.md (social proof)
FAQ            → faq.md

Step 3: Fill Gaps

Ask user for missing information before generating.

Quality Checklist

CORE.MD
□ One-liner is clear and benefit-focused?
□ Problem has surface + root + cost?
□ Solution has approach + mechanism + outcome?
□ Differentiators are specific, not generic?
□ Proof is verifiable?

AUDIENCE.MD
□ Persona is specific (not "everyone")?
□ JTBD covers functional/emotional/social?
□ Pains are real and ranked?
□ Triggers are actionable moments?
□ "Not for" is defined?

OFFER.MD
□ Value equation scored?
□ Value stack > 10x price perception?
□ Delivery method clear?
□ Guarantee matches product type?
□ Price anchoring included?

COPY.MD
□ Headlines are benefit-focused?
□ Hooks create tension/curiosity?
□ CTAs are action-oriented?
□ Social proof is specific?

FAQ.MD
□ Top objections addressed?
□ Root concerns identified?
□ Responses are conversational?

Index CSV Format

slug,name,type,segment,price,currency,status,tagline,updated
premium-membership,Premium Membership,membership,ai-office,199000,VND/mo,active,"AI làm việc CHO bạn",2026-01-26
vip-membership,VIP Membership,membership,vibe-coder,349000,VND/mo,active,"Ship production products",2026-01-26

Example: Brief → Spec

Input:

Tôi muốn tạo spec cho workshop AI Office Masterclass.
- 3 giờ, live
- Giá 399K
- Dành cho AI Office segment
- Học cách build AI workflow đầu tiên
- Có recording, templates, Q&A

Output:

Creates data/products/ai-office-masterclass/:

• core.md - Workshop identity, problem (manual AI usage), solution (workflow approach)
• audience.md - AI Office persona, pains (time wasted, no scaling)
• offer.md - 399K pricing, value stack (workshop + recording + templates)
• copy.md - Headlines, hooks for landing page
• faq.md - Common workshop objections

Updates data/products/index.csv with new row.

Integration with Other Skills

offer-creation: Uses offer.md structure landing-page: Pulls from all modules to generate page content-repurposing: Uses copy.md for content variations

Voice & Tone

When generating copy modules, follow brand voice:

• Personal (mình/bạn)
• Direct (no fluff)
• Practical (actionable)
• Mix Anh-Việt naturally

Avoid:

• Corporate speak
• Hype words
• Empty promises