ai-blog-generation

Use this skill when generating new blog posts or refreshing existing content.

Core philosophy:

• •Reader-first: Every post must provide genuine value before any monetization consideration
• •Quality over quantity: Fewer excellent posts beat many mediocre ones
• •Answer real questions: Target what Filipinos are actually searching for
• •Natural monetization: Include 3 product recommendations per post, 1 link per product, only when genuinely helpful. If a different count is needed, get explicit user approval.
• •Always request affiliate links from the user before inserting any affiliate URLs.

Content tiers (choose based on topic depth):

• •Pillar: Comprehensive guides (2,000+ words) for high-value topics
• •Cluster: Standard posts (900-1,500 words) for focused topics
• •Quick: Concise answers (500-900 words) for simple questions

Pre-generation requirements (MANDATORY):

1. •Keyword research: Use the keyword-research skill to identify a valid topic
2. •Topic registry check: Verify the topic is not already covered
3. •Content tier decision: Choose Pillar, Cluster, or Quick based on topic depth
4. •Value assessment: Confirm we can provide genuine, helpful content

Workflow options:

OPTION A: Content without product recommendations (exception only)

• •For how-to guides, explainers, tips, and informational content where no product is genuinely helpful
• •Ask the user to explicitly approve publishing without affiliate links before proceeding
• •If the user wants product recommendations, switch to Option B and include a small, genuinely helpful recommendation section

OPTION B: Content with product recommendations (two-phase workflow)

• •Phase 1: Product Plan (no blog content yet)
  • •Propose the blog topic, target intent, and outline
  • •Identify products that would genuinely help the reader (exactly 3 items unless the user approves a different count)
  • •For each product, include:
    • •Exact product name as it should appear in the article
    • •Why it helps the reader (not just "it's available on Shopee")
    • •Category tag
  • •Ask the user to provide affiliate links for each recommended product
  • •Stop after Phase 1 and wait for user confirmation/links
• •Phase 2: Full Blog Generation (after user provides links)
  • •Use only user-provided or user-confirmed links for affiliate URLs
  • •Product name text must be the hyperlink
  • •If any product is missing a link, either:
    • •Downgrade to a mention (no link)
    • •Remove from recommendations
  • •Provide Affiliate Link Audit at end

Affiliate link request workflow:

• •For every recommended product, present product name and reason for recommendation
• •Ask: "Please provide the affiliate link for this product, or type SKIP to continue without it."
• •Wait for user input before proceeding
• •When content does not need product recommendations:
  • •Ask the user to approve publishing without affiliate links or provide suitable products to recommend

Content quality guidelines:

• •Answer the reader's question first, before any product mentions
• •Provide genuine value even if the reader never clicks an affiliate link
• •Do not force products into unrelated content
• •Perform deep research using reputable sources
• •Clearly separate verified facts from assumptions
• •Do not claim personal testing or hands-on reviews
• •Write clean, publication-ready copy
• •Do not use em dashes or en dashes; use hyphen-minus or commas and periods

Copyright and asset usage:

• •Do not use copyrighted images, text, or media without permission
• •Do not copy content from brand sites, marketplaces, or other blogs
• •All written content must be original and paraphrased properly
• •Only use images that are public domain, CC0, or royalty-free
• •Do not hotlink images from Shopee, TikTok Shop, or brand websites
• •Prefer generic, non-branded visuals

Topic Registry (MANDATORY):

• •Maintain at /docs/topic-registry.md
• •For every published post, record:
  • •Post title and slug
  • •Primary search intent
  • •Target keyword
  • •Content tier (Pillar/Cluster/Quick)
  • •Volume tier (High/Medium/Low/Emerging)
  • •Core angle
  • •Primary category
  • •Key products mentioned (if any)
  • •Status
• •Update registry when new posts are generated

Pre-generation content scan (MANDATORY):

• •Before generating, read the Topic Registry
• •Compare proposed topic against existing entries
• •Check for intent overlap, angle similarity, and audience match

Duplicate prevention rules:

• •BLOCK generation if ALL are true:
  • •Same primary intent as existing post
  • •Same core angle
  • •Value would be redundant
• •ALLOW generation if ANY are true:
  • •Different use case or audience
  • •Different question being answered
  • •Different comparison dimension
• •Product reuse is allowed (same product in multiple posts)
• •Duplicate blogs with same list and framing are not allowed

Content length rules:

• •Pillar: 2,000+ words (comprehensive guides)
• •Cluster: 900-1,500 words (focused topics)
• •Quick: 500-900 words (simple answers)
• •Do not pad with fluff; expand with useful sections if needed
• •Word count for validation only; do not print in content

Affiliate integration rules (required per post unless user-approved exception):

• •Default 3 affiliate links per post, one per product
• •Exceeding 3 requires explicit user approval; if approved, stay under 6 per 1,000 words
• •Link each product only once per article
• •Product name text should be the hyperlink
• •Use rel="sponsored noopener noreferrer" and target="_blank"
• •Prefer placing links in dedicated recommendation sections
• •Avoid mid-sentence links unless they add decision value
• •Distinguish mentions (no link) from recommendations (link eligible)

Content integrity:

• •Avoid turning posts into link farms
• •Prefer one clear CTA block per recommendation section
• •Never use urgency, fake scarcity, or deceptive language
• •Do not promise earnings or guaranteed savings

Per-post affiliate disclosure: NOT required

• •Site-wide Disclaimer page at /disclaimer handles this

Output requirements:

• •Structured frontmatter: title, description, slug, date, category, tags
• •Clear introduction, scannable headings, concise summaries
• •Internal links to related posts when available
• •When linking categories or tags, use archive URLs:
  • •/blog/category/[slug]/
  • •/blog/tag/[slug]/
• •Include Affiliate Link Audit (non-publishable) listing product, URL, section when links are used
• •Accurate dates with "may change" disclaimer where applicable
• •Provide a Facebook post script after the blog content:
  • •Use the format below for readability:
    code

    [Post Title]
    
    [2-4 sentence summary]
    
    Safety reminder: Do your own research and verify seller ratings and reviews.
    Liability note: Purchases are your responsibility.
    Read more: [PASTE LINK]
    

Cover image requirements:

• •Every post must have a cover image in /public/images/
• •Format: JPG or PNG only (no SVG)
• •Ratio: 16:9 preferred
• •Naming: cover-[topic-slug].jpg
• •If no suitable image exists, note it and request user to provide one

New post checklist (after generation):

1. •Verify content provides genuine value to the reader
2. •Confirm 3 affiliate links are included (one per product), or the user approved a different count or exception
3. •Confirm affiliate links are user-provided
4. •Update topic-registry.md with new entries
5. •Run build to regenerate sitemap/feed: npm run build
6. •Run sensitive data scan (required by copilot-instructions.md)
7. •Provide a Facebook post script for the new blog

BEFORE PUSHING - Cover Image Reminder (MANDATORY):

• •Stop and remind user to create cover images for all new posts
• •For each post, provide:
  • •Required filename: /public/images/[slug].jpg
  • •Canva prompt suggestion: A simple, descriptive prompt for creating a copyright-safe cover image
  • •Example: "Minimalist flat illustration of a home office desk with laptop, notebook, and coffee mug. Clean background, soft colors, 16:9 ratio."
• •Canva prompt guidelines:
  • •Use generic, non-branded visuals
  • •Avoid logos, trademarks, or identifiable brand packaging
  • •Suggest lifestyle or category illustrations over specific products
  • •Specify 16:9 ratio in the prompt
• •Wait for user confirmation that images are ready before proceeding to push

Pinterest Pin Reminder (MANDATORY):

• •After generating a new post and receiving affiliate links, remind the user to create Pinterest pins
• •For each new post, provide:
  • •Pin title: Post title
  • •Pin description: Post meta description
  • •Pin URL: https://sulitfinds.com/blog/[slug]/
  • •Board: "Budget Finds Philippines" (or relevant board)
  • •Suggested hashtags: 5-6 relevant tags based on post category and keywords
• •Example output format:
  code

  Pinterest Pin for: [Post Title]
  - Image: /public/images/[slug].jpg
  - Title: [Post Title]
  - Description: [Meta description]
  - URL: https://sulitfinds.com/blog/[slug]
  - Board: Budget Finds Philippines
  - Tags: #budgettips #philippines #[topic] #[category] #sulitfinds
  

Quality checks before publishing:

• •Does the post answer the reader's question? (required)
• •Would this post be valuable even without affiliate links? (required)
• •Does the post include 3 affiliate links (one per product), or is there explicit approval for a different count or no links? (required)
• •Clear introduction and scannable headings?
• •Accurate information with sources?
• •Unique title and compelling meta description?
• •Natural keyword usage (not stuffed)?

Scope:

• •Applies to new and refreshed blog posts
• •Does not apply to About page, Disclaimer page, or UI copy