AgentSkillsCN

product-spec

将产品简报、网站与文档转化为结构化的产品规格。生成适用于着陆页、指南与营销材料的模块化 Markdown 文件。

SKILL.md
--- frontmatter
name: product-spec
description: Convert product briefs, websites, documents into structured product specs. Generates modular markdown files for landing pages, guides, marketing.

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

code
/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

ModulePurposeGenerates
core.mdIdentity, problem, solutionHero, about
audience.mdPersonas, JTBD, painsTargeting
offer.mdPricing, value stack, guaranteePricing cards
copy.mdHeadlines, hooks, CTAsLanding, ads
faq.mdObjections & responsesFAQ sections
guide.mdHow to useUser docs

Process: Brief → Spec

Phase 1: Extract Information

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

code
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

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

Step 2: Map to Structure

code
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

code
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

csv
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:

code
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