@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/seo/SKILL.md

@@ -1,95 +0,0 @@
----
-name: ckm:seo
-description: SEO audits, keyword research (ReviewWeb.site API), on-page optimization, technical SEO, programmatic SEO (pSEO), JSON+LD schema, Google Search Console API, Core Web Vitals. Used by seo-specialist, attraction-specialist agents.
-argument-hint: "[audit|keywords|pseo|optimize|schema] [target]"
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-# SEO
-
-Technical SEO, keyword research (ReviewWeb.site API), Google Search Console API, and programmatic SEO.
-
-<args>$ARGUMENTS</args>
-
-## When to Use
-
-- Keyword research with real data (volume, difficulty, CPC)
-- Competitor domain analysis (traffic, top keywords, backlinks)
-- Google Search Console data (queries, clicks, impressions, CTR, position)
-- SEO audit or technical analysis
-- JSON+LD schema generation
-- Programmatic SEO (pSEO) templates
-- Core Web Vitals measurement
-
-## Quick Start: Google Search Console
-
-```bash
-node scripts/gsc-auth.cjs --auth                     # Authenticate (one-time)
-node scripts/gsc-query.cjs --sites                    # List sites
-node scripts/gsc-query.cjs --top-queries -s URL       # Top queries
-node scripts/gsc-query.cjs --low-ctr -s URL -o low-ctr.csv -f csv
-```
-
-Config: `google_client_secret.json` in `.opencode/secrets/` or `~/.opencode/secrets/`
-
-## Subcommands
-
-| Subcommand | Description | Reference |
-|------------|-------------|-----------|
-| `audit` | Technical SEO audit | `references/audit.md` |
-| `keywords` | Keyword research & planning | `references/keywords.md` |
-| `pseo` | Programmatic SEO template generation | `references/pseo.md` |
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `scripts/gsc-auth.cjs` | OAuth2 authentication flow |
-| `scripts/gsc-query.cjs` | Query analytics, sitemaps, URL inspection |
-| `scripts/gsc-config-loader.cjs` | Cross-platform config/token resolution |
-| `scripts/analyze-keywords.cjs` | Keyword research via ReviewWeb.site API |
-| `scripts/audit-core-web-vitals.cjs` | Core Web Vitals measurement |
-| `scripts/generate-sitemap.cjs` | XML sitemap generation |
-| `scripts/generate-schema.cjs` | JSON+LD schema generator |
-| `scripts/validate-schema.cjs` | Validate JSON-LD |
-| `scripts/pseo-generator.cjs` | pSEO page generation |
-
-## References
-
-**Search Console:** `references/google-search-console-api-guide.md`, `references/search-console-query-patterns.md`
-
-**API:** `references/reviewweb-api.md`, `references/reviewweb-content-api.md`
-
-**Audit:** `references/seo-audit-workflow.md`, `references/browser-seo-audit-workflow.md`
-
-**Keyword Research:** `references/keyword-research-workflow.md`, `references/keyword-clustering-methodology.md`, `references/content-gap-analysis-framework.md`
-
-**Technical SEO:** `references/technical-seo-checklist.md`, `references/core-web-vitals-remediation.md`, `references/sitemap-best-practices.md`, `references/robots-txt-best-practices-2025.md`, `references/canonical-url-strategy.md`, `references/mobile-seo-checklist.md`
-
-**On-Page SEO:** `references/on-page-seo-checklist-2025.md`, `references/meta-tag-templates.md`, `references/semantic-seo-framework.md`, `references/readability-scoring-guide.md`, `references/internal-linking-automation.md`
-
-**Programmatic SEO:** `references/pseo-templates.md`, `references/pseo-best-practices.md`, `references/pseo-template-syntax.md`, `references/pseo-url-structure-guide.md`, `references/pseo-scale-architecture.md`
-
-**Link Building:** `references/backlink-analysis-framework.md`, `references/link-building-campaign-framework.md`, `references/outreach-email-templates.md`, `references/directory-submission-list.md`
-
-**Schema:** `references/schema-generation.md`, `references/schema-templates/`
-
-## Agents Used
-
-- `seo-specialist` — SEO audit and optimization
-- `attraction-specialist` — Keyword research
-
-## Output
-
-- Audit reports → `assets/reports/seo/{date}-{domain}-audit.md`
-- Keyword reports → `assets/reports/seo/{date}-{topic}-keywords.md`
-- CWV reports → `assets/reports/seo/{date}-{domain}-cwv.md`
-- Schema files → `assets/seo/schemas/{page}-schema.json`
-
-## Routing
-
-1. Parse subcommand from `$ARGUMENTS` (first word)
-2. Load corresponding `references/{subcommand}.md`
-3. Execute with remaining arguments

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

@@ -1,121 +0,0 @@
-Perform a comprehensive technical SEO audit.
-
-<url>$ARGUMENTS</url>
-
-Activate `seo` skill.
-
-## Workflow
-
-1. **Fetch Page Data**
-   - Use `WebFetch` tool to retrieve page content
-   - If local file, use `Read` tool
-
-2. **ReviewWeb API Analysis** (if `$REVIEWWEB_API_KEY` available)
-   - Reference: `.opencode/skills/seo/references/reviewweb-api.md`
-   - **Backlink Analysis**: `POST /seo-insights/backlinks` with domain
-   - **Traffic Insights**: `POST /seo-insights/traffic` for traffic history, top pages, keywords
-   - **Page Review**: `POST /review` then `GET /review/{reviewId}` for detailed analysis
-   - **Visual Audit**: `POST /screenshot` for desktop/mobile rendering check
-
-3. **Technical Analysis**
-   - Use `seo-specialist` agent for audit
-   - Activate `seo` skill
-   - Check all SEO elements:
-     - Title tag (length, keywords)
-     - Meta description
-     - Heading structure (H1-H6)
-     - URL structure
-     - Internal/external links
-     - Image alt tags
-     - Schema markup
-     - Mobile responsiveness
-     - Page speed indicators
-
-4. **Generate Report**
-   - Merge WebFetch + ReviewWeb API findings
-   - Score each element
-   - Prioritize issues (critical/high/medium/low)
-   - Provide specific recommendations
-   - Output to `reports/seo/`
-
-## Agents Used
-- `seo-specialist` - Technical SEO expertise
-
-## Skills Used
-- `seo` - Audit frameworks + ReviewWeb API reference
-- `assets-organizing` - Standardized output paths
-
-## API Reference
-- ReviewWeb API: `.opencode/skills/seo/references/reviewweb-api.md`
-- Required env: `$REVIEWWEB_API_KEY` (optional but recommended)
-
-## Output
-- Path: `assets/seo/audits/{date}-{domain}-audit.md`
-
-### Output Requirements
-- Overall score (0-100) with letter grade
-- Executive summary (2-3 sentences)
-- Each element scored with status emoji: ✅ Pass | ⚠️ Warning | ❌ Fail
-- Issues grouped by priority (Critical → High → Medium → Low)
-- Actionable recommendations with effort estimates (Quick Win / Medium / Major)
-- Include ReviewWeb API data if available (backlinks, traffic, keywords)
-
-### Output Template
-```markdown
-# SEO Audit: {domain}
-**Date:** {date} | **Score:** {score}/100 ({grade})
-
-## Executive Summary
-{2-3 sentence overview of site health and top priorities}
-
-## Quick Stats
-| Metric | Value | Status |
-|--------|-------|--------|
-| Backlinks | {count} | {emoji} |
-| Monthly Traffic | {estimate} | {emoji} |
-| Top Keywords | {count} ranking | {emoji} |
-
-## Technical SEO Checklist
-| Element | Status | Details |
-|---------|--------|---------|
-| Title Tag | {emoji} | {length}/60 chars, {keyword status} |
-| Meta Description | {emoji} | {length}/160 chars |
-| H1 Tag | {emoji} | {count} found |
-| Heading Hierarchy | {emoji} | {structure} |
-| URL Structure | {emoji} | {notes} |
-| Image Alt Tags | {emoji} | {x}/{total} optimized |
-| Schema Markup | {emoji} | {types found or missing} |
-| Mobile Friendly | {emoji} | {notes} |
-| Page Speed | {emoji} | {indicators} |
-| Internal Links | {emoji} | {count} |
-| External Links | {emoji} | {count} |
-
-## Issues by Priority
-
-### 🔴 Critical
-{list or "None found"}
-
-### 🟠 High
-{list or "None found"}
-
-### 🟡 Medium
-{list or "None found"}
-
-### 🟢 Low
-{list or "None found"}
-
-## Recommendations
-| # | Action | Priority | Effort | Impact |
-|---|--------|----------|--------|--------|
-| 1 | {recommendation} | {priority} | {effort} | {impact} |
-
-## Data Sources
-- WebFetch analysis: {yes/no}
-- ReviewWeb API: {yes/no, endpoints used}
-```
-
-## Examples
-```
-/seo/audit https://example.com
-/seo/audit https://example.com/pricing
-```

package/.opencode/skills/seo/references/backlink-analysis-framework.md

@@ -1,192 +0,0 @@
-# Backlink Analysis Framework
-
-## Key Metrics
-
-### Domain Authority Metrics
-- **Domain Authority (DA)**: 0-100 scale (Moz)
-- **Domain Rating (DR)**: 0-100 scale (Ahrefs)
-- **Trust Flow/Citation Flow**: Majestic metrics
-- **Target**: DA/DR 40+ for quality backlinks
-
-### Referring Domain Metrics
-- **Total Referring Domains**: Unique domains linking to site
-- **New/Lost Domains**: Monthly tracking
-- **DoFollow Ratio**: Target 60-80% dofollow
-- **Link Velocity**: Natural growth rate (avoid spikes)
-
-### Anchor Text Distribution
-- **Branded**: 40-50% (company/brand name)
-- **Naked URL**: 20-30% (raw domain)
-- **Generic**: 15-20% (click here, read more)
-- **Exact Match**: 5-10% (target keywords)
-- **Partial Match**: 10-15% (keyword variations)
-
-### Quality Indicators
-- **Toxic Score**: <5% toxic links (Semrush/Ahrefs)
-- **Relevance Score**: Topical alignment
-- **Traffic**: Linking domain monthly visitors
-- **Spam Score**: <30% (Moz)
-
-## Competitor Gap Analysis
-
-### Process
-1. Export competitor backlink profiles (top 3-5 competitors)
-2. Identify domains linking to 2+ competitors but not you
-3. Filter by DA/DR threshold (30+)
-4. Sort by number of competitor links (high opportunity)
-5. Export target list for outreach
-
-### Gap Analysis Template
-```
-Competitor Gap Analysis
-Date: [YYYY-MM-DD]
-Competitors: [list URLs]
-
-| Domain | DA | Links to C1 | Links to C2 | Links to C3 | Traffic | Niche |
-|--------|----|-----------|-----------|-----------| --------|-------|
-| example.com | 65 | Yes | Yes | No | 50k | Tech |
-
-Priority Targets:
-- High DA + links to multiple competitors
-- Relevant niche/topic
-- Active content publication
-```
-
-## Quality Assessment Criteria
-
-### High-Quality Link Signals
-- DA/DR 40+
-- Organic traffic 10k+/month
-- Topically relevant content
-- Editorial placement (not footer/sidebar)
-- Contextual anchor text
-- DoFollow attribute
-- Natural link placement
-
-### Low-Quality/Toxic Signals
-- DA/DR <20
-- No organic traffic
-- Spammy content/ads
-- Link farm patterns
-- Irrelevant niche
-- Exact match anchor spam
-- Site-wide links
-- PBN indicators
-
-### Assessment Scoring
-**Score 1-5 for each:**
-- Domain authority (DA/DR)
-- Traffic quality
-- Content relevance
-- Link placement
-- Editorial value
-
-**Total Score:**
-- 20-25: Premium link
-- 15-19: Quality link
-- 10-14: Average link
-- 5-9: Low quality
-- 0-4: Consider disavow
-
-## Disavow Decision Process
-
-### When to Disavow
-- Spam score >50%
-- Known PBN/link farm
-- Hacked site with malicious links
-- Irrelevant foreign language spam
-- Sitewide links from low-quality directories
-- Manual penalty received
-
-### Disavow File Format
-```
-# Toxic domain - spam score 85%
-domain:spamsite.com
-
-# Low quality directory
-domain:freelinkdirectory.net
-
-# Specific URL only
-http://example.com/spam-page
-```
-
-### Disavow Workflow
-1. Export all backlinks
-2. Filter by toxic score >30%
-3. Manual review of flagged links
-4. Create disavow.txt file
-5. Upload to Google Search Console
-6. Monitor ranking changes (4-8 weeks)
-7. Update quarterly
-
-## Backlink Audit Template
-
-```markdown
-# Backlink Audit Report
-**Date**: [YYYY-MM-DD]
-**Domain**: [your-domain.com]
-
-## Overview
-- Total Backlinks: [count]
-- Referring Domains: [count]
-- DoFollow Links: [count] ([%])
-- Average DA: [score]
-- Toxic Links: [count] ([%])
-
-## Top Referring Domains
-| Domain | DA | Links | Type | Traffic |
-|--------|----| ------|------|---------|
-| [domain] | [DA] | [count] | [dofollow/nofollow] | [estimate] |
-
-## Anchor Text Distribution
-- Branded: [%]
-- Naked URL: [%]
-- Generic: [%]
-- Exact Match: [%]
-- Partial Match: [%]
-
-## Link Velocity (Last 90 Days)
-- New Links: [count]
-- Lost Links: [count]
-- Net Growth: [+/- count]
-
-## Quality Issues
-- Toxic Links: [count]
-- Low DA (<20): [count]
-- Irrelevant Niches: [count]
-
-## Recommendations
-1. [Action item]
-2. [Action item]
-3. [Action item]
-
-## Disavow Actions
-- Links to disavow: [count]
-- Domains to disavow: [count]
-- File uploaded: [Yes/No]
-```
-
-## Tools Integration
-
-### Ahrefs Metrics
-- Use Site Explorer for backlink profile
-- Content Gap for competitor analysis
-- Batch Analysis for bulk domain checks
-
-### Semrush Metrics
-- Backlink Analytics for toxic score
-- Link Building Tool for prospects
-- Bulk Analysis for domain metrics
-
-### Google Search Console
-- Links report for Google's view
-- Most linked pages
-- Top linking sites
-- Top linking text
-
-## Analysis Frequency
-
-- **Weekly**: Monitor new/lost links
-- **Monthly**: Full backlink audit
-- **Quarterly**: Competitor gap analysis
-- **Semi-annual**: Disavow file update

package/.opencode/skills/seo/references/browser-seo-audit-workflow.md

@@ -1,180 +0,0 @@
-# Browser-Based SEO Audit Workflow
-
-Real browser testing using `chrome-devtools` skill for accurate SEO analysis.
-
-## Why Browser-Based Testing
-
-- **Real CWV metrics** - Actual rendering, not simulated
-- **Mobile-first indexing** - True mobile rendering
-- **JavaScript SEO** - SPA/CSR content auditing
-- **Visual verification** - Screenshots for layout issues
-
-## Prerequisites
-
-```bash
-cd .opencode/skills/chrome-devtools/scripts && npm install
-```
-
-## Core Web Vitals Audit
-
-### Single URL
-
-```bash
-# Measure vitals
-node performance.js --url https://example.com | jq '.vitals'
-
-# With trace for debugging
-node performance.js --url https://example.com --trace trace.json
-```
-
-### Multi-Device Testing
-
-```bash
-# Desktop (default)
-node navigate.js --url https://example.com
-node performance.js --url https://example.com
-
-# Mobile viewport
-node evaluate.js --script "page.setViewport({width: 375, height: 812, isMobile: true})"
-node performance.js --url https://example.com
-```
-
-## Network Analysis for SEO
-
-### Detect Redirect Chains
-
-```bash
-node network.js --url https://example.com | jq '
-  .requests[] | select(.response.status >= 300 and .response.status < 400)
-  | {url, status: .response.status, location: .response.headers.location}
-'
-```
-
-### Find Broken Resources (404s)
-
-```bash
-node network.js --url https://example.com | jq '
-  .requests[] | select(.response.status == 404)
-  | {url, referrer: .request.headers.referer}
-'
-```
-
-### Identify Slow Resources
-
-```bash
-node network.js --url https://example.com | jq '
-  .requests[] | select(.timing.total > 1000)
-  | {url, duration: .timing.total, size: .response.size}
-'
-```
-
-## Visual SEO Checks
-
-### Full Page Screenshot
-
-```bash
-node screenshot.js --url https://example.com --full-page true \
-  --output .opencode/chrome-devtools/screenshots/seo-audit.png
-```
-
-### Above-the-Fold Content
-
-```bash
-node screenshot.js --url https://example.com \
-  --output .opencode/chrome-devtools/screenshots/atf.png
-```
-
-### Mobile Rendering
-
-```bash
-node evaluate.js --script "page.setViewport({width: 375, height: 812, isMobile: true})"
-node screenshot.js --output .opencode/chrome-devtools/screenshots/mobile.png
-```
-
-## JavaScript SEO Checks
-
-### Verify Rendered Content
-
-```bash
-# Get rendered HTML (after JS execution)
-node evaluate.js --url https://example.com --script "document.documentElement.outerHTML" \
-  | jq -r '.result' > rendered.html
-
-# Compare with source HTML
-curl -s https://example.com > source.html
-diff source.html rendered.html
-```
-
-### Check Meta Tags Post-Render
-
-```bash
-node evaluate.js --url https://example.com --script "
-  JSON.stringify({
-    title: document.title,
-    description: document.querySelector('meta[name=description]')?.content,
-    canonical: document.querySelector('link[rel=canonical]')?.href,
-    robots: document.querySelector('meta[name=robots]')?.content
-  })
-" | jq '.result | fromjson'
-```
-
-### Verify Structured Data
-
-```bash
-node evaluate.js --url https://example.com --script "
-  Array.from(document.querySelectorAll('script[type=\"application/ld+json\"]'))
-    .map(s => JSON.parse(s.textContent))
-" | jq '.result'
-```
-
-## Session Workflow: Multi-Page Audit
-
-```bash
-# Start session
-node navigate.js --url https://example.com
-
-# Audit homepage
-node performance.js | jq '.vitals' > vitals-home.json
-node screenshot.js --output screenshots/home.png
-
-# Navigate to key pages
-node navigate.js --url https://example.com/about
-node performance.js | jq '.vitals' > vitals-about.json
-
-node navigate.js --url https://example.com/contact
-node performance.js | jq '.vitals' > vitals-contact.json
-
-# Close session
-node navigate.js --url about:blank --close true
-```
-
-## Quick Audit Script
-
-```bash
-#!/bin/bash
-URL=$1
-SESSION=$(date +%Y%m%d-%H%M%S)
-OUT=".opencode/chrome-devtools/seo-audits/$SESSION"
-mkdir -p "$OUT"
-
-cd .opencode/skills/chrome-devtools/scripts
-
-# Performance
-node performance.js --url "$URL" > "$OUT/vitals.json"
-
-# Network
-node network.js --url "$URL" > "$OUT/network.json"
-
-# Screenshots
-node screenshot.js --url "$URL" --output "$OUT/desktop.png"
-node evaluate.js --script "page.setViewport({width: 375, height: 812, isMobile: true})"
-node screenshot.js --output "$OUT/mobile.png"
-
-# Console errors
-node console.js --url "$URL" --types error --duration 5000 > "$OUT/errors.json"
-
-# Close
-node navigate.js --url about:blank --close true
-
-echo "Audit saved: $OUT"
-```