Skill: leooooooow/faq-builder (version 1.0.0)

--- name: faq-builder description: Generate comprehensive product FAQ sections by analyzing common customer questions, return reasons, and support tickets to preemptively answer objections and reduce pre-purchase hesitation on product pages. --- # FAQ Builder Generate comprehensive, conversion-focused FAQ sections for your product pages by systematically analyzing the questions real customers ask, the reasons they return products, and the objections that stall purchases. Instead of guessing what buyers want to know, this skill builds FAQ content grounded in actual customer pain points, structured to resolve hesitation at the moment it arises and reduce the support ticket volume that drains your team's bandwidth. ## Use when - You are launching a new product on Shopify, Amazon, or TikTok Shop and need a thorough FAQ section before the first customer lands on the page - Your support inbox is flooded with the same questions — "is this compatible with X?", "what's the return policy?", "how long does shipping take?" — and you want to deflect those tickets with preemptive answers on the product page - You have return and refund data showing common reasons like "not as described" or "wrong size" and want FAQ entries that address those exact issues before purchase - A product manager or listing specialist says "write me 10-15 FAQs for this product" and you need content that is specific, helpful, and strategically ordered to overcome buying objections rather than generic placeholder questions ## What this skill does This skill takes your product details, known customer questions, return reason data, and support ticket themes, then generates a prioritized FAQ section designed to reduce pre-purchase hesitation and post-purchase support load. It categorizes questions into logical groups — product specifications, compatibility and sizing, shipping and delivery, returns and warranty, usage instructions, and safety or compliance — then writes clear, concise answers that address the underlying concern rather than just the surface question. For example, if customers frequently ask "is this true to size?", the FAQ answer does not just say "yes" — it provides specific measurement guidance, comparison to popular brands, and links to a size chart. The skill also identifies gaps where common objections are not yet covered and suggests additional FAQ entries to fill those blind spots. Questions are ordered strategically so the highest-impact objection-busters appear first. ## Inputs required - **Product name and description** (required): What you are selling with enough detail to write accurate answers — e.g., "Wireless Bluetooth earbuds, ANC, 30hr battery, IPX5 waterproof, USB-C charging" - **Known customer questions** (required): List of real questions from support tickets, reviews, chat logs, or Q&A sections — paste them in raw, the skill will clean and categorize them - **Return reason data** (optional): Top reasons customers return this product or similar products — e.g., "25% say not comfortable for long wear, 15% say pairing issues with Android" — so the FAQ can preemptively address these - **Target platform** (optional): Where the FAQ will be published (Amazon A+ Content, Shopify product page, TikTok Shop listing) so formatting and length suit platform constraints - **Brand voice** (optional): Tone description so FAQ answers match your brand — e.g., "technical and precise" or "friendly and approachable" ## Output format The output is a structured FAQ document organized into five to seven thematic sections. Each section has a clear heading such as Product Specifications, Sizing and Fit, Shipping and Delivery, Returns and Warranty, Usage and Care, and Compatibility. Under each heading, individual FAQ entries follow a consistent Q&A format with the question bolded and the answer written in two to four sentences that directly address the concern with specific, verifiable details rather than vague reassurances. After the FAQ entries, the output includes an Objection Gap Analysis — a short list of two to four additional questions the skill recommends adding based on patterns it detected in the inputs, such as frequently returned categories or unanswered concerns implied by the product type. Finally, a Platform Notes section provides formatting recommendations if a target platform was specified, including character limit guidance for Amazon Q&A versus Shopify accordion blocks and tips on keyword placement within answers for SEO benefit. ## Scope - Designed for: ecommerce operators, listing specialists, product managers, customer support leads - Platform context: Amazon, Shopify, TikTok Shop, Shopee, WooCommerce, platform-agnostic - Language: English ## Limitations - Does not pull live customer questions or reviews from any platform — you provide the input data and the skill structures and expands it into FAQ format - Answers are based on the product information you supply; if critical specs are missing from your input, the FAQ may contain gaps or require manual editing - Not a substitute for legal or regulatory compliance statements — if your product requires specific safety disclosures or certifications, those should be reviewed by a compliance professional before publishing


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)