claude-flow-novice 2.10.5 → 2.10.7

package/claude-assets/skills/cfn-marketing-media-outreach/SKILL.md

@@ -0,0 +1,168 @@
+# Media Outreach Skill
+
+## Overview
+Manage journalist outreach, media pitching, and HARO (Help A Reporter Out) response automation. Find relevant journalists and track pitch engagement.
+
+## Operations
+
+### 1. search-journalists.sh
+Search for journalists by beat, outlet, or topic using Muck Rack.
+
+**Parameters**:
+- `--beat` (optional): Journalist beat (tech/business/healthcare/finance)
+- `--outlet` (optional): Media outlet name
+- `--topic` (optional): Topic keyword
+- `--limit` (optional): Result limit (default: 20)
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-media-outreach/operations/search-journalists.sh \
+  --beat "tech" \
+  --topic "AI automation" \
+  --limit 10
+```
+
+**Response**:
+```json
+{
+  "journalists": [
+    {
+      "id": "jour_123",
+      "name": "John Smith",
+      "outlet": "TechCrunch",
+      "beat": "tech",
+      "email": "john@techcrunch.com",
+      "twitter": "@johnsmith",
+      "recent_topics": ["AI", "automation", "SaaS"]
+    }
+  ],
+  "total_results": 45
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error
+
+---
+
+### 2. send-pitch.sh
+Send personalized pitch to journalist via Mailshake.
+
+**Parameters**:
+- `--journalist-id` (required): Journalist ID from search
+- `--subject` (required): Email subject line
+- `--body` (required): Pitch email body
+- `--follow-up-days` (optional): Days until follow-up (default: 3)
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-media-outreach/operations/send-pitch.sh \
+  --journalist-id "jour_123" \
+  --subject "AI Automation Platform Launch" \
+  --body "Hi John, I saw your recent piece on..." \
+  --follow-up-days 3
+```
+
+**Response**:
+```json
+{
+  "pitch_id": "pitch_abc123",
+  "journalist_id": "jour_123",
+  "status": "sent",
+  "sent_at": "2025-10-29T14:00:00Z",
+  "follow_up_scheduled": "2025-11-01T14:00:00Z"
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error
+- 3: Validation error
+
+---
+
+### 3. submit-haro-response.sh
+Submit response to HARO query.
+
+**Parameters**:
+- `--query-id` (required): HARO query ID
+- `--response` (required): Response text
+- `--expert-name` (required): Expert name for attribution
+- `--expert-title` (required): Expert title
+- `--company-name` (required): Company name
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-media-outreach/operations/submit-haro-response.sh \
+  --query-id "haro_xyz789" \
+  --response "As an AI automation expert..." \
+  --expert-name "Jane Doe" \
+  --expert-title "CTO" \
+  --company-name "Company Inc"
+```
+
+**Response**:
+```json
+{
+  "submission_id": "sub_123",
+  "query_id": "haro_xyz789",
+  "status": "submitted",
+  "submitted_at": "2025-10-29T14:00:00Z",
+  "response_deadline": "2025-10-29T17:00:00Z"
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error (missed deadline)
+- 3: Validation error
+
+**HARO Requirements**:
+- Response time: <2 hours from query publication
+- Query monitoring: 2-5 responses per day
+- Personalization: Match query to company expertise
+
+---
+
+### 4. track-pitch-engagement.sh
+Track pitch email engagement (opens, clicks, responses).
+
+**Parameters**:
+- `--pitch-id` (required): Pitch ID from send operation
+- `--include-follow-ups` (optional): Include follow-up metrics (true/false, default: true)
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-media-outreach/operations/track-pitch-engagement.sh \
+  --pitch-id "pitch_abc123"
+```
+
+**Response**:
+```json
+{
+  "pitch_id": "pitch_abc123",
+  "journalist_id": "jour_123",
+  "opens": 2,
+  "clicks": 1,
+  "replied": true,
+  "reply_received_at": "2025-10-30T09:15:00Z",
+  "follow_ups_sent": 1,
+  "last_activity": "2025-10-30T09:15:00Z"
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error
+
+## Environment Variables
+- `N8N_BASE_URL`: n8n instance URL
+- `N8N_API_KEY`: n8n API authentication key
+
+## Integration
+All operations use n8n webhooks for Muck Rack and Mailshake integration.

package/claude-assets/skills/cfn-marketing-media-outreach/operations/search-journalists.sh

@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# search-journalists.sh - Find journalists by beat, outlet, or topic
+
+BEAT=""
+OUTLET=""
+TOPIC=""
+LIMIT="20"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --beat)
+      BEAT="$2"
+      shift 2
+      ;;
+    --outlet)
+      OUTLET="$2"
+      shift 2
+      ;;
+    --topic)
+      TOPIC="$2"
+      shift 2
+      ;;
+    --limit)
+      LIMIT="$2"
+      shift 2
+      ;;
+    *)
+      echo "Error: Unknown parameter $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
+  exit 1
+fi
+
+# Build JSON payload
+JSON_PAYLOAD=$(jq -n \
+  --arg beat "$BEAT" \
+  --arg outlet "$OUTLET" \
+  --arg topic "$TOPIC" \
+  --arg limit "$LIMIT" \
+  '{
+    beat: $beat,
+    outlet: $outlet,
+    topic: $topic,
+    limit: ($limit | tonumber)
+  }')
+
+# Call n8n webhook
+RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
+  "${N8N_BASE_URL}/webhook/media-outreach-search" \
+  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d "$JSON_PAYLOAD")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
+  echo "$BODY"
+  exit 0
+elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
+  echo "Error: Invalid request - $BODY" >&2
+  exit 1
+else
+  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
+  exit 2
+fi

package/claude-assets/skills/cfn-marketing-media-outreach/operations/send-pitch.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# send-pitch.sh - Send personalized pitch to journalist via Mailshake
+
+JOURNALIST_ID=""
+SUBJECT=""
+BODY=""
+FOLLOW_UP_DAYS="3"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --journalist-id)
+      JOURNALIST_ID="$2"
+      shift 2
+      ;;
+    --subject)
+      SUBJECT="$2"
+      shift 2
+      ;;
+    --body)
+      BODY="$2"
+      shift 2
+      ;;
+    --follow-up-days)
+      FOLLOW_UP_DAYS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Error: Unknown parameter $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$JOURNALIST_ID" ]] || [[ -z "$SUBJECT" ]] || [[ -z "$BODY" ]]; then
+  echo "Error: --journalist-id, --subject, and --body are required" >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
+  exit 1
+fi
+
+# Build JSON payload
+JSON_PAYLOAD=$(jq -n \
+  --arg journalist_id "$JOURNALIST_ID" \
+  --arg subject "$SUBJECT" \
+  --arg body "$BODY" \
+  --arg follow_up_days "$FOLLOW_UP_DAYS" \
+  '{
+    journalist_id: $journalist_id,
+    subject: $subject,
+    body: $body,
+    follow_up_days: ($follow_up_days | tonumber)
+  }')
+
+# Call n8n webhook
+RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
+  "${N8N_BASE_URL}/webhook/media-outreach-pitch" \
+  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d "$JSON_PAYLOAD")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
+  echo "$BODY"
+  exit 0
+elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
+  echo "Error: Invalid request - $BODY" >&2
+  exit 3
+else
+  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
+  exit 2
+fi

package/claude-assets/skills/cfn-marketing-media-outreach/operations/submit-haro-response.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# submit-haro-response.sh - Submit response to HARO query
+
+QUERY_ID=""
+RESPONSE=""
+EXPERT_NAME=""
+EXPERT_TITLE=""
+COMPANY_NAME=""
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --query-id)
+      QUERY_ID="$2"
+      shift 2
+      ;;
+    --response)
+      RESPONSE="$2"
+      shift 2
+      ;;
+    --expert-name)
+      EXPERT_NAME="$2"
+      shift 2
+      ;;
+    --expert-title)
+      EXPERT_TITLE="$2"
+      shift 2
+      ;;
+    --company-name)
+      COMPANY_NAME="$2"
+      shift 2
+      ;;
+    *)
+      echo "Error: Unknown parameter $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$QUERY_ID" ]] || [[ -z "$RESPONSE" ]] || [[ -z "$EXPERT_NAME" ]] || \
+   [[ -z "$EXPERT_TITLE" ]] || [[ -z "$COMPANY_NAME" ]]; then
+  echo "Error: --query-id, --response, --expert-name, --expert-title, and --company-name are required" >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
+  exit 1
+fi
+
+# Build JSON payload
+JSON_PAYLOAD=$(jq -n \
+  --arg query_id "$QUERY_ID" \
+  --arg response "$RESPONSE" \
+  --arg expert_name "$EXPERT_NAME" \
+  --arg expert_title "$EXPERT_TITLE" \
+  --arg company_name "$COMPANY_NAME" \
+  '{
+    query_id: $query_id,
+    response: $response,
+    expert_name: $expert_name,
+    expert_title: $expert_title,
+    company_name: $company_name
+  }')
+
+# Call n8n webhook
+RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
+  "${N8N_BASE_URL}/webhook/media-outreach-haro" \
+  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d "$JSON_PAYLOAD")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
+  echo "$BODY"
+  exit 0
+elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
+  echo "Error: Invalid request or missed deadline - $BODY" >&2
+  exit 3
+else
+  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
+  exit 2
+fi

package/claude-assets/skills/cfn-marketing-media-outreach/operations/track-pitch-engagement.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# track-pitch-engagement.sh - Track pitch email engagement
+
+PITCH_ID=""
+INCLUDE_FOLLOW_UPS="true"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --pitch-id)
+      PITCH_ID="$2"
+      shift 2
+      ;;
+    --include-follow-ups)
+      INCLUDE_FOLLOW_UPS="$2"
+      shift 2
+      ;;
+    *)
+      echo "Error: Unknown parameter $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+# Validate required parameters
+if [[ -z "$PITCH_ID" ]]; then
+  echo "Error: --pitch-id is required" >&2
+  exit 1
+fi
+
+# Validate environment variables
+if [[ -z "${N8N_BASE_URL:-}" ]] || [[ -z "${N8N_API_KEY:-}" ]]; then
+  echo "Error: N8N_BASE_URL and N8N_API_KEY environment variables required" >&2
+  exit 1
+fi
+
+# Build JSON payload
+JSON_PAYLOAD=$(jq -n \
+  --arg pitch_id "$PITCH_ID" \
+  --argjson include_follow_ups "$([[ "$INCLUDE_FOLLOW_UPS" == "true" ]] && echo true || echo false)" \
+  '{
+    pitch_id: $pitch_id,
+    include_follow_ups: $include_follow_ups
+  }')
+
+# Call n8n webhook
+RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
+  "${N8N_BASE_URL}/webhook/media-outreach-engagement" \
+  -H "X-N8N-API-KEY: ${N8N_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d "$JSON_PAYLOAD")
+
+HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
+BODY=$(echo "$RESPONSE" | sed '$d')
+
+if [[ "$HTTP_CODE" -ge 200 ]] && [[ "$HTTP_CODE" -lt 300 ]]; then
+  echo "$BODY"
+  exit 0
+elif [[ "$HTTP_CODE" -ge 400 ]] && [[ "$HTTP_CODE" -lt 500 ]]; then
+  echo "Error: Invalid request - $BODY" >&2
+  exit 1
+else
+  echo "Error: API error (HTTP $HTTP_CODE) - $BODY" >&2
+  exit 2
+fi

package/claude-assets/skills/cfn-marketing-press-distribution/SKILL.md

@@ -0,0 +1,159 @@
+# Press Release Distribution Skill
+
+## Overview
+Manage press release distribution through PR Newswire, Business Wire, and other distribution services. Track pickup metrics and distribution status.
+
+## Operations
+
+### 1. distribute-press-release.sh
+Distribute press release through wire services.
+
+**Parameters**:
+- `--title` (required): Press release headline
+- `--body` (required): Full press release text
+- `--outlets` (required): Target outlets (national/regional/trade/tech)
+- `--embargo-date` (optional): Embargo date/time (ISO 8601)
+- `--contact-name` (optional): Media contact name
+- `--contact-email` (optional): Media contact email
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-press-distribution/operations/distribute-press-release.sh \
+  --title "Company Launches New Product" \
+  --body "Full release text..." \
+  --outlets "national,tech" \
+  --contact-name "Jane Doe" \
+  --contact-email "jane@company.com"
+```
+
+**Response**:
+```json
+{
+  "distribution_id": "pr_abc123",
+  "status": "scheduled",
+  "estimated_reach": 500000,
+  "distribution_time": "2025-10-29T14:00:00Z"
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error
+- 3: Validation error
+
+---
+
+### 2. get-distribution-status.sh
+Check press release distribution progress.
+
+**Parameters**:
+- `--distribution-id` (required): Distribution ID from distribute operation
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-press-distribution/operations/get-distribution-status.sh \
+  --distribution-id "pr_abc123"
+```
+
+**Response**:
+```json
+{
+  "distribution_id": "pr_abc123",
+  "status": "distributed",
+  "pickup_count": 45,
+  "top_outlets": ["TechCrunch", "Bloomberg", "Reuters"],
+  "distributed_at": "2025-10-29T14:00:00Z"
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error
+
+---
+
+### 3. get-pickup-metrics.sh
+Retrieve detailed pickup metrics for distributed release.
+
+**Parameters**:
+- `--distribution-id` (required): Distribution ID
+- `--timeframe` (optional): Metrics timeframe (24h/7d/30d, default: 7d)
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-press-distribution/operations/get-pickup-metrics.sh \
+  --distribution-id "pr_abc123" \
+  --timeframe "24h"
+```
+
+**Response**:
+```json
+{
+  "distribution_id": "pr_abc123",
+  "total_pickups": 67,
+  "estimated_reach": 2500000,
+  "outlets_by_type": {
+    "national": 12,
+    "regional": 23,
+    "trade": 18,
+    "online": 14
+  },
+  "top_outlets": [
+    {"name": "TechCrunch", "reach": 500000},
+    {"name": "Bloomberg", "reach": 800000}
+  ]
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error
+
+---
+
+### 4. list-templates.sh
+List available press release templates.
+
+**Parameters**:
+- `--category` (optional): Template category (product/funding/partnership/award)
+
+**Example**:
+```bash
+./.claude/skills/cfn-marketing-press-distribution/operations/list-templates.sh \
+  --category "product"
+```
+
+**Response**:
+```json
+{
+  "templates": [
+    {
+      "id": "tmpl_product_launch",
+      "name": "Product Launch Template",
+      "category": "product",
+      "sections": ["headline", "lead", "quote", "features", "availability", "boilerplate"]
+    },
+    {
+      "id": "tmpl_product_update",
+      "name": "Product Update Template",
+      "category": "product",
+      "sections": ["headline", "lead", "enhancements", "quote", "boilerplate"]
+    }
+  ]
+}
+```
+
+**Exit Codes**:
+- 0: Success
+- 1: Invalid parameters
+- 2: API error
+
+## Environment Variables
+- `N8N_BASE_URL`: n8n instance URL
+- `N8N_API_KEY`: n8n API authentication key
+
+## Integration
+All operations use n8n webhooks for PR distribution service integration (PR Newswire, Business Wire).