@lebtiga/sonic-agent 1.0.0

package/plugin/skills/aka-wireframe-wp/references/prompts-library.md

@@ -0,0 +1,880 @@
+# Master Prompts Collection - Complete Library
+
+## How to Use This Library
+
+1. **Find the prompt** for your task
+2. **Replace [VARIABLES]** with your specific information
+3. **Copy to AI** (Claude, ChatGPT, etc.)
+4. **Review output** and refine
+5. **Deploy content**
+
+---
+
+## Table of Contents
+
+1. [Strategy & Planning Prompts](#strategy--planning-prompts)
+2. [Keyword Research Prompts](#keyword-research-prompts)
+3. [Content Generation Prompts](#content-generation-prompts)
+4. [SEO Optimization Prompts](#seo-optimization-prompts)
+5. [Code Generation Prompts](#code-generation-prompts)
+6. [Internal Linking Prompts](#internal-linking-prompts)
+7. [Conversion Optimization Prompts](#conversion-optimization-prompts)
+
+---
+
+## Strategy & Planning Prompts
+
+### 1. Generate AKA Content Structure
+
+```
+I'm creating a comprehensive SEO content strategy for my business using the 
+AKA (Authority-Knowledge-Answer) framework.
+
+**Business Details**:
+- Business: [BUSINESS_NAME]
+- Industry: [INDUSTRY]
+- Location: [CITY, STATE]
+- Main Services: [LIST 3-5 SERVICES]
+- Target Audience: [WHO YOU SERVE]
+
+**Task**: Generate a complete AKA content structure including:
+
+1. **5-7 Authority Hub Topics**
+   - Each should be a major service/topic area
+   - Include primary keyword for each
+   - Explain why each hub is important
+
+2. **For Each Authority Hub**: List 12-15 Knowledge Page Topics
+   - Specific subtopics within the hub
+   - Target mid-tail keywords
+   - Explain the connection to parent hub
+
+3. **For Each Authority Hub**: List 20-25 Answer Page Questions
+   - Organize by question type (How, What, Why, When, Cost)
+   - Use natural language as people would search
+   - Target featured snippets
+
+4. **URL Structure Recommendation**
+   - Suggest optimal URL hierarchy
+   - Example URLs for each page type
+
+5. **Content Priority Ranking**
+   - Which hubs to create first
+   - Which pages drive most traffic/conversions
+
+**Output Format**: 
+- Organized by hub
+- Clear hierarchy
+- Actionable implementation order
+
+Generate this complete content architecture.
+```
+
+### 2. Competitor Content Gap Analysis
+
+```
+Analyze competitor content and identify gaps for my business to exploit.
+
+**My Business**:
+- Name: [BUSINESS_NAME]
+- Industry: [INDUSTRY]
+- Location: [LOCATION]
+- Main Service: [PRIMARY_SERVICE]
+
+**Competitors** (provide URLs):
+1. [COMPETITOR_1_URL]
+2. [COMPETITOR_2_URL]
+3. [COMPETITOR_3_URL]
+
+**Analysis Needed**:
+1. **Content Topics Competitors Cover**: List all major topics they have content about
+2. **Content Gaps**: Topics they DON'T cover well or at all
+3. **Depth Analysis**: Topics where their content is shallow
+4. **Question Gaps**: Questions people ask that they don't answer
+5. **Local Gaps**: Local/location-specific content missing
+6. **Opportunities**: Topics where I can create superior content
+
+**Provide**:
+- 20 content topics competitors miss entirely
+- 15 topics where I can create better/deeper content
+- 30 specific questions they don't answer
+- 10 local angles they ignore
+
+This will inform my content strategy to outrank them.
+```
+
+### 3. Keyword Clustering for Hubs
+
+```
+Create keyword clusters for my Authority Hubs.
+
+**Industry**: [INDUSTRY]
+**Location**: [CITY, STATE]
+**Main Topic**: [PRIMARY_TOPIC]
+
+**Task**: Generate keyword clusters for content organization:
+
+**For Authority Hub**: [HUB_TOPIC]
+
+1. **Head Keywords** (3-5):
+   - High volume, competitive
+   - Primary targets for Authority page
+
+2. **Mid-Tail Keywords** (15-20):
+   - Moderate volume
+   - Targets for Knowledge pages
+   - Each can support a 2,000-word page
+
+3. **Long-Tail Keywords** (30-40):
+   - Lower volume, specific
+   - Targets for Answer pages
+   - Question format preferred
+
+4. **LSI Keywords** (20-30):
+   - Related terms and synonyms
+   - To be distributed across all content
+
+5. **Local Modifiers** (10-15):
+   - Location-specific variations
+   - [Service] + [City/Area] combinations
+
+**Organize by**:
+- Search intent (informational, commercial, transactional)
+- Difficulty score (estimate)
+- Priority for implementation
+
+Generate complete keyword ecosystem for this hub.
+```
+
+---
+
+## Keyword Research Prompts
+
+### 4. "People Also Ask" Questions Generator
+
+```
+Generate "People Also Ask" style questions for my industry.
+
+**Topic**: [YOUR_TOPIC]
+**Industry**: [INDUSTRY]
+**Audience**: [TARGET_AUDIENCE]
+
+**Generate 50 questions** people commonly ask about [TOPIC], organized by:
+
+1. **How Questions** (Process/Instructions) - 10 questions
+2. **What Questions** (Definitions/Explanations) - 10 questions
+3. **Why Questions** (Reasoning/Importance) - 8 questions
+4. **When Questions** (Timing/Urgency) - 7 questions
+5. **Cost Questions** (Pricing/Value) - 8 questions
+6. **Comparison Questions** (This vs That) - 7 questions
+
+**Requirements**:
+- Use natural language as people actually search
+- Include [LOCATION] where relevant
+- Focus on [AUDIENCE]'s pain points
+- Questions should drive toward my services
+
+These will become Answer pages optimized for featured snippets.
+```
+
+### 5. Long-Tail Keyword Expander
+
+```
+Expand this seed keyword into long-tail variations.
+
+**Seed Keyword**: [PRIMARY_KEYWORD]
+**Industry Context**: [INDUSTRY]
+**Location**: [CITY, STATE]
+
+**Generate 100 long-tail keyword variations** including:
+
+1. **Question-Based** (30):
+   - How to...
+   - What is...
+   - Why does...
+   - When should...
+   - Can I...
+
+2. **Problem-Based** (20):
+   - [Problem] solution
+   - [Problem] help
+   - [Problem] fix
+
+3. **Comparison-Based** (15):
+   - [Option A] vs [Option B]
+   - [Service] compared
+   - Best [service] for...
+
+4. **Location-Based** (20):
+   - [Keyword] near me
+   - [Keyword] in [city]
+   - [Neighborhood] [keyword]
+
+5. **Intent-Based** (15):
+   - [Keyword] cost
+   - [Keyword] reviews
+   - Best [keyword]
+   - Cheap [keyword]
+   - Emergency [keyword]
+
+**Format**: 
+Keyword | Est. Volume | Intent | Content Type Suggestion
+```
+
+---
+
+## Content Generation Prompts
+
+### 6. Complete Authority Hub Generator
+
+```
+[USE THE DETAILED PROMPT FROM /02-AI-AGENT-SYSTEM/WP-Content-Generator-UNIVERSAL.md]
+
+VARIABLES TO FILL:
+- [BUSINESS_NAME]: _____
+- [INDUSTRY]: _____
+- [SERVICE_TYPE]: _____
+- [LOCATION]: _____
+- [STATE]: _____
+- [PRIMARY_KEYWORD]: _____
+- [TARGET_AUDIENCE]: _____
+- [PAIN_POINTS]: _____
+- [BRAND_VOICE]: _____
+- [CTA]: _____
+- [PHONE]: _____
+
+[Then use the full Authority Page template]
+```
+
+### 7. Knowledge Page Generator (Batch)
+
+```
+Generate 5 Knowledge Pages for my [HUB_TOPIC] Authority Hub.
+
+**Business Context**:
+- Business: [BUSINESS_NAME]
+- Industry: [INDUSTRY]
+- Parent Hub: [HUB_TOPIC]
+- Location: [CITY, STATE]
+- Brand Voice: [VOICE_DESCRIPTION]
+
+**Generate complete 2,000-word Knowledge Pages for these 5 topics**:
+
+1. [KNOWLEDGE_TOPIC_1]
+2. [KNOWLEDGE_TOPIC_2]
+3. [KNOWLEDGE_TOPIC_3]
+4. [KNOWLEDGE_TOPIC_4]
+5. [KNOWLEDGE_TOPIC_5]
+
+**Each Page Must Include**:
+- H1, H2, H3 hierarchy
+- Introduction (200 words)
+- Main sections (1,500 words)
+- Related topics section
+- 2 CTAs
+- Suggested internal links with [LINK: target]
+- Suggested images with [IMAGE: description]
+- Meta description (155 chars)
+- Primary keyword (with density 0.8-1.2%)
+
+**Format**: 
+--- PAGE 1: [TITLE] ---
+[Content]
+---END PAGE 1---
+
+[Repeat for all 5 pages]
+```
+
+### 8. Featured Snippet Optimizer
+
+```
+Optimize this Answer Page content for Google featured snippets.
+
+**Current Question**: [QUESTION]
+**Current Answer**: [PASTE CURRENT ANSWER]
+
+**Optimize for**:
+1. **Paragraph Featured Snippet** (40-60 words)
+   - Direct answer
+   - Concise and complete
+   - Starts with the question
+
+2. **List Featured Snippet** (if applicable)
+   - Numbered or bulleted
+   - 5-8 steps/items
+   - Each item one sentence
+
+3. **Table Featured Snippet** (if applicable)
+   - Comparison or data
+   - 3-5 columns
+   - Clear headers
+
+**Provide**:
+- Best featured snippet format for this question
+- Optimized snippet text
+- Where to place in content (beginning)
+- Related questions to include (3-5)
+- Schema markup suggestion
+
+**Context**:
+- Industry: [INDUSTRY]
+- Audience: [AUDIENCE]
+- Brand: [BUSINESS_NAME]
+```
+
+### 9. Local SEO Content Adapter
+
+```
+Adapt this content template for a specific city/location.
+
+**Base Content**: [PASTE TEMPLATE CONTENT]
+
+**Adapt For**:
+- City: [CITY_NAME]
+- State: [STATE]
+- Neighborhood/Area: [IF_APPLICABLE]
+
+**Localization Requirements**:
+
+1. **Replace Generic with Local**:
+   - Generic statistics → [CITY] statistics
+   - General laws → [STATE] specific laws
+   - Generic examples → [CITY] examples
+
+2. **Add Local Elements**:
+   - Local landmarks mentions
+   - Area-specific considerations
+   - Neighborhood references
+   - Local business mentions
+   - [CITY] specific data
+
+3. **Local Keywords**:
+   - Integrate [CITY] naturally (5-8 times)
+   - Include [NEIGHBORHOOD] where relevant
+   - Add "[SERVICE] near me" context
+
+4. **Local Schema**:
+   - LocalBusiness markup
+   - Service area definitions
+   - Local address/phone
+
+**Output**: Fully localized version ready to publish.
+```
+
+---
+
+## SEO Optimization Prompts
+
+### 10. Meta Data Generator (Bulk)
+
+```
+Generate SEO metadata for multiple pages.
+
+**Business**: [BUSINESS_NAME]
+**Industry**: [INDUSTRY]
+**Location**: [CITY, STATE]
+
+**Generate optimized metadata for these 10 pages**:
+
+1. [PAGE_TITLE_1] - Keyword: [KEYWORD_1]
+2. [PAGE_TITLE_2] - Keyword: [KEYWORD_2]
+[...continue to 10]
+
+**For Each Page Provide**:
+
+**Title Tag** (max 60 characters):
+- Include primary keyword
+- Include location (if local)
+- Include brand name
+- Compelling and clickable
+
+**Meta Description** (max 155 characters):
+- Include primary keyword naturally
+- Clear value proposition
+- Call to action
+- Benefit-focused
+
+**Focus Keyword**: [Primary keyword]
+
+**Secondary Keywords** (3-5): [Related keywords]
+
+**URL Slug**: [optimized-slug]
+
+**Image Alt Text** (3 suggestions per page):
+- Descriptive with keywords
+- Natural language
+- Relevant to image
+
+**Format as CSV**:
+Page, Title Tag, Meta Description, Focus Keyword, URL Slug
+```
+
+### 11. Internal Linking Strategy Generator
+
+```
+Create an internal linking strategy for my content structure.
+
+**Site Structure**:
+- 5 Authority Hubs: [LIST_HUBS]
+- 75 Knowledge Pages (15 per hub)
+- 125 Answer Pages (25 per hub)
+
+**Generate Linking Rules**:
+
+1. **Authority Page Linking**:
+   - Links TO: [Which pages]
+   - Links FROM: [Which pages]
+   - Anchor text examples: [5 examples]
+   - Link count: [How many per page]
+
+2. **Knowledge Page Linking**:
+   - Links TO: [Which pages]
+   - Links FROM: [Which pages]
+   - Anchor text examples: [5 examples]
+   - Link count: [How many per page]
+
+3. **Answer Page Linking**:
+   - Links TO: [Which pages]
+   - Links FROM: [Which pages]
+   - Anchor text examples: [5 examples]
+   - Link count: [How many per page]
+
+4. **Cross-Hub Linking**:
+   - When to link between hubs
+   - How to identify opportunities
+   - Anchor text strategies
+
+5. **Priority Link Paths**:
+   - Top 10 most important link paths
+   - Conversion-focused link chains
+
+**Output**: 
+- Linking rule matrix
+- Specific link suggestions for each page type
+- Implementation priority order
+```
+
+### 12. Schema Markup Generator
+
+```
+Generate appropriate schema markup for this page.
+
+**Page Type**: [Authority / Knowledge / Answer / Location]
+**Business**: [BUSINESS_NAME]
+**Industry**: [INDUSTRY]
+**Page Topic**: [TOPIC]
+
+**Page URL**: [URL]
+**Published Date**: [DATE]
+
+**Generate Schema Markup for**:
+
+1. **Article Schema** (if applicable)
+   - headline, author, publisher
+   - datePublished, dateModified
+   - image, description
+
+2. **Service Schema** (if service page)
+   - serviceType
+   - provider
+   - areaServed
+
+3. **Local Business Schema** (if location)
+   - name, address, phone
+   - geo coordinates
+   - openingHours
+
+4. **FAQ Schema** (if Q&A format)
+   - questions and acceptedAnswers
+   - proper JSON-LD format
+
+5. **Review/Rating Schema** (if applicable)
+   - aggregateRating
+   - review details
+
+**Output**: 
+- Complete JSON-LD code
+- Where to place in page
+- Validation instructions
+```
+
+---
+
+## Code Generation Prompts
+
+### 13. WordPress Custom Page Template
+
+```
+Generate a WordPress custom page template.
+
+**Template For**: [PAGE_TYPE] (Authority/Knowledge/Answer)
+**Features Needed**:
+- [LIST_FEATURES]
+
+**Generate Complete PHP Template** including:
+
+1. **Template Header**:
+   - Template Name comment
+   - get_header() call
+
+2. **Custom Loop**:
+   - Page content display
+   - Custom fields integration
+   - Dynamic content sections
+
+3. **Sidebar** (if applicable):
+   - Related posts widget
+   - CTA widget
+   - Navigation widget
+
+4. **Schema Markup**:
+   - Proper JSON-LD
+   - Dynamic data from WordPress
+
+5. **Footer**:
+   - get_footer() call
+
+**Custom Fields** (if needed):
+- [LIST_CUSTOM_FIELDS]
+
+**CSS Classes** to use:
+- [LIST_CLASSES]
+
+**Output**: Complete, ready-to-use PHP template file with comments.
+```
+
+### 14. Content Import Script
+
+```
+Generate a PHP script to bulk import content to WordPress.
+
+**Import Requirements**:
+- Content source: [JSON / CSV / Array]
+- Number of pages: [COUNT]
+- Page type: [TYPE]
+- Parent page: [IF_APPLICABLE]
+
+**Script Should**:
+
+1. **Read Content** from [SOURCE_TYPE]
+2. **Create Posts** with:
+   - post_title
+   - post_content
+   - post_status (publish/draft)
+   - post_type
+   - post_parent (if hierarchical)
+
+3. **Set Metadata**:
+   - Custom fields
+   - Featured image
+   - Categories/tags
+   - Template assignment
+
+4. **Handle Errors**:
+   - Duplicate checking
+   - Error logging
+   - Success confirmation
+
+5. **Progress Display**:
+   - Count of imported
+   - Failures reported
+   - Time elapsed
+
+**Output**: Complete PHP script with usage instructions.
+```
+
+---
+
+## Internal Linking Prompts
+
+### 15. Contextual Link Opportunity Finder
+
+```
+Find internal linking opportunities in this content.
+
+**Content**: [PASTE_CONTENT]
+
+**Available Pages to Link To**:
+[LIST 20-30 EXISTING PAGES WITH TITLES AND URLS]
+
+**Find 8-12 Internal Link Opportunities** where:
+
+1. **Context is Natural**:
+   - Relevant to sentence/paragraph
+   - Adds value for reader
+   - Flows naturally
+
+2. **Anchor Text is Optimal**:
+   - Uses target keyword naturally
+   - Not forced or awkward
+   - Varies (not always exact match)
+
+3. **Link Placement Strategic**:
+   - Early in content for priority links
+   - Distributed throughout
+   - In valuable content sections
+
+**For Each Link Provide**:
+- Quote of sentence/paragraph where link goes
+- Specific anchor text to use
+- Target page and URL
+- Reason why this link adds value
+
+**Format**:
+```
+Link 1:
+Context: "[quote from content]"
+Anchor Text: "[exact text to link]"
+Target: [Page Title] - [URL]
+Value: [Why this helps the reader]
+```
+
+### 16. Hub-to-Hub Cross-Linking Strategy
+
+```
+Create cross-linking strategy between my Authority Hubs.
+
+**Authority Hubs**:
+1. [HUB_1_TITLE] - [PRIMARY_TOPIC_1]
+2. [HUB_2_TITLE] - [PRIMARY_TOPIC_2]
+3. [HUB_3_TITLE] - [PRIMARY_TOPIC_3]
+4. [HUB_4_TITLE] - [PRIMARY_TOPIC_4]
+5. [HUB_5_TITLE] - [PRIMARY_TOPIC_5]
+
+**For Each Hub**, identify:
+
+1. **Natural Connection Points** to other hubs:
+   - Where topics overlap
+   - Related concepts
+   - Customer journey connections
+
+2. **Link Opportunities**:
+   - Hub 1 → Which hubs? (with anchor text)
+   - Hub 2 → Which hubs? (with anchor text)
+   - [Continue for all]
+
+3. **Link Context**:
+   - Where in content to place
+   - Why it's relevant
+   - What it adds for reader
+
+4. **Priority Paths**:
+   - Most important hub-to-hub connections
+   - Conversion-focused link chains
+
+**Output**: Matrix showing all cross-hub linking opportunities.
+```
+
+---
+
+## Conversion Optimization Prompts
+
+### 17. CTA Copy Generator
+
+```
+Generate high-converting CTA copy for my pages.
+
+**Business**: [BUSINESS_NAME]
+**Service**: [PRIMARY_SERVICE]
+**Audience**: [TARGET_AUDIENCE]
+**Page Type**: [PAGE_TYPE]
+
+**Generate 10 CTA Variations** for each position:
+
+**Position 1: Header/Hero CTA** (Soft offer)
+- Headline (5-8 words)
+- Subtext (10-15 words)
+- Button text (2-4 words)
+[10 variations]
+
+**Position 2: Mid-Content CTA** (Medium pressure)
+- Headline (6-10 words)
+- Benefit statement (15-20 words)
+- Button text (2-4 words)
+[10 variations]
+
+**Position 3: End-of-Content CTA** (Strong, urgent)
+- Headline (6-10 words)
+- Urgency statement (15-20 words)
+- Button text (2-4 words)
+- Trust statement (10-15 words)
+[10 variations]
+
+**Requirements**:
+- Address pain points: [LIST_PAIN_POINTS]
+- Overcome objections: [LIST_OBJECTIONS]
+- Emphasize benefits: [LIST_BENEFITS]
+- Include: [PHONE] or form offer
+- Brand voice: [VOICE_DESCRIPTION]
+
+Provide A/B testing recommendations.
+```
+
+### 18. Lead Magnet Content Creator
+
+```
+Create a lead magnet to generate email subscribers.
+
+**Business**: [BUSINESS_NAME]
+**Industry**: [INDUSTRY]
+**Target Audience**: [AUDIENCE]
+**Their Problem**: [MAIN_PAIN_POINT]
+
+**Create a Valuable Lead Magnet**:
+
+**Format Options** (choose best):
+- [ ] Checklist
+- [ ] Guide/eBook
+- [ ] Template
+- [ ] Calculator
+- [ ] Cheat Sheet
+
+**Content Should**:
+1. **Solve Specific Problem**: [PROBLEM]
+2. **Provide Quick Win**: [WHAT_THEY_GET]
+3. **Build Trust**: Position us as experts
+4. **Lead to Service**: Connect to [SERVICE]
+
+**Generate**:
+
+1. **Lead Magnet Title** (5 options)
+2. **Complete Content** (if checklist/guide)
+3. **Landing Page Copy**:
+   - Headline
+   - Benefits (5 bullet points)
+   - Form copy
+   - Thank you page copy
+4. **Email Sequence** (3 emails after download)
+5. **Promotion Copy** for:
+   - Website banner
+   - Exit intent popup
+   - Social media post
+
+**Goal**: Convert [X]% of site visitors to email subscribers.
+```
+
+---
+
+## Advanced Prompts
+
+### 19. Content Refresh Strategy
+
+```
+Create a content refresh strategy for existing pages.
+
+**Current Situation**:
+- Total pages: [COUNT]
+- Pages not updated in 6+ months: [COUNT]
+- Pages losing rankings: [LIST_URLS]
+- Pages with low engagement: [LIST_URLS]
+
+**For Each Page Needing Refresh**, provide:
+
+1. **Update Assessment**:
+   - What's outdated?
+   - What's missing?
+   - What can be improved?
+
+2. **Refresh Strategy**:
+   - New sections to add (300-500 words)
+   - Statistics to update
+   - New internal links to add (5-8)
+   - Image updates needed
+   - Schema updates
+
+3. **Priority Ranking**:
+   - High: Pages losing traffic/rankings
+   - Medium: Outdated information
+   - Low: Minor updates
+
+4. **Implementation Plan**:
+   - Week-by-week schedule
+   - Quick wins first
+   - ROI-focused order
+
+**Generate Monthly Refresh Schedule** for next 6 months.
+```
+
+### 20. Voice Search Optimization
+
+```
+Optimize content for voice search and featured snippets.
+
+**Content Topic**: [TOPIC]
+**Current Content**: [PASTE_EXCERPT]
+
+**Optimize For Voice Search**:
+
+1. **Question-Answer Format**:
+   - Identify 5-10 voice search questions
+   - Provide direct answers (25-50 words each)
+   - Use natural language
+
+2. **FAQ Section**:
+   - Add conversational questions
+   - Short, direct answers
+   - FAQPage schema markup
+
+3. **Local Voice Search**:
+   - "Near me" optimization
+   - Local question variants
+   - Location-specific answers
+
+4. **Long-Tail Conversational Keywords**:
+   - How people actually speak
+   - Question format
+   - Natural language
+
+**Output**:
+- Optimized content sections
+- FAQ additions
+- Schema markup
+- Target voice search queries (20)
+```
+
+---
+
+## How to Use These Prompts Effectively
+
+### Best Practices:
+
+1. **Always Fill Variables**: Replace ALL [VARIABLES] with specific information
+2. **Provide Context**: More context = better output
+3. **Iterate**: Use output to refine prompt for better results
+4. **Combine Prompts**: Chain prompts for complex tasks
+5. **Review & Edit**: AI generates structure, YOU add soul
+
+### Prompt Improvement Tips:
+
+**Make Prompts Better By**:
+- Adding specific examples
+- Including your VOMA brand voice
+- Providing competitor context
+- Specifying exact output format
+- Including word counts
+- Adding quality criteria
+
+### Save Your Customized Prompts:
+
+Create your own prompt library by:
+1. Copying these templates
+2. Filling in your recurring variables
+3. Saving as "[YourBusiness]-Prompts.md"
+4. Updating as you refine
+
+---
+
+## Next Steps
+
+1. **Choose prompts** for your current task
+2. **Fill in variables** specific to your business
+3. **Copy to AI tool** (Claude, ChatGPT, etc.)
+4. **Review output** critically
+5. **Refine and iterate**
+6. **Deploy content**
+
+**Remember**: These prompts are starting points. Customize them for your specific needs and industry.
+
+---
+
+*With these 20 master prompts, you can generate 90% of the content and strategy for your 200+ page authority site.*