$npx -y skills add Affitor/affiliate-skills --skill listicle-generatorWrite "Top N best..." listicle articles for affiliate marketing with mini-reviews, pricing, pros/cons, and CTAs per entry. Triggers on: "write a best of list", "top 10 [category] tools", "best [product category] article", "roundup post", "listicle about [category]", "write a top
| 1 | # Listicle Generator |
| 2 | |
| 3 | Write "Top N Best [Category]" roundup articles that rank on Google, capture featured snippets, and drive affiliate conversions across multiple products. Each list entry is a self-contained mini-review with features, pricing, pros/cons, audience fit, and a CTA. The article is structured to win both the featured snippet and the "People Also Ask" box. |
| 4 | |
| 5 | ## When to Use |
| 6 | |
| 7 | - User wants to cover an entire product category with multiple affiliate links |
| 8 | - User says "best", "top", "roundup", "list of", or mentions a number with a category |
| 9 | - User wants to capture high-volume generic keywords ("best email marketing tools") vs. specific product searches |
| 10 | - User has multiple affiliate programs in the same category and wants one article to cover them all |
| 11 | - User wants an article format that benefits from regular updates (add/remove products as market evolves) |
| 12 | |
| 13 | ## Workflow |
| 14 | |
| 15 | ### Step 1: Determine List Parameters |
| 16 | |
| 17 | Parse the user's request for: |
| 18 | - **Category**: what type of product (e.g., "email marketing tools", "AI video generators") |
| 19 | - **List size (N)**: explicitly stated number, or auto-select based on category depth |
| 20 | - Niche/specialized categories: 5-7 products |
| 21 | - Broad/competitive categories: 7-10 products |
| 22 | - Very broad (e.g., "project management tools"): 10-12 products |
| 23 | - **Target audience**: inferred from category + any context clues (beginners, enterprises, specific industries) |
| 24 | - **Year**: always use current year in the title for freshness signal |
| 25 | |
| 26 | **If no affiliate product is specified:** |
| 27 | - Ask: "Which product are you promoting? I'll feature it prominently in the list." |
| 28 | - If user says to proceed anyway, generate a balanced list and note where they should insert their affiliate link. |
| 29 | |
| 30 | ### Step 2: Research the Product Landscape |
| 31 | |
| 32 | Use `web_search` to build the product list: |
| 33 | |
| 34 | 1. **Seed query**: `"best [category] tools [year]" site:g2.com OR site:capterra.com OR site:trustradius.com` |
| 35 | 2. **Validate with traffic**: `"best [category]"` — check autocomplete for common phrasings |
| 36 | 3. **Find affiliate programs**: `"[category] affiliate program"` — identify which products offer commissions |
| 37 | |
| 38 | For each candidate product, gather: |
| 39 | - Product name and one-line description |
| 40 | - Starting price and free plan availability |
| 41 | - G2/Capterra rating (if available) |
| 42 | - The one thing it does best (unique angle) |
| 43 | - Who it's primarily designed for |
| 44 | |
| 45 | **Affiliate prioritization rules:** |
| 46 | - Position the user's affiliate product at #1 or #2 (never lower than #3 unless it genuinely cannot be defended in the top 3) |
| 47 | - #1 position gets the most clicks — use it for the highest-commission or best-converting product |
| 48 | - If the user has multiple affiliate programs, spread them in positions 1, 2, and 4 |
| 49 | - Non-affiliate products fill the remaining slots to make the list credible and balanced |
| 50 | |
| 51 | ### Step 3: Plan the Article Structure |
| 52 | |
| 53 | Map out every section before writing: |
| 54 | |
| 55 | **Article structure:** |
| 56 | 1. Title (with year, number, category) |
| 57 | 2. FTC disclosure |
| 58 | 3. Introduction (150-200 words) |
| 59 | 4. "At a Glance" summary table |
| 60 | 5. Evaluation criteria (H2) |
| 61 | 6. Individual product entries × N (H2 each) |
| 62 | 7. Comparison table (all products × key dimensions) |
| 63 | 8. How to Choose (H2) |
| 64 | 9. FAQ (H2) |
| 65 | 10. Final Recommendation (H2) |
| 66 | |
| 67 | **Per-entry structure** (400-600 words each): |
| 68 | - H2: `[Rank]. [Product Name] — [One-line Value Prop]` |
| 69 | - Opening paragraph: what it is, who made it, why it's on this list |
| 70 | - Key features section (3-5 bullet points) |
| 71 | - Pricing table (free / starter / pro / enterprise) |
| 72 | - Pros list (4-5 bullets) |
| 73 | - Cons list (2-3 bullets — be honest, builds trust) |
| 74 | - Best for: one sentence naming the ideal user |
| 75 | - Affiliate CTA button: `[Try [Product] free →](url)` |
| 76 | |
| 77 | ### Step 4: Write the Full Article |
| 78 | |
| 79 | **Title formula:** `[N] Best [Category] Tools in [Year] (Ranked and Reviewed)` |
| 80 | Alternative: `Best [Category] Software: Top [N] Picks for [Year]` |
| 81 | |
| 82 | **Introduction (150-200 words):** |
| 83 | - Open with the core problem this category solves |
| 84 | - Mention how many tools you evaluated and your selection criteria |
| 85 | - Name-drop 2-3 products from the list to signal comprehensiveness |
| 86 | - End with a transition: "Here are the [N] best options I found." |
| 87 | |
| 88 | **"At a Glance" Table** (immediately after intro, captures featured snippet): |
| 89 | ``` |
| 90 | | Tool | Best For | Star |