@olives/devos 2.1.0

package/.agents/skills/seo-geo/examples/opc-skills-case-study.md

@@ -0,0 +1,330 @@
+# Case Study: OPC Skills Website SEO/GEO Optimization
+
+Real-world example of applying SEO and GEO optimization to opc.dev.
+
+---
+
+## Background
+
+**Website:** opc.dev  
+**Product:** AI Agent Skills for Solopreneurs  
+**Platforms:** Claude Code, Cursor, Codex, Factory Droid, OpenCode  
+**Date:** January 2026
+
+### Initial Status
+
+| Metric | Status |
+|--------|--------|
+| Google Indexed | ❌ No |
+| Bing Indexed | ❌ No |
+| Schema Markup | ❌ None |
+| FAQ Section | ❌ None |
+| Meta Tags | ⚠️ Basic |
+| AI Bot Access | ⚠️ Not configured |
+
+---
+
+## Problem Analysis
+
+### 1. Keyword Conflict
+
+The term "OPC" has different meanings in different markets:
+
+| Market | "OPC" Meaning |
+|--------|--------------|
+| English (Industrial) | OPC UA - Industrial automation protocol |
+| Chinese | 一人公司 (One Person Company) |
+| Solopreneur | One Person Company (intended meaning) |
+
+**Decision:** Focus on long-tail keywords for English market:
+- "AI agent skills for solopreneurs"
+- "Claude Code skills"
+- "indie hacker tools"
+
+### 2. Missing Schema Markup
+
+No structured data meant:
+- No rich results in Google
+- Poor AI visibility
+- No FAQ display
+
+### 3. No GEO Optimization
+
+Content lacked:
+- Statistics and data points
+- Expert citations
+- FAQ format
+- Answer-first structure
+
+---
+
+## Implementation
+
+### Phase 1: Meta Tags Optimization
+
+**Before:**
+```html
+<title>OPC Skills</title>
+<meta name="description" content="Skills for one person companies">
+```
+
+**After:**
+```html
+<title>OPC Skills - AI Agent Skills for Solopreneurs & Indie Hackers | Claude Code, Cursor, Codex</title>
+<meta name="description" content="10+ AI agent skills for solopreneurs. Domain hunting, social media research, logo creation. Works with Claude Code, Cursor, Codex, Factory Droid. One-click install, 100% open source.">
+```
+
+**Keywords targeted:**
+- solopreneur (high intent, low competition)
+- indie hacker (community term)
+- Claude Code skills (specific platform)
+- AI agent skills (emerging category)
+
+### Phase 2: Schema Markup Implementation
+
+Added comprehensive JSON-LD:
+
+```json
+{
+  "@context": "https://schema.org",
+  "@graph": [
+    {
+      "@type": "WebPage",
+      "name": "OPC Skills - AI Agent Skills for Solopreneurs",
+      "description": "10+ agent skills for Claude Code, Cursor, Codex...",
+      "dateModified": "2026-01-20",
+      "speakable": {
+        "@type": "SpeakableSpecification",
+        "cssSelector": ["h1", ".hero-description", ".faq-answer"]
+      }
+    },
+    {
+      "@type": "SoftwareApplication",
+      "name": "OPC Skills",
+      "applicationCategory": "DeveloperApplication",
+      "operatingSystem": "Cross-platform",
+      "offers": {
+        "@type": "Offer",
+        "price": "0",
+        "priceCurrency": "USD"
+      }
+    },
+    {
+      "@type": "FAQPage",
+      "mainEntity": [
+        {
+          "@type": "Question",
+          "name": "What is OPC Skills?",
+          "acceptedAnswer": {
+            "@type": "Answer",
+            "text": "OPC Skills is a collection of 10+ AI agent skills..."
+          }
+        }
+        // 12 total FAQ items
+      ]
+    }
+  ]
+}
+```
+
+### Phase 3: GEO Optimization (Princeton Methods)
+
+#### Statistics Addition (+37%)
+
+**Before:**
+```
+"Skills for one person companies"
+```
+
+**After:**
+```
+"10+ Skills | 5 Platforms | One-Click Install | 100% Open Source"
+```
+
+#### FAQ Section (+40% AI Visibility)
+
+Added 12 FAQ questions targeting high-search queries:
+
+1. What is OPC Skills?
+2. What platforms does OPC Skills support?
+3. How do I install OPC Skills?
+4. Is OPC Skills free?
+5. What skills are included in OPC Skills?
+6. How does the domain-hunter skill work?
+7. Can I use OPC Skills with Claude Code?
+8. What is the twitter skill used for?
+9. How do I create a logo with OPC Skills?
+10. Is OPC Skills open source?
+11. How do I contribute to OPC Skills?
+12. What is a solopreneur?
+
+#### Authoritative Tone (+25%)
+
+**Before:**
+```
+"Some tools for solo workers"
+```
+
+**After:**
+```
+"AI Agent Skills for Solopreneurs - The definitive skill library for 
+one-person companies. Trusted by indie hackers worldwide."
+```
+
+#### Citations (+40%)
+
+Added references to:
+- Anthropic (Claude Code official documentation)
+- Industry statistics on solopreneur growth
+- Sam Altman's "billion-dollar one-person company" prediction
+
+### Phase 4: AI Bot Configuration
+
+Updated robots.txt considerations:
+
+```
+# Allow AI bots for GEO visibility
+User-agent: GPTBot
+Allow: /
+
+User-agent: PerplexityBot
+Allow: /
+
+User-agent: ClaudeBot
+Allow: /
+```
+
+### Phase 5: Hero Section Rewrite
+
+**Before:**
+```
+OPC Skills
+Skills for OPCs
+```
+
+**After:**
+```
+AI Agent Skills for Solopreneurs
+
+The skill library for one-person companies. 
+Install once, use everywhere.
+
+10+ Skills | 5 Platforms | One-Click Install | 100% Open Source
+```
+
+---
+
+## Results
+
+### Technical Improvements
+
+| Metric | Before | After |
+|--------|--------|-------|
+| Meta Title | "OPC Skills" | Full keyword-rich title |
+| Meta Description | 20 chars | 155 chars |
+| Schema Types | 0 | 4 (WebPage, Software, FAQ, Org) |
+| FAQ Items | 0 | 12 |
+| Statistics | 0 | 4 key metrics |
+
+### SEO Improvements
+
+| Factor | Before | After |
+|--------|--------|-------|
+| Title keyword match | ❌ | ✅ |
+| Description keyword match | ❌ | ✅ |
+| Structured data | ❌ | ✅ |
+| Rich results eligible | ❌ | ✅ |
+
+### GEO Improvements
+
+| Princeton Method | Applied | Expected Boost |
+|-----------------|---------|----------------|
+| Cite Sources | ✅ | +40% |
+| Statistics | ✅ | +37% |
+| FAQ Schema | ✅ | +40% |
+| Authoritative Tone | ✅ | +25% |
+| Easy Language | ✅ | +20% |
+
+**Estimated total GEO visibility boost: 40-60%**
+
+---
+
+## Lessons Learned
+
+### 1. Keyword Research is Critical
+
+The "OPC" keyword conflict could have hurt visibility. Long-tail keywords solved this:
+- "solopreneur tools" > "OPC tools"
+- "Claude Code skills" > "AI skills"
+
+### 2. FAQPage Schema is High-Impact
+
+Adding 12 FAQ items with proper schema:
+- Enables rich results
+- Provides AI-extractable content
+- Targets specific search queries
+
+### 3. Statistics Make Content Quotable
+
+"10+ Skills | 5 Platforms | One-Click Install | 100% Open Source"
+
+These specific numbers are:
+- Easy for AI to extract
+- Memorable for users
+- Differentiated from competitors
+
+### 4. Answer-First Structure
+
+Each FAQ answer starts with a direct answer:
+- "OPC Skills is a collection of..." (not "Well, it depends...")
+- This matches AI response patterns
+
+---
+
+## Next Steps
+
+### Short-term (1 month)
+
+- [ ] Submit sitemap to Google Search Console
+- [ ] Submit to Bing Webmaster Tools
+- [ ] Monitor indexing progress
+- [ ] Track FAQ rich results
+
+### Medium-term (3 months)
+
+- [ ] Monitor AI citation rate
+- [ ] A/B test different FAQ questions
+- [ ] Build backlinks from dev communities
+- [ ] Create content for Reddit/HN
+
+### Long-term (6 months)
+
+- [ ] Establish "OPC Skills = Solopreneur tools" brand
+- [ ] Rank for "Claude Code skills" in AI search
+- [ ] Get cited in AI responses about solopreneur tools
+
+---
+
+## Replication Guide
+
+To replicate this optimization for your own site:
+
+1. **Audit current state** using seo-geo skill checklist
+2. **Research keywords** - find long-tail opportunities
+3. **Write meta tags** - include primary keyword in title/description
+4. **Add Schema markup** - start with FAQPage and WebPage
+5. **Apply Princeton methods** - statistics, citations, structure
+6. **Configure AI bot access** - robots.txt
+7. **Validate schema** - Google Rich Results Test
+8. **Submit to search engines** - Search Console, Bing Webmaster
+9. **Monitor and iterate** - track visibility, adjust content
+
+---
+
+## Files Changed
+
+| File | Changes |
+|------|---------|
+| `website/worker.js` | Meta tags, Schema, Hero section, FAQ section, Stats bar |
+| `README.md` | Badges, navigation links, updated tagline |
+| `docs/MARKETING_SPEC.md` | Comprehensive marketing plan (new) |

package/.agents/skills/seo-geo/references/geo-research.md

@@ -0,0 +1,319 @@
+# GEO Research: Princeton Study & Optimization Methods
+
+## Paper Overview
+
+**Title:** GEO: Generative Engine Optimization  
+**Authors:** Princeton University, IIT Delhi, Georgia Tech, Allen Institute for AI  
+**Published:** November 2023 (arXiv:2311.09735)  
+**Accepted:** KDD 2024 (30th ACM SIGKDD Conference)  
+**Link:** https://arxiv.org/abs/2311.09735
+
+---
+
+## Key Findings
+
+### What is GEO?
+
+**Generative Engine Optimization (GEO)** is a novel framework to help content creators improve their visibility in **generative engine responses** (AI search engines like ChatGPT, Perplexity, Google SGE).
+
+Unlike traditional SEO (ranking in search results), GEO focuses on **being cited** by AI systems.
+
+### Core Results
+
+| Metric | Result |
+|--------|--------|
+| **Maximum Visibility Boost** | Up to 40% |
+| **Low-ranking Sites Boost** | Up to 115% with citations |
+| **GEO-bench Dataset** | 10,000+ queries across domains |
+| **Tested on** | Perplexity.ai (commercial GE) |
+
+### Why GEO Matters
+
+1. **Traditional search engines are being replaced** by generative engines
+2. **Content creators have little control** over how their content appears in AI responses
+3. **GEO provides systematic methods** to improve visibility
+4. **Different domains need different strategies** - no one-size-fits-all
+
+---
+
+## The 9 Optimization Methods
+
+### Method 1: Cite Sources (+40%)
+
+**What:** Add authoritative citations and references to your content.
+
+**Why it works:** AI systems prefer content that appears well-researched and credible. Citations signal authority.
+
+**How to apply:**
+```markdown
+# Before
+"Studies show that AI improves productivity."
+
+# After
+"According to a 2024 Stanford University study, AI tools improve developer 
+productivity by 55% on average (Chen et al., 2024)."
+```
+
+**Best for:** All content types, especially academic/professional topics.
+
+---
+
+### Method 2: Statistics Addition (+37%)
+
+**What:** Include specific numbers, data points, and quantitative information.
+
+**Why it works:** AI systems prioritize factual, verifiable information. Numbers make content more quotable.
+
+**How to apply:**
+```markdown
+# Before
+"Many companies use AI for customer service."
+
+# After
+"67% of Fortune 500 companies now use AI chatbots for customer service, 
+handling an average of 85% of routine inquiries without human intervention."
+```
+
+**Best for:** Business, finance, technology, health content.
+
+---
+
+### Method 3: Quotation Addition (+30%)
+
+**What:** Add expert quotes with proper attribution.
+
+**Why it works:** Quotes from recognized experts boost credibility and provide extractable content for AI.
+
+**How to apply:**
+```markdown
+# Before
+"AI will transform the workforce."
+
+# After
+"'We're likely to see the first one-person billion-dollar company in the 
+next few years,' predicts Sam Altman, CEO of OpenAI. 'AI will be the 
+great equalizer for small businesses.'"
+```
+
+**Best for:** Law, academic, news, thought leadership content.
+
+---
+
+### Method 4: Authoritative Tone (+25%)
+
+**What:** Write with confidence and expertise.
+
+**Why it works:** AI systems assess content quality partly through linguistic signals of authority.
+
+**How to apply:**
+```markdown
+# Before
+"This might help with SEO, I think."
+
+# After
+"This strategy demonstrably improves SEO performance. Based on our 
+analysis of 10,000 websites, implementing structured data increases 
+organic traffic by an average of 30%."
+```
+
+**Best for:** Business, professional services, technical documentation.
+
+---
+
+### Method 5: Easy-to-Understand (+20%)
+
+**What:** Simplify complex concepts for broader accessibility.
+
+**Why it works:** AI aims to provide helpful answers to users of all knowledge levels.
+
+**How to apply:**
+```markdown
+# Before
+"The RAG architecture utilizes vector embeddings for semantic retrieval 
+in conjunction with LLM-based generation."
+
+# After
+"RAG (Retrieval-Augmented Generation) works like a research assistant: 
+it first searches for relevant information, then uses AI to write a 
+coherent answer based on what it found."
+```
+
+**Best for:** Health, education, general consumer content.
+
+---
+
+### Method 6: Technical Terms (+18%)
+
+**What:** Include domain-specific terminology appropriately.
+
+**Why it works:** Technical terms signal expertise and help AI match content to specialized queries.
+
+**How to apply:**
+```markdown
+# Before
+"The website loads slowly."
+
+# After
+"The website suffers from poor Core Web Vitals: LCP (Largest Contentful 
+Paint) exceeds 4 seconds, and CLS (Cumulative Layout Shift) scores 0.3, 
+indicating significant layout instability."
+```
+
+**Best for:** Technology, science, medical, legal content.
+
+---
+
+### Method 7: Unique Words (+15%)
+
+**What:** Increase vocabulary diversity and use distinctive phrasing.
+
+**Why it works:** Diverse vocabulary indicates depth of knowledge and makes content more distinguishable.
+
+**How to apply:**
+- Use synonyms and varied terminology
+- Avoid repetitive phrasing
+- Include industry-specific jargon where appropriate
+- Add contextual variations
+
+**Best for:** All content types.
+
+---
+
+### Method 8: Fluency Optimization (+15-30%)
+
+**What:** Improve readability, flow, and grammatical quality.
+
+**Why it works:** Well-written content is easier for AI to parse and more likely to be selected as authoritative.
+
+**How to apply:**
+- Use clear sentence structure
+- Maintain logical flow between paragraphs
+- Eliminate redundancy
+- Use transition words
+- Keep paragraphs focused (2-3 sentences)
+
+**Best for:** All content types.
+
+---
+
+### Method 9: Keyword Stuffing (-10%) ⚠️
+
+**What:** Overloading content with target keywords.
+
+**Why it HURTS:** Unlike traditional SEO, keyword stuffing actively decreases AI visibility.
+
+**Avoid:**
+```markdown
+# BAD - Keyword stuffing
+"SEO optimization for SEO is the best SEO strategy. Our SEO experts 
+provide SEO services for all your SEO needs. SEO is important for SEO."
+
+# GOOD - Natural writing
+"Search engine optimization is essential for online visibility. Our 
+experts help businesses improve their search rankings through strategic 
+content development and technical improvements."
+```
+
+---
+
+## Best Combinations
+
+The Princeton research found that combining methods yields better results:
+
+| Combination | Effectiveness |
+|-------------|--------------|
+| **Fluency + Statistics** | Highest overall boost |
+| **Citations + Authoritative Tone** | Best for professional content |
+| **Easy Language + Statistics** | Best for consumer content |
+| **Technical Terms + Citations** | Best for academic/scientific |
+
+---
+
+## Domain-Specific Recommendations
+
+| Domain | Best Methods | Avoid |
+|--------|-------------|-------|
+| **Technology** | Technical Terms, Citations, Statistics | Oversimplification |
+| **Business/Finance** | Statistics, Authoritative Tone, Citations | Vague claims |
+| **Healthcare** | Easy Language, Statistics, Citations | Jargon overload |
+| **Legal** | Citations, Quotations, Authoritative Tone | Informal language |
+| **Education** | Easy Language, Examples, Structure | Complexity |
+| **E-commerce** | Statistics, Social Proof, Clear Benefits | Feature dumps |
+
+---
+
+## GEO Metrics
+
+The paper introduces visibility metrics for evaluating GEO effectiveness:
+
+### Position-Adjusted Word Count
+
+Measures how much of your content appears in AI responses, weighted by position (earlier = better).
+
+### Subjective Impression Score
+
+Human evaluation of how prominently your content is featured in responses.
+
+### Word Count Share
+
+Percentage of AI response that comes from your content vs. competitors.
+
+---
+
+## Implementation Checklist
+
+### Content Optimization
+
+- [ ] Add 2-3 authoritative citations per major section
+- [ ] Include at least 5 relevant statistics with sources
+- [ ] Add 1-2 expert quotes with attribution
+- [ ] Use confident, authoritative language
+- [ ] Ensure content is accessible to general audience
+- [ ] Include appropriate technical terminology
+- [ ] Vary vocabulary throughout
+- [ ] Improve overall fluency and readability
+- [ ] Remove any keyword stuffing
+
+### Structure Optimization
+
+- [ ] Use "answer-first" format (direct answer at top)
+- [ ] Clear H1 > H2 > H3 hierarchy
+- [ ] Bullet points for lists
+- [ ] Tables for comparisons
+- [ ] Short paragraphs (2-3 sentences)
+- [ ] Logical flow between sections
+
+### Schema Optimization
+
+- [ ] Implement FAQPage schema (+40% AI visibility)
+- [ ] Add Article schema with author info
+- [ ] Include datePublished and dateModified
+- [ ] Add SpeakableSpecification for voice search
+
+---
+
+## Validation on Commercial Platforms
+
+The researchers validated GEO methods on **Perplexity.ai**, a commercial generative engine:
+
+| Method | Visibility Increase |
+|--------|-------------------|
+| Cite Sources | Up to 37% |
+| Statistics | Up to 35% |
+| Quotations | Up to 28% |
+| Combined methods | Up to 40% |
+
+These results confirm that GEO methods work on real-world AI search engines, not just research benchmarks.
+
+---
+
+## Future of GEO
+
+The paper concludes that GEO is essential for:
+
+1. **Content creators** - Maintain visibility in AI-dominated search
+2. **Businesses** - Ensure brand presence in AI responses
+3. **Publishers** - Adapt to the citation economy
+4. **SEO professionals** - Evolve practices for generative search
+
+As AI search engines become more prevalent, GEO will become as important as traditional SEO.

package/.agents/skills/seo-geo/references/google-docs-summary.md

@@ -0,0 +1,65 @@
+# Google Official SEO Documentation Summary
+
+Quick reference from Google Search Central.
+
+---
+
+## Search Three-Stage Process
+
+| Stage | Description | Focus |
+|-------|-------------|-------|
+| **Crawling** | Googlebot discovers pages | robots.txt, sitemap, links |
+| **Indexing** | Content analyzed and stored | Quality, canonical, noindex |
+| **Serving** | Results returned | Relevance, E-E-A-T, UX |
+
+---
+
+## Core Web Vitals
+
+| Metric | Good | Needs Work | Poor |
+|--------|------|------------|------|
+| **LCP** | < 2.5s | 2.5-4s | > 4s |
+| **FID** | < 100ms | 100-300ms | > 300ms |
+| **CLS** | < 0.1 | 0.1-0.25 | > 0.25 |
+
+---
+
+## Structured Data Types
+
+| Type | Use Case | Rich Result |
+|------|----------|-------------|
+| FAQPage | FAQ content | Expandable Q&A |
+| Article | Blog/news | Title + date |
+| Product | E-commerce | Price + rating |
+| HowTo | Tutorials | Steps |
+| VideoObject | Video | Thumbnail |
+| BreadcrumbList | Navigation | Breadcrumbs |
+
+---
+
+## Spam Policies (Avoid)
+
+- Keyword stuffing
+- Hidden text/links
+- Link schemes
+- Auto-generated content
+- Scraped content
+- Cloaking
+
+---
+
+## Official Tools
+
+| Tool | URL |
+|------|-----|
+| Search Console | search.google.com/search-console |
+| Rich Results Test | search.google.com/test/rich-results |
+| PageSpeed Insights | pagespeed.web.dev |
+| Mobile-Friendly Test | search.google.com/test/mobile-friendly |
+
+---
+
+## Reference
+
+- https://developers.google.com/search
+- https://developers.google.com/search/docs/fundamentals/seo-starter-guide