@nguyenphp/antigravity-marketing 1.0.0

package/templates/.agent/skills/conversion-optimization/SKILL.md

@@ -0,0 +1,243 @@
+---
+name: conversion-optimization
+description: CRO principles, A/B testing, landing page optimization, and user experience improvements.
+allowed-tools: Read, Glob, Grep
+---
+
+# Conversion Optimization
+
+> Systematically improve conversion rates through testing and optimization.
+
+---
+
+## 1. CRO Framework
+
+| Phase | Activities | Output |
+|-------|------------|--------|
+| **Research** | Analytics, heatmaps, surveys | Insights |
+| **Hypothesis** | Identify opportunities | Test ideas |
+| **Prioritize** | ICE/PIE scoring | Roadmap |
+| **Test** | A/B, multivariate | Data |
+| **Analyze** | Statistical analysis | Learnings |
+| **Implement** | Roll out winners | Improvements |
+
+---
+
+## 2. Conversion Research
+
+### Quantitative Research
+
+| Method | Reveals |
+|--------|---------|
+| **Analytics** | Where users drop off |
+| **Funnel analysis** | Conversion blockers |
+| **Heatmaps** | Click/scroll patterns |
+| **Session recordings** | User behavior |
+| **Form analytics** | Field-level drop-off |
+
+### Qualitative Research
+
+| Method | Reveals |
+|--------|---------|
+| **User surveys** | Motivations, concerns |
+| **Exit surveys** | Why they left |
+| **User interviews** | Deep insights |
+| **Usability tests** | Friction points |
+| **Customer support** | Common objections |
+
+---
+
+## 3. Landing Page Optimization
+
+### Above the Fold Essentials
+
+| Element | Best Practice |
+|---------|---------------|
+| **Headline** | Clear value proposition |
+| **Subheadline** | Supporting benefit |
+| **Hero image/video** | Relevant, emotional |
+| **CTA** | Visible, action-oriented |
+| **Trust signals** | Logos, security badges |
+
+### Page Structure
+
+| Section | Purpose |
+|---------|---------|
+| **Hero** | Capture attention |
+| **Benefits** | Why it matters |
+| **Features** | What you get |
+| **Social proof** | Why trust us |
+| **FAQ** | Overcome objections |
+| **CTA** | Convert |
+
+### Landing Page Checklist
+
+| Element | Check |
+|---------|-------|
+| Single focus | One goal per page |
+| Clear headline | Value in 5 seconds |
+| Benefit-driven | Not feature-focused |
+| Strong CTA | Action verb, contrast color |
+| Social proof | Testimonials, logos |
+| Trust signals | Security, guarantees |
+| Mobile-optimized | Responsive, fast |
+| Minimal navigation | Reduce distractions |
+
+---
+
+## 4. CTA Optimization
+
+### CTA Button Best Practices
+
+| Element | Best Practice |
+|---------|---------------|
+| **Color** | Contrast with page |
+| **Size** | Large enough to tap (44px+) |
+| **Copy** | Action verb + value |
+| **Position** | Above fold, after key info |
+| **Whitespace** | Breathing room around |
+
+### CTA Copy Formulas
+
+| Formula | Example |
+|---------|---------|
+| **Action + Benefit** | "Get My Free Guide" |
+| **Action + Urgency** | "Claim Your Spot Now" |
+| **First person** | "Start My Free Trial" |
+| **Specific** | "Download the 10-Step Checklist" |
+
+---
+
+## 5. Form Optimization
+
+### Form Best Practices
+
+| Principle | Implementation |
+|-----------|----------------|
+| **Fewer fields** | Only ask what's necessary |
+| **Smart defaults** | Pre-fill when possible |
+| **Inline validation** | Real-time feedback |
+| **Clear labels** | Above field, not inside |
+| **Progress indication** | For multi-step |
+| **Mobile-friendly** | Proper input types |
+
+### Field Priority
+
+| Essential | Nice to Have | Remove |
+|-----------|--------------|--------|
+| Email | Company | Fax |
+| Name | Phone | Title |
+| Password | Industry | Address |
+
+---
+
+## 6. A/B Testing
+
+### What to Test (Priority Order)
+
+| Priority | Element |
+|----------|---------|
+| **High** | Headlines, CTAs, offers |
+| **Medium** | Images, layout, copy |
+| **Low** | Colors, button size |
+
+### Test Requirements
+
+| Factor | Minimum |
+|--------|---------|
+| **Sample size** | Statistical significance |
+| **Duration** | 1-2 full business cycles |
+| **Visitors/variation** | 100+ conversions each |
+
+### Statistical Significance
+
+| Confidence | P-value | Use |
+|------------|---------|-----|
+| 95% | < 0.05 | Standard |
+| 99% | < 0.01 | High stakes |
+| 90% | < 0.10 | Early indicators |
+
+---
+
+## 7. Prioritization Frameworks
+
+### ICE Score
+
+| Factor | Question | Score 1-10 |
+|--------|----------|------------|
+| **Impact** | How much will it move the needle? | |
+| **Confidence** | How sure are we it'll work? | |
+| **Ease** | How easy to implement? | |
+
+### PIE Framework
+
+| Factor | Question |
+|--------|----------|
+| **Potential** | How much improvement possible? |
+| **Importance** | How valuable is this page? |
+| **Ease** | How hard to test? |
+
+---
+
+## 8. Psychological Triggers
+
+### Persuasion Principles
+
+| Principle | Application |
+|-----------|-------------|
+| **Scarcity** | Limited time/quantity |
+| **Social proof** | Testimonials, numbers |
+| **Authority** | Expert endorsements |
+| **Reciprocity** | Free value first |
+| **Commitment** | Small yeses before big |
+| **Liking** | Relatable brand |
+
+### Cognitive Biases
+
+| Bias | How to Use |
+|------|------------|
+| **Anchoring** | Show original price |
+| **Loss aversion** | Frame as avoiding loss |
+| **Bandwagon** | "Join 10,000+ customers" |
+| **Default** | Pre-select recommended |
+
+---
+
+## 9. Page Speed Impact
+
+### Speed Benchmarks
+
+| Load Time | Bounce Impact |
+|-----------|---------------|
+| 1-3 seconds | Baseline |
+| 3-5 seconds | +32% bounce |
+| 5-10 seconds | +90% bounce |
+| 10+ seconds | +123% bounce |
+
+### Speed Optimization
+
+| Action | Impact |
+|--------|--------|
+| **Compress images** | High |
+| **Lazy loading** | Medium |
+| **Minify CSS/JS** | Medium |
+| **CDN** | High |
+| **Caching** | High |
+
+---
+
+## 10. CRO Tools
+
+| Tool | Purpose |
+|------|---------|
+| **Google Optimize** | A/B testing (free) |
+| **Optimizely** | A/B testing (enterprise) |
+| **VWO** | A/B testing + insights |
+| **Hotjar** | Heatmaps, recordings |
+| **Crazy Egg** | Visual analytics |
+| **Unbounce** | Landing page builder |
+| **Typeform** | Form optimization |
+
+---
+
+> **Remember:** CRO is a process, not a project. Continuous testing and iteration beats one-time optimization.

package/templates/.agent/skills/documentation-templates/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: documentation-templates
+description: Documentation templates and structure guidelines. README, API docs, code comments, and AI-friendly documentation.
+allowed-tools: Read, Glob, Grep
+---
+
+# Documentation Templates
+
+> Templates and structure guidelines for common documentation types.
+
+---
+
+## 1. README Structure
+
+### Essential Sections (Priority Order)
+
+| Section | Purpose |
+|---------|---------|
+| **Title + One-liner** | What is this? |
+| **Quick Start** | Running in <5 min |
+| **Features** | What can I do? |
+| **Configuration** | How to customize |
+| **API Reference** | Link to detailed docs |
+| **Contributing** | How to help |
+| **License** | Legal |
+
+### README Template
+
+```markdown
+# Project Name
+
+Brief one-line description.
+
+## Quick Start
+
+[Minimum steps to run]
+
+## Features
+
+- Feature 1
+- Feature 2
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| PORT | Server port | 3000 |
+
+## Documentation
+
+- [API Reference](./docs/api.md)
+- [Architecture](./docs/architecture.md)
+
+## License
+
+MIT
+```
+
+---
+
+## 2. API Documentation Structure
+
+### Per-Endpoint Template
+
+```markdown
+## GET /users/:id
+
+Get a user by ID.
+
+**Parameters:**
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| id | string | Yes | User ID |
+
+**Response:**
+- 200: User object
+- 404: User not found
+
+**Example:**
+[Request and response example]
+```
+
+---
+
+## 3. Code Comment Guidelines
+
+### JSDoc/TSDoc Template
+
+```typescript
+/**
+ * Brief description of what the function does.
+ * 
+ * @param paramName - Description of parameter
+ * @returns Description of return value
+ * @throws ErrorType - When this error occurs
+ * 
+ * @example
+ * const result = functionName(input);
+ */
+```
+
+### When to Comment
+
+| ✅ Comment | ❌ Don't Comment |
+|-----------|-----------------|
+| Why (business logic) | What (obvious) |
+| Complex algorithms | Every line |
+| Non-obvious behavior | Self-explanatory code |
+| API contracts | Implementation details |
+
+---
+
+## 4. Changelog Template (Keep a Changelog)
+
+```markdown
+# Changelog
+
+## [Unreleased]
+### Added
+- New feature
+
+## [1.0.0] - 2025-01-01
+### Added
+- Initial release
+### Changed
+- Updated dependency
+### Fixed
+- Bug fix
+```
+
+---
+
+## 5. Architecture Decision Record (ADR)
+
+```markdown
+# ADR-001: [Title]
+
+## Status
+Accepted / Deprecated / Superseded
+
+## Context
+Why are we making this decision?
+
+## Decision
+What did we decide?
+
+## Consequences
+What are the trade-offs?
+```
+
+---
+
+## 6. AI-Friendly Documentation (2025)
+
+### llms.txt Template
+
+For AI crawlers and agents:
+
+```markdown
+# Project Name
+> One-line objective.
+
+## Core Files
+- [src/index.ts]: Main entry
+- [src/api/]: API routes
+- [docs/]: Documentation
+
+## Key Concepts
+- Concept 1: Brief explanation
+- Concept 2: Brief explanation
+```
+
+### MCP-Ready Documentation
+
+For RAG indexing:
+- Clear H1-H3 hierarchy
+- JSON/YAML examples for data structures
+- Mermaid diagrams for flows
+- Self-contained sections
+
+---
+
+## 7. Structure Principles
+
+| Principle | Why |
+|-----------|-----|
+| **Scannable** | Headers, lists, tables |
+| **Examples first** | Show, don't just tell |
+| **Progressive detail** | Simple → Complex |
+| **Up to date** | Outdated = misleading |
+
+---
+
+> **Remember:** Templates are starting points. Adapt to your project's needs.

package/templates/.agent/skills/email-marketing/SKILL.md

@@ -0,0 +1,241 @@
+---
+name: email-marketing
+description: Email marketing campaigns, automation sequences, newsletter optimization, and deliverability best practices.
+allowed-tools: Read, Glob, Grep
+---
+
+# Email Marketing
+
+> Master email marketing for nurturing leads and driving conversions.
+
+---
+
+## 1. Email Types Matrix
+
+| Type | Purpose | Frequency | Key Metric |
+|------|---------|-----------|------------|
+| **Newsletter** | Nurture, value | Weekly/Bi-weekly | Open rate |
+| **Promotional** | Sales, offers | As needed | CTR, conversions |
+| **Transactional** | Confirm, update | Triggered | Delivery rate |
+| **Welcome series** | Onboard | Automated | Completion rate |
+| **Re-engagement** | Win back | Triggered | Reactivation rate |
+| **Abandoned cart** | Recover sales | Triggered | Recovery rate |
+
+---
+
+## 2. Email Structure
+
+### Anatomy of High-Converting Email
+
+| Element | Best Practice |
+|---------|---------------|
+| **Subject line** | 6-10 words, curiosity/benefit |
+| **Preview text** | Complement subject, 40-90 chars |
+| **Header** | Logo, navigation links |
+| **Hero** | Strong visual, headline |
+| **Body** | Scannable, benefit-focused |
+| **CTA** | Clear, action-oriented, above fold |
+| **Footer** | Unsubscribe, address, social |
+
+---
+
+## 3. Subject Line Formulas
+
+| Formula | Example |
+|---------|---------|
+| **Question** | "Ready to double your traffic?" |
+| **How-to** | "How to write emails that convert" |
+| **Number** | "7 mistakes killing your conversions" |
+| **Urgency** | "Last chance: 50% off ends tonight" |
+| **Curiosity** | "The secret top marketers don't share" |
+| **Personal** | "{{FirstName}}, your custom report is ready" |
+| **FOMO** | "Everyone's talking about this..." |
+
+### Subject Line Rules
+
+| Do ✅ | Don't ❌ |
+|-------|----------|
+| Keep 6-10 words | ALL CAPS |
+| Use power words | Spam triggers (FREE!!!) |
+| A/B test always | Misleading promises |
+| Match content | Multiple punctuation!!! |
+| Personalize | Start with "Newsletter" |
+
+---
+
+## 4. Email Automation Sequences
+
+### Welcome Series (5-7 emails)
+
+| Email # | Timing | Content |
+|---------|--------|---------|
+| 1 | Immediate | Welcome, deliver promise |
+| 2 | Day 2 | Best content/resource |
+| 3 | Day 4 | Your story, mission |
+| 4 | Day 6 | Social proof, testimonials |
+| 5 | Day 8 | First offer |
+| 6 | Day 10 | Reminder/scarcity |
+| 7 | Day 14 | Transition to regular |
+
+### Abandoned Cart (3-4 emails)
+
+| Email # | Timing | Content |
+|---------|--------|---------|
+| 1 | 1 hour | Reminder, cart items |
+| 2 | 24 hours | Benefits, overcome objections |
+| 3 | 48 hours | Urgency, limited time |
+| 4 | 72 hours | Final offer/discount |
+
+### Re-engagement (3-5 emails)
+
+| Email # | Timing | Content |
+|---------|--------|---------|
+| 1 | Day 1 | "We miss you" |
+| 2 | Day 4 | Best content recap |
+| 3 | Day 7 | Special offer |
+| 4 | Day 10 | Last chance warning |
+| 5 | Day 14 | Remove if no response |
+
+---
+
+## 5. Segmentation Strategies
+
+### Segmentation Criteria
+
+| Criteria | Examples |
+|----------|----------|
+| **Demographic** | Age, location, industry |
+| **Behavioral** | Opens, clicks, purchases |
+| **Engagement** | Active, dormant, new |
+| **Lifecycle** | Lead, customer, VIP |
+| **Preference** | Content type, frequency |
+
+### Common Segments
+
+| Segment | Criteria | Strategy |
+|---------|----------|----------|
+| **New subscribers** | < 30 days | Welcome, educate |
+| **Engaged** | Opens > 50% | Premium content |
+| **At-risk** | No opens 60 days | Re-engagement |
+| **Buyers** | Has purchased | Upsell, loyalty |
+| **VIP** | High LTV | Exclusive offers |
+
+---
+
+## 6. Deliverability Best Practices
+
+### Technical Setup
+
+| Element | Purpose |
+|---------|---------|
+| **SPF** | Authorize sending servers |
+| **DKIM** | Verify email authenticity |
+| **DMARC** | Prevent spoofing |
+| **Dedicated IP** | Reputation control (high volume) |
+
+### List Hygiene
+
+| Practice | Frequency |
+|----------|-----------|
+| **Remove bounces** | Automatic |
+| **Clean inactive** | Quarterly |
+| **Verify new emails** | On signup |
+| **Monitor complaints** | Weekly |
+
+### Avoid Spam Filters
+
+| Do ✅ | Don't ❌ |
+|-------|----------|
+| Authenticate domain | Buy email lists |
+| Clean list regularly | Use spam trigger words |
+| Honor unsubscribes | Hide unsubscribe link |
+| Balance text/images | Image-only emails |
+| Test before sending | Ignore bounce rates |
+
+---
+
+## 7. Email Metrics
+
+### Key Metrics
+
+| Metric | Benchmark | Formula |
+|--------|-----------|---------|
+| **Open rate** | 20-25% | Opens / Delivered × 100 |
+| **CTR** | 2-5% | Clicks / Delivered × 100 |
+| **CTOR** | 10-15% | Clicks / Opens × 100 |
+| **Conversion rate** | 1-5% | Conversions / Clicks × 100 |
+| **Bounce rate** | < 2% | Bounces / Sent × 100 |
+| **Unsubscribe rate** | < 0.5% | Unsubs / Delivered × 100 |
+
+### Health Indicators
+
+| Metric | Healthy | Warning | Critical |
+|--------|---------|---------|----------|
+| **Open rate** | > 20% | 15-20% | < 15% |
+| **Bounce rate** | < 2% | 2-5% | > 5% |
+| **Spam complaints** | < 0.1% | 0.1-0.3% | > 0.3% |
+| **Unsubscribe** | < 0.5% | 0.5-1% | > 1% |
+
+---
+
+## 8. A/B Testing
+
+### What to Test
+
+| Element | Priority |
+|---------|----------|
+| **Subject line** | High |
+| **Send time** | High |
+| **CTA button** | High |
+| **From name** | Medium |
+| **Preview text** | Medium |
+| **Email length** | Medium |
+| **Images** | Low |
+
+### Testing Rules
+
+| Rule | Reason |
+|------|--------|
+| Test one variable | Clear results |
+| Min sample 1000 | Statistical significance |
+| Run 2-4 hours | Capture behavior |
+| Document results | Build knowledge base |
+
+---
+
+## 9. Email Design
+
+### Mobile Optimization
+
+| Element | Best Practice |
+|---------|---------------|
+| **Width** | 600px max |
+| **Font size** | 16px+ body, 22px+ headers |
+| **CTA buttons** | 44px+ height, thumb-friendly |
+| **Images** | Alt text, max-width: 100% |
+| **Single column** | Easy to scan |
+
+### Dark Mode
+
+| Consideration | Solution |
+|---------------|----------|
+| **Logo** | Transparent PNG or dark version |
+| **Images** | Add white border/background |
+| **Colors** | Test contrast in both modes |
+
+---
+
+## 10. Email Tools
+
+| Tool | Best For | Pricing Model |
+|------|----------|---------------|
+| **Mailchimp** | SMB, beginners | Contact-based |
+| **Klaviyo** | E-commerce | Contact-based |
+| **ConvertKit** | Creators | Subscriber-based |
+| **ActiveCampaign** | Automation | Contact-based |
+| **Brevo** | Transactional | Email volume |
+| **Beehiiv** | Newsletters | Subscriber-based |
+
+---
+
+> **Remember:** Email is permission-based. Respect your subscribers, provide value, and they'll reward you with loyalty.