@hienlh/ppm 0.9.81 → 0.9.83

package/.opencode/skills/seo/references/on-page-seo-checklist-2025.md

@@ -1,328 +0,0 @@
-# On-Page SEO Checklist 2025
-
-## Title & Meta Elements (6 items)
-
-### [ ] Title Tag Optimization
-- Length: 50-60 characters (< 580 pixels)
-- Primary keyword in first 50 characters
-- Brand name at end (if space permits)
-- Unique title per page
-- **Pass:** Contains primary keyword, under 60 chars
-- **Fail:** Generic, duplicate, missing keyword, >60 chars
-
-### [ ] Meta Description
-- Length: 150-160 characters (< 920 pixels)
-- Includes primary keyword and CTA
-- Compelling, action-oriented copy
-- Unique per page
-- **Pass:** 150-160 chars, keyword present, CTA included
-- **Fail:** Missing, duplicate, >160 chars, no CTA
-
-### [ ] H1 Header Tag
-- One H1 per page
-- Contains primary keyword
-- Different from title tag
-- Under 70 characters
-- **Pass:** Single H1, keyword included, unique
-- **Fail:** Multiple H1s, no keyword, identical to title
-
-### [ ] URL Slug Structure
-- Lowercase, hyphen-separated
-- Contains primary keyword
-- Under 75 characters
-- No stop words (if, and, the, etc.)
-- **Pass:** Clean, keyword-rich, short
-- **Fail:** Long, parameter-heavy, no keywords
-
-### [ ] Canonical Tag
-- Self-referencing canonical on original content
-- Points to preferred version if duplicates exist
-- HTTPS version specified
-- **Pass:** Correct canonical URL set
-- **Fail:** Missing, incorrect, or conflicting canonical
-
-### [ ] Meta Robots Tag
-- Index,follow for public pages
-- Noindex for thin/duplicate content
-- Nofollow for untrusted links (if applicable)
-- **Pass:** Appropriate directive set
-- **Fail:** Unintentional noindex on important pages
-
-## Content Optimization (11 items)
-
-### [ ] Primary Keyword Placement
-- In first 100 words
-- In H1, H2 tags
-- In title and meta description
-- Natural density (0.5-2%)
-- **Pass:** Keyword appears in all key locations naturally
-- **Fail:** Keyword stuffing or completely absent
-
-### [ ] Keyword Variations & LSI
-- 5-10 semantic keyword variations
-- Related entity mentions
-- Synonym usage
-- **Pass:** Natural semantic coverage
-- **Fail:** Exact match repetition only
-
-### [ ] Content Length
-- Blog posts: 1,500-2,500 words
-- Pillar pages: 2,500-4,000 words
-- Product pages: 500-1,000 words
-- **Pass:** Meets minimum for content type
-- **Fail:** Thin content (<300 words)
-
-### [ ] Heading Hierarchy (H2-H6)
-- Logical structure (H2 → H3 → H4)
-- Keywords in subheadings
-- Min 4-6 H2 tags per long-form content
-- **Pass:** Proper hierarchy, keyword-rich
-- **Fail:** Skipped levels, generic headings
-
-### [ ] Content Freshness
-- Publication date visible
-- Last updated date shown
-- Regular content updates (quarterly for evergreen)
-- **Pass:** Current year references, updated data
-- **Fail:** Outdated stats, broken references
-
-### [ ] E-E-A-T Signals
-- Author bio with credentials
-- Citations and references
-- Expert quotes or contributions
-- Original research or data
-- **Pass:** Clear expertise demonstrated
-- **Fail:** No author info, uncited claims
-
-### [ ] Content Uniqueness
-- 100% original content (no scraping)
-- Unique perspective or value-add
-- Not duplicated across site
-- **Pass:** Passes plagiarism check, unique insights
-- **Fail:** Duplicate, thin, or scraped content
-
-### [ ] Paragraph Structure
-- Max 3-4 sentences per paragraph
-- White space between sections
-- Scannable format
-- **Pass:** Easy to scan, broken into chunks
-- **Fail:** Large text blocks, no breaks
-
-### [ ] Sentence Readability
-- Vary sentence length (8-25 words)
-- Active voice (>80% of sentences)
-- Simple vocabulary (avoid jargon)
-- **Pass:** Flesch Reading Ease 60-70+
-- **Fail:** Complex sentences, passive voice heavy
-
-### [ ] Bullet Points & Lists
-- Use for 3+ related items
-- Numbered lists for sequential steps
-- Bulleted lists for non-sequential
-- **Pass:** Lists used appropriately
-- **Fail:** Large paragraphs that should be lists
-
-### [ ] Call-to-Action (CTA)
-- Clear CTA above fold and at end
-- Relevant to content topic
-- Action-oriented language
-- **Pass:** Visible CTA with clear next step
-- **Fail:** No CTA or buried CTA
-
-## Technical Elements (10 items)
-
-### [ ] Page Load Speed
-- Core Web Vitals passing
-- LCP <2.5s, FID <100ms, CLS <0.1
-- Mobile speed score >85
-- **Pass:** All Core Web Vitals green
-- **Fail:** Any metric in red zone
-
-### [ ] Mobile Responsiveness
-- Mobile-friendly test passed
-- Readable font sizes (16px min)
-- Touch-friendly buttons (48px min)
-- **Pass:** Google Mobile-Friendly Test passes
-- **Fail:** Horizontal scroll, tiny text
-
-### [ ] HTTPS Security
-- SSL certificate active
-- All resources loaded via HTTPS
-- No mixed content warnings
-- **Pass:** Green padlock, HTTPS everywhere
-- **Fail:** "Not secure" warning
-
-### [ ] Structured Data (Schema)
-- Appropriate schema type implemented
-- Article, Product, FAQ, HowTo, etc.
-- Valid JSON-LD format
-- **Pass:** Rich results test passes
-- **Fail:** Errors in schema validator
-
-### [ ] Open Graph Tags
-- og:title, og:description, og:image
-- og:type appropriate for content
-- Twitter card tags
-- **Pass:** All required OG tags present
-- **Fail:** Missing social meta tags
-
-### [ ] Image Optimization
-- File size <200KB per image
-- WebP or next-gen format
-- Compressed without quality loss
-- **Pass:** Images load fast, modern format
-- **Fail:** Oversized files, slow loading
-
-### [ ] Lazy Loading
-- Images lazy load below fold
-- Iframe lazy loading
-- Native loading="lazy" attribute
-- **Pass:** Below-fold images deferred
-- **Fail:** All images load on page load
-
-### [ ] Breadcrumb Navigation
-- Breadcrumbs on all non-home pages
-- Schema markup for breadcrumbs
-- Clickable links in path
-- **Pass:** Breadcrumbs visible with schema
-- **Fail:** No breadcrumbs on deep pages
-
-### [ ] 404 Error Handling
-- Custom 404 page with helpful links
-- Search functionality on 404
-- Link to homepage/popular pages
-- **Pass:** Useful 404 with navigation
-- **Fail:** Default server 404 page
-
-### [ ] XML Sitemap Inclusion
-- Page included in XML sitemap
-- Priority and changefreq set
-- Submitted to Search Console
-- **Pass:** URL in sitemap, indexed
-- **Fail:** Missing from sitemap
-
-## Internal & External Links (6 items)
-
-### [ ] Internal Link Count
-- Min 3-5 internal links per page
-- Links to related content
-- Varied anchor text
-- **Pass:** 3+ contextual internal links
-- **Fail:** No internal links or orphan page
-
-### [ ] Internal Anchor Text
-- Descriptive, keyword-relevant
-- Avoid "click here" or "read more"
-- Natural in context
-- **Pass:** Descriptive anchor text used
-- **Fail:** Generic anchor text
-
-### [ ] External Link Quality
-- 1-3 external links to authoritative sources
-- Links to .edu, .gov, industry leaders
-- Relevant to topic
-- **Pass:** Quality outbound links present
-- **Fail:** No external links or spammy links
-
-### [ ] Link Destination Validity
-- All links return 200 status
-- No broken links (404s)
-- No redirect chains (>2 hops)
-- **Pass:** All links functional
-- **Fail:** Broken or redirected links
-
-### [ ] Nofollow Attributes
-- Affiliate links have rel="nofollow" or "sponsored"
-- UGC links have rel="ugc"
-- Paid links have rel="sponsored"
-- **Pass:** Proper rel attributes on paid/UGC links
-- **Fail:** Missing nofollow on affiliate links
-
-### [ ] Link Depth
-- Page accessible within 3 clicks from homepage
-- Shallow site architecture
-- **Pass:** ≤3 clicks from home
-- **Fail:** >3 clicks, buried deep
-
-## Media Optimization (7 items)
-
-### [ ] Image Alt Text
-- All images have descriptive alt text
-- Primary keyword in main image alt (natural)
-- Describes image content accurately
-- **Pass:** All images have relevant alt text
-- **Fail:** Missing alt or keyword stuffing
-
-### [ ] Image File Names
-- Descriptive file names (not IMG_1234.jpg)
-- Lowercase, hyphen-separated
-- Keyword-relevant
-- **Pass:** "keyword-topic-image.jpg"
-- **Fail:** "IMG_1234.jpg"
-
-### [ ] Image Dimensions
-- Proper width/height attributes set
-- Prevents layout shift (CLS)
-- Sized appropriately for display
-- **Pass:** Dimensions match display size
-- **Fail:** Oversized images scaled with CSS
-
-### [ ] Video Optimization
-- Video transcripts provided
-- Video schema markup
-- Thumbnail image optimized
-- **Pass:** Transcript + schema present
-- **Fail:** No transcript, missing schema
-
-### [ ] Infographic Text Alternative
-- Key data in HTML text (not just image)
-- Screen reader accessible
-- Text version of insights
-- **Pass:** Information accessible in text
-- **Fail:** Info only in image format
-
-### [ ] PDF/Download Optimization
-- Descriptive link text for downloads
-- File size indicated
-- Preview or description provided
-- **Pass:** Clear link + file info
-- **Fail:** Generic "Download PDF" link
-
-### [ ] Favicon
-- Favicon.ico in root directory
-- Multiple sizes for different devices
-- Brand-consistent icon
-- **Pass:** Favicon displays in browser tabs
-- **Fail:** Default browser icon or missing
-
-## Additional Elements (3 items)
-
-### [ ] Language Declaration
-- Lang attribute in HTML tag
-- Correct language code (en-US, es-MX)
-- **Pass:** `<html lang="en">`
-- **Fail:** Missing lang attribute
-
-### [ ] Table of Contents
-- TOC for content >2,000 words
-- Jump links to sections
-- Improves UX and featured snippets
-- **Pass:** Interactive TOC present
-- **Fail:** Long content without TOC
-
-### [ ] FAQ Section
-- FAQ schema markup
-- Answers common user questions
-- Natural language questions
-- **Pass:** FAQ with schema implemented
-- **Fail:** No FAQ or missing schema
-
----
-
-**Total Items: 43**
-
-**Scoring:**
-- 90-100% (39-43): Excellent optimization
-- 80-89% (35-38): Good, minor improvements needed
-- 70-79% (30-34): Adequate, several issues to address
-- <70% (<30): Poor, major optimization required

package/.opencode/skills/seo/references/outreach-email-templates.md

@@ -1,335 +0,0 @@
-# Outreach Email Templates
-
-## Template 1: Guest Post Pitch
-
-### Subject Lines (A/B Test)
-- "Guest post idea for [Blog Name]"
-- "3 content ideas for [Blog Name] readers"
-- "Quick question about guest posting"
-- "[Mutual Connection] suggested I reach out"
-
-### Email Body
-```
-Hi [Name],
-
-I've been following [Blog Name] for a while, particularly enjoyed your recent post on [specific article]. The insights on [specific detail] really resonated.
-
-I write about [niche/topic] and thought your audience might benefit from content on [topic area]. A few ideas:
-
-1. [Specific headline idea with hook]
-2. [Specific headline idea with hook]
-3. [Specific headline idea with hook]
-
-I've written for [Publication 1], [Publication 2], and [Publication 3]. You can see my work here: [portfolio link]
-
-Would any of these topics interest your readers? Happy to adjust to fit your editorial calendar.
-
-Best,
-[Your Name]
-[Title]
-[Website]
-```
-
-### Personalization Checklist
-- [ ] Use recipient's actual name
-- [ ] Reference specific article from their blog
-- [ ] Mention specific detail from that article
-- [ ] Tailor topic ideas to their audience
-- [ ] Include relevant credentials
-- [ ] Keep under 150 words
-
-## Template 2: Resource Page Suggestion
-
-### Subject Lines
-- "Resource suggestion for [Page Title]"
-- "Addition to your [Topic] resources?"
-- "Found helpful resource for [Page Name]"
-
-### Email Body
-```
-Hi [Name],
-
-I came across your [Topic] resources page while researching [related topic]:
-[URL of their resource page]
-
-I recently created [describe your resource] that covers [specific value]:
-[Your resource URL]
-
-It includes [unique feature 1], [unique feature 2], and [unique feature 3] that aren't covered in your current list.
-
-Would this be worth adding to your resources? Happy to provide more details if helpful.
-
-Thanks for maintaining such a useful resource list!
-
-[Your Name]
-```
-
-### Best Practices
-- Keep extremely brief (under 100 words)
-- Link directly to their resource page
-- Highlight unique value clearly
-- No hard sell, just helpful suggestion
-- Single focused resource only
-
-## Template 3: Broken Link Replacement
-
-### Subject Lines
-- "Broken link on [Page Title]"
-- "Quick heads up about [Site Name]"
-- "Found 404 error on your site"
-
-### Email Body
-```
-Hi [Name],
-
-I was reading your article "[Article Title]" and noticed a broken link in the [section] section:
-
-Broken URL: [dead link]
-Error: 404 / Domain expired / etc.
-
-I actually have a similar resource that covers [same topic]:
-[Your URL]
-
-It includes [relevant detail that matches broken content].
-
-Thought you might want to update the link or at least know about the 404.
-
-Either way, great article!
-
-[Your Name]
-```
-
-### Follow-Up (5 days later)
-```
-Hi [Name],
-
-Just following up on the broken link I mentioned. Were you able to update it?
-
-If the replacement I suggested doesn't fit, I'm happy to help find alternatives.
-
-Thanks!
-[Your Name]
-```
-
-### Execution Tips
-- Lead with helpfulness (not your link)
-- Clearly identify broken link location
-- Explain why your content is relevant replacement
-- Offer to help regardless of outcome
-- Screenshot broken link as proof (optional attachment)
-
-## Template 4: Testimonial/Case Study Request
-
-### Subject Lines
-- "Case study opportunity with [Your Company]"
-- "Would you share your [Product] results?"
-- "Quick testimonial request"
-
-### Email Body
-```
-Hi [Name],
-
-I noticed you're using [Your Product/Service] for [specific use case].
-
-We're putting together case studies showing how [industry/role] professionals achieve [specific outcome].
-
-Would you be interested in being featured? Benefits include:
-
-- Backlink to your site
-- Social media promotion to [X] followers
-- Position as industry thought leader
-- Free [incentive if applicable]
-
-The process is simple:
-1. 15-min interview or written questions
-2. We write the case study
-3. You review and approve
-4. We publish and promote
-
-Interested? I can send questions this week.
-
-Thanks,
-[Your Name]
-```
-
-### Alternative: Simple Testimonial Request
-```
-Hi [Name],
-
-Thanks for being a [Product] customer! We noticed you've been using [specific feature] for [time period].
-
-Would you mind sharing a quick testimonial about your experience? Just 2-3 sentences on:
-
-- What problem you were solving
-- How [Product] helped
-- Results you've seen
-
-We'll feature it on our site with a link back to [their site/LinkedIn].
-
-Interested? I can send a simple form or we can do a quick 5-min call.
-
-[Your Name]
-```
-
-## Template 5: Digital PR / Data Outreach
-
-### Subject Lines
-- "New data on [trending topic]"
-- "[Stat] might interest [Publication] readers"
-- "Survey results: [surprising finding]"
-
-### Email Body
-```
-Hi [Name],
-
-I saw your recent coverage of [related topic] and thought you might be interested in new data we just published.
-
-Key findings from our [survey/study] of [X respondents/data points]:
-
-- [Surprising stat 1]
-- [Surprising stat 2]
-- [Surprising stat 3]
-
-Full report: [URL]
-
-We have additional data cuts and expert quotes available if you'd like to cover this for [Publication].
-
-Let me know if you need anything!
-
-[Your Name]
-[Title]
-[Contact]
-```
-
-### Journalist-Specific Tips
-- Keep extremely concise
-- Lead with newsworthy angle
-- Provide ready-to-use stats
-- Offer exclusive data or early access
-- Include high-res images/graphics
-- Make yourself available immediately
-- No ask for backlink (implied)
-
-## Personalization Strategy
-
-### Research Checklist (5 min per prospect)
-- [ ] Find recipient's name and title
-- [ ] Read their last 2-3 articles
-- [ ] Note specific details to reference
-- [ ] Check LinkedIn for mutual connections
-- [ ] Identify their content gaps
-- [ ] Confirm email address accuracy
-
-### Personalization Variables
-```
-[Name] - First name only
-[Blog Name] - Their site name
-[Article Title] - Specific recent post
-[Detail] - Specific insight from article
-[Topic] - Their niche/focus area
-[Mutual Connection] - Shared contact if applicable
-```
-
-### Mail Merge Fields
-Use these for automated personalization:
-- {{first_name}}
-- {{site_name}}
-- {{recent_article_url}}
-- {{recent_article_title}}
-- {{niche}}
-- {{custom_note}}
-
-## Subject Line Best Practices
-
-### High-Performing Patterns
-- Question format: "Quick question about [topic]?"
-- Specificity: "Article idea: [specific headline]"
-- Helpfulness: "Found issue on [page name]"
-- Name drop: "[Person] suggested I reach out"
-- Curiosity: "Noticed you're covering [topic]"
-
-### Avoid These
-- All caps: "GUEST POST OPPORTUNITY"
-- Spam triggers: "Free," "Guarantee," "Make money"
-- Generic: "Collaboration opportunity"
-- Lengthy: >60 characters
-- Clickbait: "You won't believe this..."
-
-### A/B Testing Framework
-Test 2 variants on first 20% of list:
-- Variant A: Direct/specific
-- Variant B: Curious/question
-- Send winner to remaining 80%
-
-## Response Handling
-
-### Positive Response
-```
-Hi [Name],
-
-Great to hear you're interested!
-
-[Specific next step based on campaign type]
-
-I'll [action item] by [date] and send over [deliverable].
-
-Looking forward to working together!
-
-[Your Name]
-```
-
-### Neutral/Clarification Response
-```
-Hi [Name],
-
-Thanks for getting back to me!
-
-To clarify: [answer their question clearly]
-
-[Restate value proposition briefly]
-
-Does that help? Happy to provide more details.
-
-[Your Name]
-```
-
-### Delayed Response After Follow-Up
-```
-Hi [Name],
-
-No worries at all! I know you're busy.
-
-[Brief restatement of offer]
-
-Still interested? If timing isn't right, totally understand.
-
-[Your Name]
-```
-
-## Tracking Metrics
-
-### Per-Template Performance
-- Open rate target: 40%+
-- Response rate target: 25%+
-- Conversion rate target: 10%+
-- Average time to response: <48 hours
-
-### Optimization Signals
-- Low open rate → Test subject lines
-- High open, low response → Revise body copy
-- High response, low conversion → Adjust offer/CTA
-- Pattern by day/time → Adjust send schedule
-
-## Tools Integration
-
-### Email Automation
-- Hunter.io: Email finding
-- Mailshake: Outreach sequences
-- Lemlist: Personalization at scale
-- Reply.io: Multi-channel campaigns
-
-### Tracking
-- Streak CRM: Gmail tracking
-- HubSpot: Full CRM integration
-- Google Sheets: Manual tracking spreadsheet
-- Airtable: Visual pipeline management