claude-flow-novice 2.10.4 → 2.10.6

package/claude-assets/skills/cfn-marketing-email-campaigns/operations/list-templates.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+set -euo pipefail
+
+# List available email templates via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+CATEGORY=""
+LIMIT="50"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --category)
+      CATEGORY="$2"
+      shift 2
+      ;;
+    --limit)
+      LIMIT="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+PAYLOAD=$(jq -n \
+  --arg category "$CATEGORY" \
+  --argjson limit "$LIMIT" \
+  '{
+    category: $category,
+    limit: $limit
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/email/list-templates" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/skills/cfn-marketing-email-campaigns/operations/schedule-campaign.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+set -euo pipefail
+
+# Schedule email campaign delivery via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+CAMPAIGN_ID=""
+SCHEDULE_TIME=""
+TIMEZONE="UTC"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --schedule-time)
+      SCHEDULE_TIME="$2"
+      shift 2
+      ;;
+    --timezone)
+      TIMEZONE="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$CAMPAIGN_ID" ]]; then
+  echo "Error: --campaign-id is required" >&2
+  exit 1
+fi
+
+if [[ -z "$SCHEDULE_TIME" ]]; then
+  echo "Error: --schedule-time is required" >&2
+  exit 1
+fi
+
+PAYLOAD=$(jq -n \
+  --arg campaignId "$CAMPAIGN_ID" \
+  --arg scheduleTime "$SCHEDULE_TIME" \
+  --arg timezone "$TIMEZONE" \
+  '{
+    campaignId: $campaignId,
+    scheduleTime: $scheduleTime,
+    timezone: $timezone
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/email/schedule-campaign" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/skills/cfn-marketing-email-campaigns/operations/send-test-email.sh

@@ -0,0 +1,81 @@
+#!/bin/bash
+set -euo pipefail
+
+# Send test email for campaign via n8n workflow
+
+if [[ -f .env ]]; then
+  source .env
+fi
+
+N8N_BASE_URL="${N8N_BASE_URL:-http://localhost:5678}"
+N8N_API_KEY="${N8N_API_KEY:-}"
+
+CAMPAIGN_ID=""
+RECIPIENTS=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --campaign-id)
+      CAMPAIGN_ID="$2"
+      shift 2
+      ;;
+    --recipients)
+      RECIPIENTS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown parameter: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$CAMPAIGN_ID" ]]; then
+  echo "Error: --campaign-id is required" >&2
+  exit 1
+fi
+
+if [[ -z "$RECIPIENTS" ]]; then
+  echo "Error: --recipients is required" >&2
+  exit 1
+fi
+
+# Convert comma-separated recipients to JSON array
+RECIPIENTS_ARRAY=$(echo "$RECIPIENTS" | jq -R 'split(",")')
+
+PAYLOAD=$(jq -n \
+  --arg campaignId "$CAMPAIGN_ID" \
+  --argjson recipients "$RECIPIENTS_ARRAY" \
+  '{
+    campaignId: $campaignId,
+    recipients: $recipients
+  }')
+
+RESPONSE=$(curl -s -w "\n%{http_code}" \
+  -X POST \
+  -H "Content-Type: application/json" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -d "$PAYLOAD" \
+  "${N8N_BASE_URL}/webhook/marketing/email/send-test" || echo -e "\n000")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" == "000" ]]; then
+  echo '{"success":false,"message":"Network error: Unable to connect to n8n"}' >&2
+  exit 2
+elif [[ "$HTTP_CODE" == "401" ]] || [[ "$HTTP_CODE" == "403" ]]; then
+  echo '{"success":false,"message":"Authentication error: Invalid API key"}' >&2
+  exit 3
+elif [[ ! "$HTTP_CODE" =~ ^2 ]]; then
+  echo "{\"success\":false,\"message\":\"API error: HTTP $HTTP_CODE\",\"response\":$BODY}" >&2
+  exit 2
+fi
+
+if echo "$BODY" | jq -e '.success' >/dev/null 2>&1; then
+  echo "$BODY"
+  exit 0
+else
+  echo '{"success":false,"message":"Invalid response format from n8n"}' >&2
+  exit 2
+fi

package/claude-assets/skills/cfn-marketing-landing-pages/SKILL.md

@@ -0,0 +1,366 @@
+# CFN Marketing Landing Pages
+
+**Version:** 1.0.0
+**Status:** Production
+**Phase:** 4 - Intelligence & Optimization
+
+## Overview
+
+Landing page management and A/B testing skill for creating, publishing, and optimizing landing pages. Implements statistical significance testing with minimum sample sizes and confidence levels to ensure valid test results.
+
+## A/B Testing Framework
+
+**Statistical Requirements:**
+- Minimum sample size: 100 conversions per variant
+- Confidence level: 95% (p-value < 0.05)
+- Minimum test duration: 7 days
+- Validation enforced in create-ab-test.sh before launch
+
+**Test Lifecycle:**
+1. Create landing page from template
+2. Set up A/B test (Variant A vs B)
+3. Collect traffic and conversions (min 7 days)
+4. Validate statistical significance
+5. Declare winner and implement changes
+
+## Operations
+
+### 1. Create Landing Page
+
+**Script:** `operations/create-landing-page.sh`
+
+**Description:** Create new landing page from template with customization options
+
+**Parameters:**
+- `--page-name` (required): Landing page name (alphanumeric, hyphens)
+- `--template` (required): Template ID (product,lead-gen,webinar,ebook,demo)
+- `--headline` (required): Main headline text
+- `--cta-text` (required): Call-to-action button text
+- `--cta-url` (required): CTA destination URL
+- `--description` (optional): Page description
+- `--image-url` (optional): Hero image URL
+
+**Example:**
+```bash
+./operations/create-landing-page.sh \
+  --page-name "summer-sale-2025" \
+  --template "product" \
+  --headline "50% Off Summer Sale" \
+  --cta-text "Shop Now" \
+  --cta-url "https://example.com/checkout" \
+  --description "Limited time offer on all products"
+```
+
+**Response:**
+```json
+{
+  "page_id": "lp_1698765432",
+  "page_name": "summer-sale-2025",
+  "status": "draft",
+  "template": "product",
+  "url": "https://pages.example.com/summer-sale-2025",
+  "preview_url": "https://pages.example.com/preview/summer-sale-2025",
+  "created_at": "2025-10-29T12:00:00Z"
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (invalid template, page name format)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+### 2. Create A/B Test
+
+**Script:** `operations/create-ab-test.sh`
+
+**Description:** Set up A/B test with statistical validation requirements
+
+**Parameters:**
+- `--page-id` (required): Landing page ID
+- `--variant-a-name` (required): Name for Variant A (control)
+- `--variant-b-name` (required): Name for Variant B (treatment)
+- `--variant-b-changes` (required): JSON describing changes (headline, cta, image)
+- `--traffic-split` (optional): Traffic split percentage (default: 50/50)
+- `--goal-metric` (required): Conversion goal (form_submit,purchase,signup,download)
+
+**Example:**
+```bash
+./operations/create-ab-test.sh \
+  --page-id "lp_1698765432" \
+  --variant-a-name "Original" \
+  --variant-b-name "New Headline" \
+  --variant-b-changes '{"headline":"New Compelling Headline","cta_text":"Get Started Free"}' \
+  --traffic-split "50/50" \
+  --goal-metric "form_submit"
+```
+
+**Response:**
+```json
+{
+  "test_id": "test_1698765555",
+  "page_id": "lp_1698765432",
+  "status": "active",
+  "variants": [
+    {
+      "variant_id": "var_a",
+      "name": "Original",
+      "traffic_percentage": 50,
+      "url": "https://pages.example.com/summer-sale-2025?variant=a"
+    },
+    {
+      "variant_id": "var_b",
+      "name": "New Headline",
+      "traffic_percentage": 50,
+      "url": "https://pages.example.com/summer-sale-2025?variant=b",
+      "changes": {
+        "headline": "New Compelling Headline",
+        "cta_text": "Get Started Free"
+      }
+    }
+  ],
+  "requirements": {
+    "min_conversions_per_variant": 100,
+    "min_duration_days": 7,
+    "confidence_level": 0.95
+  },
+  "goal_metric": "form_submit",
+  "started_at": "2025-10-29T12:00:00Z",
+  "earliest_conclusion_date": "2025-11-05T12:00:00Z"
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (invalid JSON, traffic split != 100)
+- `2`: API error
+- `3`: Validation error (page not found, test already exists)
+
+---
+
+### 3. Publish Page
+
+**Script:** `operations/publish-page.sh`
+
+**Description:** Publish landing page to production (makes page live)
+
+**Parameters:**
+- `--page-id` (required): Landing page ID
+- `--custom-domain` (optional): Custom domain (e.g., promo.example.com)
+
+**Example:**
+```bash
+./operations/publish-page.sh \
+  --page-id "lp_1698765432" \
+  --custom-domain "promo.example.com"
+```
+
+**Response:**
+```json
+{
+  "page_id": "lp_1698765432",
+  "status": "published",
+  "url": "https://promo.example.com/summer-sale-2025",
+  "published_at": "2025-10-29T12:00:00Z"
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (page not in draft/unpublished state)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+### 4. Get Page Performance
+
+**Script:** `operations/get-page-performance.sh`
+
+**Description:** Get conversion metrics and A/B test results with statistical significance
+
+**Parameters:**
+- `--page-id` (required): Landing page ID
+- `--date-from` (optional): Start date (YYYY-MM-DD). Default: 30 days ago
+- `--date-to` (optional): End date (YYYY-MM-DD). Default: today
+
+**Example:**
+```bash
+./operations/get-page-performance.sh \
+  --page-id "lp_1698765432" \
+  --date-from "2025-10-01"
+```
+
+**Response:**
+```json
+{
+  "page_id": "lp_1698765432",
+  "page_name": "summer-sale-2025",
+  "status": "published",
+  "date_range": {
+    "from": "2025-10-01",
+    "to": "2025-10-29"
+  },
+  "performance": {
+    "visits": 5432,
+    "conversions": 487,
+    "conversion_rate": 0.0897,
+    "bounce_rate": 0.32,
+    "avg_time_on_page": 145
+  },
+  "ab_test": {
+    "test_id": "test_1698765555",
+    "status": "complete",
+    "duration_days": 14,
+    "variants": [
+      {
+        "variant_id": "var_a",
+        "name": "Original",
+        "visits": 2716,
+        "conversions": 217,
+        "conversion_rate": 0.0799
+      },
+      {
+        "variant_id": "var_b",
+        "name": "New Headline",
+        "visits": 2716,
+        "conversions": 270,
+        "conversion_rate": 0.0994,
+        "improvement": "+24.4%"
+      }
+    ],
+    "statistical_significance": {
+      "is_significant": true,
+      "p_value": 0.0023,
+      "confidence_level": 0.9977,
+      "winner": "var_b"
+    },
+    "recommendation": "Implement Variant B (New Headline) - statistically significant improvement"
+  }
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (invalid date format)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+### 5. Unpublish Page
+
+**Script:** `operations/unpublish-page.sh`
+
+**Description:** Take landing page offline (returns to draft state)
+
+**Parameters:**
+- `--page-id` (required): Landing page ID
+- `--reason` (optional): Reason for unpublishing
+
+**Example:**
+```bash
+./operations/unpublish-page.sh \
+  --page-id "lp_1698765432" \
+  --reason "Campaign ended"
+```
+
+**Response:**
+```json
+{
+  "page_id": "lp_1698765432",
+  "status": "unpublished",
+  "reason": "Campaign ended",
+  "unpublished_at": "2025-10-29T12:00:00Z",
+  "previous_url": "https://promo.example.com/summer-sale-2025"
+}
+```
+
+**Exit Codes:**
+- `0`: Success
+- `1`: Invalid parameters (page not published)
+- `2`: API error
+- `3`: Validation error
+
+---
+
+## Environment Variables
+
+- `N8N_BASE_URL`: Base URL for n8n instance (e.g., https://n8n.dailyautomations.com)
+- `N8N_API_KEY`: API key for authentication
+
+## Error Handling
+
+All operations return structured JSON error responses:
+
+```json
+{
+  "error": "Description of error",
+  "code": "ERROR_CODE",
+  "details": {}
+}
+```
+
+## Integration Pattern
+
+Each operation calls n8n webhook:
+
+```bash
+curl -X POST "$N8N_BASE_URL/webhook/landing-pages-{operation}" \
+  -H "X-N8N-API-KEY: $N8N_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d "$PAYLOAD"
+```
+
+## Statistical Significance Calculation
+
+A/B test results are considered statistically significant when:
+1. Both variants have ≥100 conversions
+2. Test has run for ≥7 days
+3. P-value < 0.05 (95% confidence)
+
+Formula used: Two-proportion Z-test
+
+## Dependencies
+
+- bash ≥4.0
+- jq (JSON processing)
+- curl (HTTP requests)
+- bc (numeric validation)
+
+## Usage in Workflows
+
+```bash
+# Create and publish landing page
+PAGE_ID=$(./.claude/skills/cfn-marketing-landing-pages/operations/create-landing-page.sh \
+  --page-name "q4-promo" \
+  --template "product" \
+  --headline "Limited Time Offer" \
+  --cta-text "Buy Now" \
+  --cta-url "https://example.com/checkout" | jq -r '.page_id')
+
+./.claude/skills/cfn-marketing-landing-pages/operations/publish-page.sh \
+  --page-id "$PAGE_ID"
+
+# Set up A/B test
+./.claude/skills/cfn-marketing-landing-pages/operations/create-ab-test.sh \
+  --page-id "$PAGE_ID" \
+  --variant-a-name "Control" \
+  --variant-b-name "Test" \
+  --variant-b-changes '{"headline":"New Headline"}' \
+  --goal-metric "purchase"
+
+# Check results after 7+ days
+./.claude/skills/cfn-marketing-landing-pages/operations/get-page-performance.sh \
+  --page-id "$PAGE_ID"
+```
+
+## Best Practices
+
+1. **Always run A/B tests for minimum 7 days** to account for day-of-week variations
+2. **Test one element at a time** (headline OR CTA, not both) for clear attribution
+3. **Validate statistical significance** before declaring winners
+4. **Archive completed tests** and document learnings
+5. **Use custom domains** for brand consistency