@jairodri/huckleberry-cli 1.0.1 → 1.1.0

package/skills/ai-agent-seo/SKILL.md

@@ -0,0 +1,450 @@
+---
+name: ai-agent-seo
+description: "SEO strategy and content optimization for AI agent consulting businesses. Keyword research, landing pages, and authority building for the AI..."
+---
+
+# Skill: AI Agent Consulting SEO
+
+## Overview
+
+SEO system for AI agent consulting and implementation services. Targets businesses wanting to build custom AI agents but lacking technical expertise. Unlike SaaS SEO or local SEO, this focuses on: service page optimization, case study rankings, "build vs buy" comparison content, and authority building in AI/tech ecosystem.
+
+## When to Use
+
+- AI automation consulting businesses offering custom agent development
+- Agencies building AI workflows for clients
+- Technical consultants specializing in Claude, NotebookLM, automation scripts
+- Implementation services for AI-driven business processes
+
+## Core Value Proposition
+
+**Market Gap:** Every business wants "AI agents to automate workflows" but can't find reliable consultants. Most content is "use ChatGPT" fluff - not "we build custom agents for your exact workflow."
+
+**Differentiators:**
+1. **Proven Infrastructure** - ai.withjai.com as live demonstration of capabilities
+2. **Transparent Systems** - Show how agents work, not black box solutions
+3. **Multi-Modal Expertise** - Research + Content + Social + Publishing automation
+4. **Case Study Evidence** - Real implementations with measurable outcomes
+
+---
+
+## Quick Start
+
+```bash
+# Load business context (AI agent consulting model)
+node scripts/seo/load-business-context.js --brand ai.withjai --interactive
+
+# Run AI agent SEO prompts
+node scripts/seo/ai-agent-seo/run-prompt.js --prompt 1 --brand ai.withjai
+
+# Execute full 8-week plan
+node scripts/seo/ai-agent-seo/run-prompt.js --full-plan --brand ai.withjai
+```
+
+---
+
+## Prompt System (12 Prompts)
+
+### Phase 1: Foundation (Week 1)
+**Prompt 0: AI Agent Business Context Loader**
+- Load service offerings (audit, implementation, full automation)
+- Define target industries (e-commerce, agencies, SaaS, service businesses)
+- Map agent types to industries (newsletter agents, social agents, research agents, etc.)
+- Identify pricing tiers and delivery models
+- Note existing infrastructure and proof points
+
+**Prompt 1: AI Agent Keyword Research**
+- Research: "AI agent development services," "build AI agents for [industry]"
+- Identify: Custom agent vs off-the-shelf tool searches
+- Find: "Claude automation consultants," "AI workflow implementation" keywords
+- Categorize by: Search intent (problem-aware, solution-aware, ready-to-hire)
+- Prioritize: (1) High-custom service intent, (2) Industry-specific agent keywords
+
+**Prompt 2: Competitor Analysis (AI Consulting Focused)**
+- Analyze: AI consulting agencies, not SaaS tools
+- Research: Their service offerings, case studies, pricing
+- Extract: Messaging angles, differentiation, proof strategies
+- Identify: Gaps in their service coverage (your opportunities)
+- Find: Their backlinks and authority sources
+
+### Phase 2: Service Pages (Weeks 2-3)
+**Prompt 3: Service Page Strategy**
+- Map: Each agent type to dedicated service page
+  - Newsletter Content Production Agent
+  - Social Media Automation Agent
+  - Research-to-Content Agent
+  - Customer Service Agent
+  - Onboarding Automation Agent
+- Define: Page structure (problem → agent solution → features → case studies → pricing → CTA)
+- Create: Keyword targeting per page type
+
+**Prompt 4: Industry-Specific Service Pages**
+- For each target industry (e-commerce, agencies, SaaS):
+  - Build "AI Agent for [Industry] Automation" pages
+  - Industry-specific problems and use cases
+  - Industry-relevant case studies and testimonials
+- Target: "[Industry] AI automation" keywords
+
+### Phase 3: Comparison Content (Weeks 3-4)
+**Prompt 5: "Build vs Buy" Comparison Framework**
+- Create: Framework for comparing custom agents vs SaaS tools
+- Structure: Feature comparison, total cost of ownership, ROI timeline
+- Differentiators: Customization, integration, ongoing support
+- Keywords: "custom AI agents vs [tool]," "build or buy [workflow automation]"
+
+**Prompt 6: Competitor Comparison Pages**
+- Analyze: How competitors position "us vs alternatives"
+- Build: Comparison pages for major SaaS competitors:
+  - Make.com vs Custom AI Agents
+  - Zapier vs Custom Automation
+  - Off-the-shelf vs Tailored Solutions
+- Highlight: Where custom agents win (complex workflows, integrations, long-term ROI)
+
+### Phase 4: Case Studies & Proof (Weeks 4-5)
+**Prompt 7: Case Study Optimization**
+- Optimize: Existing case studies for SEO
+- Structure: Problem → Solution (custom agent) → Implementation → Results → Metrics
+- Add: Schema markup for case studies
+- Target: "[Industry] AI automation case study" keywords
+- Include: ROI calculations and testimonials
+
+**Prompt 8: Technical Content Strategy**
+- Create: Technical content showcasing expertise:
+  - "How to Build AI Agents for [Workflow]"
+  - "Claude + NotebookLM Automation Architecture"
+  - "API Integration for Custom Agents"
+- Target: Developer and technical decision-maker keywords
+- Demonstrate: Deep technical knowledge
+
+### Phase 5: Authority Building (Weeks 5-6)
+**Prompt 9: AI/Tech Authority Audit**
+- Research: AI/tech publications and directories
+  - AI blogs (The Gradient, Machine Learning Mastery)
+  - Tech publications (Towards Data Science, VentureBeat)
+  - AI directories (AI Valley, Product Hunt)
+- Check: Existing mentions, backlinks, review opportunities
+- Build: Prioritized authority building list
+
+**Prompt 10: Backlink Gap Analysis**
+- Use Ahrefs to analyze:
+  - Where competitors get backlinks
+  - SaaS directories linking to automation tools
+  - AI/tech blogs covering custom agent development
+- Identify: Link opportunities unique to consulting (case studies, guest posts)
+- Build: 90-day outreach plan
+
+### Phase 6: Pricing & ROI Content (Weeks 6-7)
+**Prompt 11: Pricing Page Optimization**
+- Create: Transparent pricing page
+- Structure: Service tiers with clear deliverables and timelines
+- Include: ROI examples per tier
+- Target: "AI agent development cost," "workflow automation pricing" keywords
+- Add: Case study ROI breakdowns
+
+**Prompt 12: FAQ & Objection Handling**
+- Create: Comprehensive FAQ addressing:
+  - "How much does custom AI agent cost?"
+  - "How long does AI agent development take?"
+  - "What integrations do you support?"
+  - "Can I see examples of agents you've built?"
+- Target: Problem-aware and solution-aware keywords
+- Improve: Conversion rates by addressing concerns upfront
+
+### Phase 7: Performance Tracking (Weeks 7-8)
+**Prompt 13: Monthly SEO Performance Report**
+- Track: Organic traffic, lead quality, conversion rate
+- Monitor: Keyword rankings for service pages
+- Analyze: Case study performance and backlink growth
+- Report: ROI of SEO efforts vs new consulting revenue
+
+**Prompt 14: Content Calendar Optimization**
+- Build: Content calendar targeting buyer journey:
+  - Problem-aware: "Signs you need AI agents"
+  - Solution-aware: "AI agent types for different workflows"
+  - Comparison: "Custom vs off-the-shelf"
+  - Decision: Pricing, testimonials, ROI
+- Integrate: With existing content pipeline for production
+
+---
+
+## Business Context Structure
+
+**File:** `businesses/{business}/seo/business-context.json`
+
+```json
+{
+  "business_model": {
+    "type": "AI Agent Consulting & Implementation",
+    "primary_offering": "Custom AI agent development for business workflow automation",
+    "service_tiers": {
+      "audit": "$1,000-2,500",
+      "implementation": "$5,000-15,000",
+      "full_automation": "$25,000+"
+    },
+    "delivery_model": "Consulting + Build + Train + Support (90-day engagement)"
+  },
+  "target_customer": {
+    "description": "Business owners wanting AI agents but lacking technical expertise",
+    "segments": [
+      "E-commerce stores (inventory, customer service automation)",
+      "Agencies (content creation, client management)",
+      "SaaS companies (onboarding, support workflows)",
+      "Service businesses (scheduling, follow-up automation)"
+    ],
+    "pain_points": [
+      "Overwhelmed by AI tools but don't know how to implement",
+      "Tried ChatGPT but got generic results",
+      "Need custom automation but can't find reliable consultant",
+      "Worried about ROI and implementation timeline"
+    ]
+  },
+  "service_offerings": [
+    "Newsletter Content Production AI Agent",
+    "Social Media Automation AI Agent",
+    "Research-to-Content AI Agent",
+    "Customer Service AI Agent",
+    "Onboarding Automation AI Agent",
+    "Multi-Workflow AI Agent Ecosystem"
+  ],
+  "existing_infrastructure": [
+    "ai.withjai.com (live demo of capabilities)",
+    "Content automation pipeline (research → content → social → publish)",
+    "Social media automation (6 platforms with quality validation)",
+    "Podcast research automation (NotebookLM integration)"
+  ],
+  "competitors": [
+    {
+      "name": "[AI Consulting Agency]",
+      "type": "AI Consulting",
+      "website": "[URL]",
+      "service_offering": "Brief description",
+      "pricing": "Range",
+      "why_they_win": "Strengths",
+      "where_they_lose": "Weaknesses (your opportunities)"
+    }
+  ],
+  "seo_goals": {
+    "primary_keywords": [
+      "AI agent development services",
+      "custom AI agent consulting",
+      "AI workflow automation consultants",
+      "build AI agents for my business"
+    ],
+    "comparison_keywords": [
+      "custom AI agents vs Zapier",
+      "AI agents vs Make.com",
+      "build or buy automation"
+    ],
+    "industry_keywords": [
+      "e-commerce AI agents",
+      "agency AI automation",
+      "SaaS workflow automation",
+      "content creation AI agents"
+    ],
+    "currently_ranking": [
+      "[keyword]"
+    ],
+    "should_rank": [
+      "[opportunity keyword]"
+    ]
+  },
+  "current_performance": {
+    "organic_traffic": "[monthly visitors]",
+    "lead_quality": "[consulting inquiry vs tire-kicker ratio]",
+    "conversion_rate": "[inquiry to client %]",
+    "biggest_seo_problem": "[honest assessment]"
+  }
+}
+```
+
+---
+
+## Key SEO Strategies
+
+### 1. Service Page Architecture
+
+**Each Service Page Structure:**
+1. **Hero Section:** "[Service Type] AI Agent" + "[Target Industry] Automation"
+2. **Problem Section:** "Struggling with [specific workflow problem]?"
+3. **Solution Section:** How our custom agent solves it (not "uses AI" fluff)
+4. **How It Works:** Architecture diagram (Claude + NotebookLM + automation scripts)
+5. **Features:** Specific capabilities (integrations, triggers, quality validation)
+6. **Case Study:** Real implementation with metrics
+7. **Pricing:** Transparent tiered pricing
+8. **FAQ:** Common questions and concerns
+9. **CTA:** Book free AI workflow audit
+
+### 2. Comparison Content Framework
+
+**"Build vs Buy" Comparison Page:**
+1. **Introduction:** "Custom AI Agent vs [Tool Name]"
+2. **Quick Comparison Table:** Feature-by-feature breakdown
+3. **When [Tool] Wins:** Specific use cases (simple, one-off needs)
+4. **When Custom Agent Wins:** Complex workflows, integrations, long-term ROI
+5. **Total Cost Comparison:** Tool subscription vs custom build vs ROI
+6. **Real Examples:** Show where clients switched and results
+7. **Decision Framework:** Quiz/assessment helping visitor decide
+8. **CTA:** Free consultation to assess needs
+
+### 3. Case Study SEO
+
+**Case Study Template:**
+- **Title:** "[Client Name] [Industry] Automated with Custom AI Agent"
+- **Problem:** Specific workflow challenges
+- **Solution:** Custom agent architecture
+- **Implementation:** Timeline and process
+- **Results:** Quantified outcomes (hours saved, revenue increase)
+- **ROI:** Calculation and timeline
+- **Testimonial:** Quote and attribution
+- **Technical Details:** Architecture overview (for credibility)
+- **Keywords:** "[Industry] AI automation case study," "custom [workflow] agent results"
+
+### 4. Authority Building
+
+**AI/Tech Publication Strategy:**
+- **Guest Posts:** Technical tutorials on agent architecture
+- **Case Studies:** Submit to AI blogs and tech pubs
+- **Tool Directories:** List services on AI directories
+- **Product Hunt:** Launch as "AI Agent Consulting Service"
+- **G2 / Capterra:** Get reviews for consulting services
+- **Backlinks:** From SaaS companies you integrate with (Claude, NotebookLM, etc.)
+
+---
+
+## Success Metrics
+
+**90-Day Targets:**
+- Service page rankings: +3 top 10 positions per service type
+- Comparison traffic: 40-60% increase
+- Lead quality: 50%+ qualified inquiries (already researching AI agents)
+- Backlinks: +5-10 AI/tech authority links
+- Case study rankings: Top 3 for "[industry] AI automation" keywords
+
+**Proof Points:**
+- Service page optimization → higher CTR for custom agent searches
+- Comparison content → captures decision-stage traffic
+- Case studies → builds trust and demonstrates expertise
+- Technical content → attracts high-intent consulting inquiries
+
+---
+
+## Implementation Guide
+
+### Scripts
+
+**Directory:** `scripts/seo/ai-agent-seo/`
+
+**Prompt Runner:** `run-prompt.js`
+- Loads AI agent consulting business context
+- Executes prompts from skill documentation
+- Tracks execution log
+- Outputs: Keyword research, competitor analysis, content briefs
+
+**Business Context:** `load-business-context.js`
+- Interactive loader for AI agent consulting model
+- Captures: Service offerings, target industries, competitors
+- Sets up: Pricing tiers, delivery models, existing infrastructure
+
+---
+
+## Integration with Existing System
+
+**Connects to:**
+- `content-pipeline-complete` - Use comparison and case study briefs
+- `platform-content-generator` - Promote service pages and case studies
+- `publishing-blog-articles` - Publish technical tutorials
+- `analytics-tracking` - Track service page performance
+
+**Existing Assets as Proof:**
+- ai.withjai.com → Live demo of agent capabilities
+- Content pipeline → Proof of content automation workflow
+- Social automation → Proof of multi-platform publishing
+- Research automation → Proof of NotebookLM integration
+
+---
+
+## Common Mistakes to Avoid
+
+- ❌ **Focusing on generic "AI" keywords** - too broad, low conversion
+- ❌ **Not showing agent architecture** - clients want to understand what they're buying
+- ❌ **Missing "build vs buy" comparison** - clients need help deciding
+- ❌ **Not publishing case studies** - biggest trust builder
+- ❌ **Hiding pricing** - transparency builds trust in consulting
+- ❌ **Targeting other agencies** - they're not your competition
+- ❌ **Not using ai.withjai.com as proof** - live demonstration beats testimonials
+
+---
+
+## Example: Service Page Strategy
+
+**Service:** "Newsletter Content Production AI Agent"
+
+**Target Keywords:**
+- "newsletter content automation AI agent"
+- "custom AI agent for newsletter production"
+- "automate newsletter content creation AI"
+- "AI newsletter writer agent"
+
+**Competitor Strategy:**
+- Make.com: "Newsletter automation" (tool, not service)
+- Zapier: "Email newsletter automation" (tool, not service)
+- Off-the-shelf newsletter AI: Generic ChatGPT prompts
+
+**Your Differentiators:**
+1. **Full Workflow:** Research (NotebookLM) → Write (Claude) → Validate (Ralph) → Publish (6 platforms)
+2. **Quality System:** Not just "AI writes content" - validates engagement scores
+3. **Customization:** Adapts to your voice, tone, and topics
+4. **Proof:** ai.withjai.com as live demo
+
+**Pricing:** $5,000 setup + $1,000/mo maintenance
+
+**ROI Case Study:** "[Client] saved 80 hours/month → $12,000/year value → Paid $17,000 total → ROI 3.4x"
+
+---
+
+## Resources
+
+### AI/Tech Publications for Authority
+- The Gradient (DeepLearning.AI): Technical AI articles
+- Machine Learning Mastery: Practical AI tutorials
+- Towards Data Science: Data science and AI
+- VentureBeat AI: AI industry news
+- AI Valley: AI startup directory
+- Product Hunt: Product discovery
+
+### Directories for Consulting
+- G2: Software directory with consulting reviews
+- Capterra: Software directory with consulting reviews
+- Clutch: B2B service reviews
+- GoodFirms: Service provider reviews
+
+### Competitor Research
+- AI Agency directories
+- Consulting firm case studies
+- AI automation company websites
+- LinkedIn: Search "AI consultant" and filter by results
+
+---
+
+## Support
+
+### Getting Started
+1. Run AI agent business context loader
+2. Execute prompts 1-2 (foundation)
+3. Build service pages based on prompt 3-4 outputs
+4. Create comparison content from prompt 5-6
+5. Publish case studies from prompt 7-8
+6. Build authority from prompt 9-10
+7. Track performance with prompt 13-14
+
+### Questions
+- For implementation help: Check scripts/seo/ai-agent-seo/
+- For prompt customization: Review business context structure
+- For integration guidance: See "Integration with Existing System" section
+
+---
+
+**System Status:** ✅ Operational | 🎯 AI Agent Consulting Focus | 💰 High-Intent Traffic | 🏆 Differentiated from SaaS Tools
+
+**Last Updated:** 2026-03-25
+**Philosophy:** Don't compete with SaaS tools on "automation" keywords. Win on "AI agent development services" where businesses need implementation expertise, not just another tool.

package/skills/ai-cold-email-intelligence/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: ai-cold-email-intelligence
+description: "David Yu style AI Cold Email System. Implements the 6-phase high-reply workflow."
+metadata:
+  version: 1.0.0
+---
+
+# AI Cold Email Intelligence (David Yu System)
+
+This skill transforms cold outreach from "spam" to "peer-to-peer recommendation" by hitting customer pain points extracted from real reviews.
+
+## Commands
+
+`Skill: ai-cold-email-intelligence --brand {brand} --task gathering --query "HVAC in Austin"`
+`Skill: ai-cold-email-intelligence --brand {brand} --task research --domain "company.com"`
+`Skill: ai-cold-email-intelligence --brand {brand} --task draft --lead-info {json}`
+`Skill: ai-cold-email-intelligence --brand {brand} --task review --draft-file {path}`
+
+## 6-Phase Workflow
+
+### Phase 1: Strategic Gathering
+Use the Google Maps scraper to find local targets or Apollo for SaaS.
+```bash
+node scripts/research/google-maps-leads.js --query "{query}" --brand {brand}
+```
+
+### Phase 2: Mandatory Verification
+(Manual/Million Verifier) Ensure CSV is cleaned before importing to Phase 3.
+
+### Phase 3: Categorization
+Use `@lead-categorizer` (internal prompt) to bucket leads by specific sub-niche.
+
+### Phase 4: Deep Pain-Point Research
+Scrape 1-3 star reviews for the prospect's domain.
+```bash
+node scripts/research/deep-review-scraper.js --domain "{domain}" --brand {brand}
+```
+
+### Phase 5: Hyper-Personalized Drafting
+Use the `cold-email` skill but anchor the opener specifically on the results from Phase 4.
+**Rule**: If the customer complained about "late shipping," the opener MUST offer "shipping automation."
+**Awareness Gate:** Cold outreach targets problem-aware or solution-aware prospects. Use the advertorial funnel approach (validate → cause → mechanism → product) from `references/awareness-level-guide.md`. Never lead with a product pitch.
+
+### Phase 6: Evergreen Feedback Loop
+1. Draft generated.
+2. `@cold-email-critic` grades it.
+3. If fail: Critique is applied, draft rewritten.
+4. Mistakes are logged to `businesses/{business}/evergreen.mdcold-email/evergreen-mistakes.md`.
+
+## Integration with existing Cold-Email Skill
+When using the core `cold-email` skill, ALWAYS pass the `pain-points.json` as a primary research signal.
+
+## References
+- `evergreen-mistakes.md`: Persistent log of banned patterns (AI jargon, em-dashes).

package/skills/ai-cold-email-intelligence/references/prompts.md

@@ -0,0 +1,21 @@
+# David Yu Cold Email Prompts & Frameworks
+
+## The "Nerve" Opener (Phase 5)
+"Saw the reviews on [Site] about [Functional Frustration]. I might have a fix for [Problem]."
+
+**Example**:
+"Saw the Trustpilot reviews about shipping delays at [Company]. I've helped [Competitor] automate their warehouse tracking so that never happens. Worth a quick look?"
+
+## The "Peer-to-Peer" Rule
+Write like you're texting a smart colleague. 
+- No "Hope you're well"
+- No "Best-in-class"
+- Use "fix," "problem," "help," "look," "quick."
+
+## The "Yu" Grading Prompt
+"Grade this email from 0-100 based on the David Yu System. 
+A 100/100 email:
+1. Mentions a specific customer complaint found in research.
+2. Is under 40 words.
+3. Has no AI jargon (leverage, synergy, em-dashes).
+4. Asks for 'interest' (curious? worth a look?) not 'time' (30 minutes?)."