@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/seo/references/keyword-clustering-methodology.md

@@ -1,175 +0,0 @@
-# Keyword Clustering Methodology
-
-## Overview
-
-Keyword clustering groups related keywords into thematic clusters to build comprehensive content strategies and establish topical authority.
-
-## Clustering Approaches
-
-### 1. Topic Clustering
-- Group keywords by overarching topic/theme
-- Identify semantic relationships
-- Map to content structure
-- Create pillar-cluster hierarchy
-
-### 2. Intent-Based Grouping
-
-**Informational Intent**
-- How-to, guide, tutorial queries
-- "What is", "how to", "guide to"
-- Target: Educational content, blog posts
-- Example: "how to optimize images for web"
-
-**Navigational Intent**
-- Brand/product seeking queries
-- Company names, product names
-- Target: Landing pages, product pages
-- Example: "semrush pricing", "ahrefs login"
-
-**Transactional Intent**
-- Purchase-ready queries
-- "Buy", "discount", "coupon", "deal"
-- Target: Product pages, checkout flows
-- Example: "buy seo tools", "best seo software discount"
-
-**Commercial Intent**
-- Research before purchase
-- "Best", "top", "review", "vs"
-- Target: Comparison pages, reviews
-- Example: "best keyword research tool", "semrush vs ahrefs"
-
-### 3. Parent Topic Identification
-
-```
-Parent Topic: SEO Tools
-├── Keyword Research Tools (sub-topic)
-├── Backlink Analysis Tools (sub-topic)
-├── Rank Tracking Tools (sub-topic)
-└── Technical SEO Tools (sub-topic)
-```
-
-**Process:**
-1. Extract head terms (1-2 word core topics)
-2. Group long-tail variations under head terms
-3. Identify parent-child relationships
-4. Map difficulty and volume at each level
-
-## Cluster Hierarchy Structure
-
-### Three-Tier Model
-
-**Tier 1: Pillar Page (Hub)**
-- Broad topic coverage (2000-4000 words)
-- High search volume head term
-- Links to all cluster pages
-- Example: "Complete Guide to SEO"
-
-**Tier 2: Cluster Pages (Spokes)**
-- Sub-topic deep dives (1500-2500 words)
-- Medium volume keywords
-- Links back to pillar and between clusters
-- Example: "Technical SEO Guide", "On-Page SEO Guide"
-
-**Tier 3: Supporting Content**
-- Specific long-tail topics (800-1500 words)
-- Lower volume, high intent keywords
-- Links to cluster page and pillar
-- Example: "How to Fix Crawl Errors", "Image Optimization Best Practices"
-
-## Clustering Process
-
-### Step 1: Keyword Collection
-- Export keyword list (min 200-500 keywords)
-- Include: keyword, volume, difficulty, intent
-
-### Step 2: Initial Grouping
-- Sort by semantic similarity
-- Use n-gram analysis for common phrases
-- Group synonyms and variations
-
-### Step 3: Intent Mapping
-- Tag each keyword with intent type
-- Separate informational vs commercial
-- Identify content format match
-
-### Step 4: Cluster Assignment
-- Create 5-15 main clusters
-- 10-50 keywords per cluster
-- Name cluster with primary keyword
-
-### Step 5: Hierarchy Building
-- Identify pillar topics (1-3 pillars)
-- Assign clusters to pillars
-- Map supporting content
-
-## Tools & Automation
-
-### Manual Methods
-- Spreadsheet pivot tables
-- Conditional formatting for grouping
-- Manual tagging and categorization
-
-### Semi-Automated
-- Keyword clustering tools (SEMrush, Ahrefs)
-- SERP similarity analysis
-- Google Keyword Planner grouping
-
-### Fully Automated
-- Python clustering scripts (K-means, DBSCAN)
-- NLP-based semantic analysis
-- Machine learning topic modeling
-
-## Example Cluster Structure
-
-```
-Pillar: Email Marketing Guide (vol: 12,000)
-│
-├── Cluster 1: Email List Building (vol: 3,200)
-│   ├── "how to build email list" (vol: 880)
-│   ├── "email lead magnet ideas" (vol: 320)
-│   ├── "email signup form best practices" (vol: 210)
-│   └── "grow email subscribers fast" (vol: 180)
-│
-├── Cluster 2: Email Copywriting (vol: 2,800)
-│   ├── "email subject line formulas" (vol: 590)
-│   ├── "how to write marketing emails" (vol: 480)
-│   ├── "email call to action examples" (vol: 320)
-│   └── "email personalization tips" (vol: 290)
-│
-└── Cluster 3: Email Analytics (vol: 1,900)
-    ├── "email open rate benchmarks" (vol: 720)
-    ├── "improve email deliverability" (vol: 410)
-    ├── "email click through rate" (vol: 380)
-    └── "email conversion tracking" (vol: 190)
-```
-
-## Cluster Quality Metrics
-
-**Cohesion Score**
-- Semantic similarity within cluster
-- Target: >70% keyword overlap in SERP results
-
-**Volume Concentration**
-- Total search volume in cluster
-- Target: 1,000-10,000 monthly searches
-
-**Intent Alignment**
-- % keywords with same intent
-- Target: >80% same intent type
-
-**Content Opportunity**
-- Gap between cluster coverage and competition
-- Score: (Your coverage - Competitor avg) / Competitor max
-
-## Best Practices
-
-1. Start with 200+ seed keywords minimum
-2. Use SERP analysis to validate clusters
-3. Review top 10 results for overlap
-4. Update clusters quarterly
-5. Track cluster rankings over time
-6. Link strategically between cluster content
-7. Monitor cannibalization between cluster pages
-8. Prioritize commercial intent for revenue goals
-9. Build informational content for top-of-funnel
-10. Create conversion paths between clusters

package/.opencode/skills/seo/references/keyword-research-workflow.md

@@ -1,63 +0,0 @@
-# Keyword Research Workflow (ReviewWeb.site API)
-
-## Prerequisites
-Set `REVIEWWEB_API_KEY` in `.env` (copy from `.env.example`)
-
-## Workflow A: Seed Keyword Research
-
-```bash
-# Get keyword ideas + difficulty for a topic
-node scripts/analyze-keywords.cjs -k "your topic" -c us -o report.md
-```
-
-**Output includes:** keyword ideas, search volume, difficulty, CPC, intent, priority
-
-## Workflow B: Competitor Analysis
-
-```bash
-# Analyze competitor's traffic, keywords, backlinks
-node scripts/analyze-keywords.cjs -d "competitor.com" -o competitor.md
-```
-
-**Output includes:** organic traffic, top pages, top keywords, backlink profile
-
-## Workflow C: Batch Analysis
-
-```bash
-# Analyze multiple keywords from JSON file
-echo '["keyword1", "keyword2"]' > keywords.json
-node scripts/analyze-keywords.cjs -f keywords.json --format json -o results.json
-```
-
-## Priority Classification
-
-| Priority | Criteria | Action |
-|----------|----------|--------|
-| 1 (Quick Win) | Vol >500, Diff <40 | Target immediately |
-| 2 (Medium) | Vol >100, Diff <50 | Short-term target |
-| 3 (Long-term) | Diff <70 | Build authority first |
-| 4 (Skip) | Diff >70 | Too competitive |
-
-## Intent → Content Type
-
-| Intent | Signals | Content |
-|--------|---------|---------|
-| Informational | how, what, guide | Blog/Guide |
-| Commercial | best, review, vs | Comparison |
-| Transactional | buy, price | Landing/Product |
-| Navigational | brand terms | Homepage |
-
-## Output Format
-
-Script generates markdown report with:
-- Summary (total keywords, quick wins count)
-- Quick wins table (high priority keywords)
-- Full keyword table (sorted by priority)
-- For domains: traffic overview, top pages, backlinks
-
-## API Endpoints Used
-
-- `/seo-insights/keyword-ideas` - expand seed keywords
-- `/seo-insights/keyword-difficulty` - volume, difficulty, CPC
-- `/seo-insights/traffic` - domain traffic analysis
-- `/seo-insights/backlinks` - backlink profile

package/.opencode/skills/seo/references/keywords.md

@@ -1,131 +0,0 @@
-Conduct keyword research for a topic or niche.
-
-<topic>$ARGUMENTS</topic>
-
-## Workflow
-
-1. **Understand Intent**
-   - Parse topic from `$ARGUMENTS`
-   - Determine search intent (informational/transactional/navigational)
-
-2. **Research Keywords via ReviewWeb API**
-   - **Keyword Ideas**: `POST /seo-insights/keyword-ideas` with topic
-   - **Keyword Difficulty**: `POST /seo-insights/keyword-difficulty` for top keywords
-   - Use `attraction-specialist` agent for expanded discovery
-   - Use `WebSearch` for competitive analysis
-   - Activate `seo` skill for keyword clustering
-
-3. **Analysis**
-   - Primary keywords (high volume, relevant)
-   - Long-tail variations
-   - Question-based keywords
-   - Related topics
-   - Competitor keywords
-   - Difficulty scores from API
-
-4. **Output Strategy**
-   - Keyword clusters by intent
-   - Content recommendations
-   - Priority ranking
-   - Output to `assets/seo/keywords/`
-
-## API Reference
-
-Uses ReviewWeb SEO Insights API:
-- Skill: `seo/references/reviewweb-api.md`
-- Endpoints: `/seo-insights/keyword-ideas`, `/seo-insights/keyword-difficulty`
-- Auth: `$REVIEWWEB_API_KEY` via X-API-Key header
-
-## Agents Used
-- `attraction-specialist` - Keyword discovery
-- `seo-specialist` - Keyword analysis
-
-## Skills Used
-- `seo` - Keyword research frameworks, ReviewWeb API
-- `assets-organizing` - Standardized output paths
-
-## Output Requirements
-
-1. **Minimum 20 keywords** across all clusters
-2. **Difficulty scores** for top 10 primary keywords (via API)
-3. **Intent classification** for each keyword cluster
-4. **Priority ranking** (High/Medium/Low) based on:
-   - Search volume potential
-   - Difficulty score (lower = higher priority)
-   - Relevance to topic
-5. **Content recommendations** per cluster
-
-## Output Template
-
-```markdown
-# Keyword Research: {topic}
-
-**Date**: {YYYY-MM-DD}
-**Topic**: {topic}
-**Search Intent**: {primary intent}
-
-## Executive Summary
-
-{2-3 sentence overview of findings}
-
-## Primary Keywords
-
-| Keyword | Difficulty | Volume Est. | Intent | Priority |
-|---------|------------|-------------|--------|----------|
-| {kw}    | {0-100}    | {High/Med/Low} | {I/T/N} | {H/M/L} |
-
-## Keyword Clusters
-
-### Cluster 1: {Theme}
-**Intent**: {Informational/Transactional/Navigational}
-**Priority**: {High/Medium/Low}
-
-- {keyword 1}
-- {keyword 2}
-- {keyword 3}
-
-**Content Recommendation**: {suggested content type/angle}
-
-### Cluster 2: {Theme}
-...
-
-## Long-tail Keywords
-
-| Long-tail Keyword | Parent Keyword | Intent |
-|-------------------|----------------|--------|
-| {long-tail kw}    | {parent}       | {I/T/N} |
-
-## Question Keywords
-
-- {question keyword 1}
-- {question keyword 2}
-
-## Competitor Keywords
-
-| Competitor | Key Terms | Gap Opportunity |
-|------------|-----------|-----------------|
-| {domain}   | {terms}   | {opportunity}   |
-
-## Recommendations
-
-1. **Quick Wins**: {low difficulty, high relevance keywords}
-2. **Strategic Targets**: {medium difficulty, high value}
-3. **Long-term Goals**: {high difficulty, brand-building}
-
-## Next Steps
-
-- [ ] Create content calendar for top clusters
-- [ ] Prioritize quick-win keywords
-- [ ] Monitor competitor movements
-```
-
-## Output Path
-
-`assets/seo/keywords/{date}-{topic-slug}-keywords.md`
-
-## Examples
-```
-/seo:keywords "AI writing tools"
-/seo:keywords "project management software"
-/seo:keywords "sustainable fashion"
-```

package/.opencode/skills/seo/references/link-building-campaign-framework.md

@@ -1,246 +0,0 @@
-# Link Building Campaign Framework
-
-## Campaign Types
-
-### 1. Guest Post Outreach
-**Best For**: Building authority, brand awareness
-**Target DA**: 40+
-**Success Rate**: 10-15%
-**Timeline**: 2-4 weeks per placement
-
-**Process**:
-1. Identify blogs accepting guest posts
-2. Analyze content quality and audience
-3. Pitch relevant topic ideas
-4. Write high-quality content (1500+ words)
-5. Include contextual link (1-2 per post)
-
-### 2. Resource Page Link Building
-**Best For**: Quick wins, educational content
-**Target DA**: 30+
-**Success Rate**: 15-20%
-**Timeline**: 1-2 weeks
-
-**Process**:
-1. Find resource pages (search: "intitle:resources" + keyword)
-2. Create valuable resource (tool, guide, infographic)
-3. Pitch addition to existing lists
-4. Highlight unique value proposition
-
-### 3. Broken Link Building
-**Best For**: Replacing dead competitor links
-**Target DA**: 35+
-**Success Rate**: 20-30%
-**Timeline**: 2-3 weeks
-
-**Process**:
-1. Find broken links on target sites (Check My Links extension)
-2. Create replacement content
-3. Notify site owner of broken link
-4. Suggest your content as replacement
-
-### 4. HARO (Help A Reporter Out)
-**Best For**: High-authority press links
-**Target DA**: 60+
-**Success Rate**: 5-10%
-**Timeline**: Ongoing daily
-
-**Process**:
-1. Subscribe to HARO emails (3x daily)
-2. Respond to relevant queries within 2 hours
-3. Provide expert quotes with credentials
-4. Follow up if featured
-
-### 5. Digital PR
-**Best For**: Brand mentions, high-DA links
-**Target DA**: 70+
-**Success Rate**: 5-8%
-**Timeline**: 4-8 weeks
-
-**Process**:
-1. Create newsworthy content (data study, survey, report)
-2. Build journalist outreach list
-3. Craft press release
-4. Pitch to relevant journalists
-5. Follow up strategically
-
-### 6. Niche Directory Submissions
-**Best For**: Local SEO, niche authority
-**Target DA**: 25+
-**Success Rate**: 80-90%
-**Timeline**: 1 week
-
-**Process**:
-1. Identify quality directories (not spam farms)
-2. Submit accurate business info
-3. Track submission status
-4. Monitor for approval
-
-## Target Selection Criteria
-
-### Domain Metrics
-- **Minimum DA/DR**: 30 (adjust by campaign type)
-- **Organic Traffic**: 5k+/month
-- **Spam Score**: <30%
-- **Active Content**: Published within 30 days
-
-### Relevance Criteria
-- **Topical Alignment**: Same/adjacent niche
-- **Audience Overlap**: Target demographics match
-- **Content Quality**: Well-written, valuable
-- **Engagement**: Comments, shares, backlinks
-
-### Link Opportunity Signals
-- "Write for us" page exists
-- Resource/links page exists
-- Competitor backlinks present
-- Active blog with guest authors
-- Contact info easily accessible
-
-## Outreach Workflow
-
-### Phase 1: Research (Week 1)
-- Identify 100 target prospects
-- Score by DA, relevance, opportunity
-- Export to outreach spreadsheet
-- Find decision maker contact info
-
-### Phase 2: Initial Outreach (Week 2)
-- Send personalized emails (20-30/day)
-- A/B test subject lines
-- Track open/response rates
-- Log all communications
-
-### Phase 3: Follow-Up (Week 3-4)
-- First follow-up: 3 days after initial
-- Second follow-up: 7 days after first
-- Final follow-up: 14 days after second
-- Mark unresponsive as "dead"
-
-### Phase 4: Execution (Week 5-8)
-- Fulfill content requirements
-- Submit for review
-- Make revisions if needed
-- Confirm publication + link
-
-### Phase 5: Tracking (Ongoing)
-- Monitor link status monthly
-- Track referral traffic
-- Measure ranking impact
-- Build relationship for future opportunities
-
-## Follow-Up Sequences
-
-### Guest Post Sequence
-**Email 1 (Day 0)**: Personalized pitch with topic ideas
-**Email 2 (Day 3)**: "Just checking in" + additional value
-**Email 3 (Day 10)**: Alternative angle/topic offer
-**Email 4 (Day 21)**: Final attempt with social proof
-
-### Resource Link Sequence
-**Email 1 (Day 0)**: Notify of resource + value prop
-**Email 2 (Day 5)**: Brief reminder with quick link
-**Email 3 (Day 14)**: Final gentle nudge
-
-### Broken Link Sequence
-**Email 1 (Day 0)**: Helpful broken link notification
-**Email 2 (Day 4)**: Offer replacement content
-**Email 3 (Day 12)**: Last follow-up
-
-## Success Metrics
-
-### Campaign KPIs
-- **Response Rate**: Target 30%+
-- **Conversion Rate**: Target 10%+ (link secured)
-- **Average DA**: Target 40+
-- **DoFollow Ratio**: Target 70%+
-- **Time to Link**: Target <30 days
-
-### ROI Metrics
-- **Cost per Link**: Track time/money invested
-- **Link Value**: DA × Relevance × Placement score
-- **Ranking Impact**: Target keyword position changes
-- **Referral Traffic**: Clicks from acquired links
-- **Domain Authority Growth**: Monthly DR/DA tracking
-
-### Quality Metrics
-- **Link Retention**: >95% after 6 months
-- **Toxic Score**: <5% of acquired links
-- **Editorial Ratio**: 80%+ editorial (not footer/sidebar)
-- **Anchor Text Diversity**: <10% exact match
-
-## Campaign Planning Template
-
-```markdown
-# Link Building Campaign Plan
-
-## Campaign Details
-- **Type**: [Guest Post / Resource / Broken Link / HARO / Digital PR]
-- **Start Date**: [YYYY-MM-DD]
-- **Duration**: [weeks]
-- **Target Links**: [count]
-- **Budget**: [$amount or hours]
-
-## Target Criteria
-- **Minimum DA**: [score]
-- **Niche**: [specific topics]
-- **Geographic**: [any/specific]
-- **Language**: [any/specific]
-
-## Prospect List
-- **Total Prospects**: [count]
-- **Tier 1 (DA 60+)**: [count]
-- **Tier 2 (DA 40-59)**: [count]
-- **Tier 3 (DA 30-39)**: [count]
-
-## Outreach Strategy
-- **Daily Volume**: [emails/day]
-- **Template**: [reference template name]
-- **Personalization**: [fields to customize]
-- **Follow-up**: [sequence timing]
-
-## Content Requirements
-- **Topics**: [list 3-5 topic ideas]
-- **Word Count**: [target]
-- **Assets**: [images, data, infographics needed]
-
-## Success Targets
-- **Response Rate**: [%]
-- **Conversion Rate**: [%]
-- **Average DA**: [score]
-- **Total Links**: [count]
-
-## Weekly Tracking
-| Week | Sent | Opened | Replied | Links Secured | Avg DA |
-|------|------|--------|---------|---------------|--------|
-| 1    |      |        |         |               |        |
-| 2    |      |        |         |               |        |
-| 3    |      |        |         |               |        |
-| 4    |      |        |         |               |        |
-
-## Notes
-[Campaign-specific notes, learnings, optimizations]
-```
-
-## Campaign Optimization
-
-### A/B Testing Elements
-- Subject lines (test 2-3 variants)
-- Email length (short vs detailed)
-- Call-to-action wording
-- Personalization depth
-- Send day/time
-
-### Performance Analysis
-- Track response rates by template
-- Identify high-converting topics
-- Monitor DA correlation with success
-- Analyze follow-up effectiveness
-- Measure seasonal trends
-
-### Continuous Improvement
-- Update templates based on data
-- Refine targeting criteria
-- Adjust outreach volume
-- Optimize follow-up timing
-- Build relationship database