crewly 1.4.61 → 1.4.62

package/config/skills/agent/content-calendar/execute.sh

@@ -58,9 +58,9 @@ case "$ACTION" in
     require_param "scheduledDate" "$SCHEDULED_DATE"
 
     # Validate platform
-    VALID_PLATFORMS="x|linkedin|xiaohongshu|substack|youtube|github|reddit"
+    VALID_PLATFORMS="x|linkedin|xiaohongshu|substack|youtube|github|reddit|instagram|facebook"
     if ! echo "$PLATFORM" | grep -qE "^(${VALID_PLATFORMS})$"; then
-      error_exit "Invalid platform: $PLATFORM. Valid: x, linkedin, xiaohongshu, substack, youtube, github, reddit"
+      error_exit "Invalid platform: $PLATFORM. Valid: x, linkedin, instagram, facebook, xiaohongshu, substack, youtube, github, reddit"
     fi
 
     # Validate status

package/config/skills/agent/marketing/brand-onboarding/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: brand-onboarding
+description: Interactive brand onboarding questionnaire that collects business information and generates a Brand Voice Guide for marketing team agents.
+version: 1.0.0
+category: marketing
+assignableRoles:
+  - strategist
+  - orchestrator
+triggers:
+  - on_team_create
+  - manual
+tags:
+  - marketing
+  - onboarding
+  - brand
+  - setup
+execution:
+  type: script
+  script: execute.sh
+  interpreter: bash
+  timeout: 60000
+---
+
+# Brand Onboarding
+
+Collects brand information from the business owner and generates a Brand Voice Guide
+that all marketing team agents use to maintain brand consistency.
+
+## Usage
+
+### Start onboarding session
+```bash
+bash execute.sh '{"action":"start","teamId":"team-123","templateId":"marketing-team"}'
+```
+
+### Submit an answer (step-by-step)
+```bash
+bash execute.sh '{"action":"answer","sessionId":"session-uuid","value":"Sunrise Bakery"}'
+```
+
+### Submit all answers at once (batch mode)
+```bash
+bash execute.sh '{"action":"batch","teamId":"team-123","templateId":"marketing-team","answers":{"business_name":"Sunrise Bakery","industry":"Food","description":"Artisan bakery","target_customer":"Health-conscious millennials","competitors":"Blue Apron, HelloFresh","personality":"Warm, Authentic, Passionate","tone":"casual","goals":"Brand awareness, Community building","platforms":"Instagram, X (Twitter)","content_examples":"https://example.com"}}'
+```
+
+### Complete onboarding (generate guide)
+```bash
+bash execute.sh '{"action":"complete","sessionId":"session-uuid","outputDir":"/path/to/knowledge/docs"}'
+```
+
+### Get current question
+```bash
+bash execute.sh '{"action":"question","sessionId":"session-uuid"}'
+```
+
+## Questions (10 total)
+
+1. Business name
+2. Industry
+3. One-sentence business description
+4. Target customer profile
+5. Top 3 competitors
+6. Brand personality (3 words)
+7. Content tone (Formal/Casual/Playful/Authoritative)
+8. Marketing goals
+9. Social platforms
+10. Content examples
+
+## Output
+
+Generates `brand-voice-guide.md` in the specified output directory with:
+- Business Profile section
+- Brand Voice (personality, tone, do's, don'ts)
+- Content Strategy (goals, platforms, content mix ratios)
+- Platform-specific Guidelines
+- Writing Rules

package/config/skills/agent/marketing/brand-onboarding/execute.sh

@@ -0,0 +1,312 @@
+#!/usr/bin/env bash
+# =============================================================================
+# brand-onboarding — Interactive brand questionnaire & voice guide generator
+#
+# Manages the onboarding session via the Crewly API's BrandOnboardingService.
+# Falls back to local file-based operation if API is not available.
+#
+# Usage:
+#   bash execute.sh '{"action":"start","teamId":"team-123","templateId":"marketing-team"}'
+#   bash execute.sh '{"action":"answer","sessionId":"uuid","value":"Sunrise Bakery"}'
+#   bash execute.sh '{"action":"batch","teamId":"team-123","answers":{...}}'
+#   bash execute.sh '{"action":"complete","sessionId":"uuid","outputDir":"/path/to/docs"}'
+#   bash execute.sh '{"action":"question","sessionId":"uuid"}'
+# =============================================================================
+
+set -euo pipefail
+
+INPUT="${1:-"{}"}"
+
+# Parse input fields
+ACTION=$(echo "$INPUT" | jq -r '.action // "start"')
+TEAM_ID=$(echo "$INPUT" | jq -r '.teamId // ""')
+TEMPLATE_ID=$(echo "$INPUT" | jq -r '.templateId // "marketing-team"')
+SESSION_ID=$(echo "$INPUT" | jq -r '.sessionId // ""')
+VALUE=$(echo "$INPUT" | jq -r '.value // ""')
+OUTPUT_DIR=$(echo "$INPUT" | jq -r '.outputDir // ""')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // ""')
+
+# Crewly API base URL
+API_BASE="${CREWLY_API_URL:-http://localhost:3000}"
+
+# Local storage directory
+LOCAL_DIR="${PROJECT_PATH:-.}/.crewly/onboarding"
+
+# =============================================================================
+# Questions definition (matches BrandOnboardingService)
+# =============================================================================
+QUESTIONS='[
+  {"id":"business_name","text":"What is your business name?","required":true,"order":1},
+  {"id":"industry","text":"What industry are you in? (e.g., Fashion, Food, Fitness, Tech, Education)","required":true,"order":2},
+  {"id":"description","text":"Describe your business in one sentence.","required":true,"order":3},
+  {"id":"target_customer","text":"Who is your target customer? (Age, interests, problems they have)","required":true,"order":4},
+  {"id":"competitors","text":"What are your top 3 competitors?","required":false,"order":5},
+  {"id":"personality","text":"Describe your brand personality in 3 words. (e.g., Professional, Friendly, Bold)","required":true,"order":6},
+  {"id":"tone","text":"What tone should your content have? (Formal / Casual / Playful / Authoritative)","required":true,"order":7},
+  {"id":"goals","text":"What are your marketing goals? (Brand awareness / Lead generation / Sales / Community)","required":true,"order":8},
+  {"id":"platforms","text":"Which platforms do you use? (X / LinkedIn / Instagram / Facebook)","required":true,"order":9},
+  {"id":"content_examples","text":"Share 2-3 examples of content you like (URLs or descriptions).","required":false,"order":10}
+]'
+
+# =============================================================================
+# Helper: generate brand voice guide from answers
+# =============================================================================
+generate_guide() {
+  local ANSWERS_FILE="$1"
+  local OUT_DIR="$2"
+
+  # Extract answers
+  local BIZ_NAME=$(jq -r '.business_name // "Your Business"' "$ANSWERS_FILE")
+  local INDUSTRY=$(jq -r '.industry // "General"' "$ANSWERS_FILE")
+  local DESCRIPTION=$(jq -r '.description // ""' "$ANSWERS_FILE")
+  local TARGET=$(jq -r '.target_customer // ""' "$ANSWERS_FILE")
+  local COMPETITORS=$(jq -r '.competitors // "Not specified"' "$ANSWERS_FILE")
+  local PERSONALITY=$(jq -r '.personality // "Professional, Friendly"' "$ANSWERS_FILE")
+  local TONE=$(jq -r '.tone // "casual"' "$ANSWERS_FILE")
+  local GOALS=$(jq -r '.goals // "Brand awareness"' "$ANSWERS_FILE")
+  local PLATFORMS=$(jq -r '.platforms // "Instagram"' "$ANSWERS_FILE")
+  local EXAMPLES=$(jq -r '.content_examples // "Not specified"' "$ANSWERS_FILE")
+
+  # Generate tone-specific rules
+  local DOS=""
+  local DONTS=""
+  case "$(echo "$TONE" | tr '[:upper:]' '[:lower:]')" in
+    formal)
+      DOS="- Use complete sentences and proper grammar\n- Cite data and statistics to support claims"
+      DONTS="- Use slang, abbreviations, or internet speak\n- Use excessive emojis (max 1 per post)"
+      ;;
+    playful)
+      DOS="- Use humor, wordplay, and pop culture references\n- Include emojis to add personality"
+      DONTS="- Be serious or dry in tone\n- Make jokes that could offend or alienate"
+      ;;
+    authoritative)
+      DOS="- Lead with expertise and industry knowledge\n- Share original insights and thought leadership"
+      DONTS="- Hedge or use uncertain language (\"maybe\", \"perhaps\")\n- Copy competitor messaging or talking points"
+      ;;
+    *)
+      DOS="- Write like you are talking to a friend\n- Use contractions and conversational language"
+      DONTS="- Be overly corporate or stiff\n- Use jargon that your audience might not understand"
+      ;;
+  esac
+  DOS="${DOS}\n- Stay consistent with the brand personality across all platforms\n- Engage authentically with comments and messages"
+  DONTS="${DONTS}\n- Use generic AI-sounding language\n- Post identical content across all platforms (adapt per platform)"
+
+  mkdir -p "$OUT_DIR"
+
+  # Capitalize first letter of tone (compatible with bash 3.x)
+  TONE_CAP="$(echo "$TONE" | awk '{print toupper(substr($0,1,1)) tolower(substr($0,2))}')"
+
+  # Write guide using printf to avoid heredoc substitution issues
+  {
+    printf '# Brand Voice Guide — %s\n\n' "$BIZ_NAME"
+    printf '> Auto-generated by Crewly AI Marketing Team onboarding.\n'
+    printf '> Last updated: %s\n\n' "$(date +%Y-%m-%d)"
+    printf '## Business Profile\n\n'
+    printf '%s\n' "- **Name**: $BIZ_NAME"
+    printf '%s\n' "- **Industry**: $INDUSTRY"
+    printf '%s\n' "- **Description**: $DESCRIPTION"
+    printf '%s\n' "- **Target Customer**: $TARGET"
+    printf '%s\n\n' "- **Competitors**: $COMPETITORS"
+    printf '## Brand Voice\n\n'
+    printf '%s\n' "- **Personality**: $PERSONALITY"
+    printf '%s\n\n' "- **Tone**: $TONE_CAP"
+    printf "### Do's\n"
+    printf '%b\n\n' "$DOS"
+    printf "### Don'ts\n"
+    printf '%b\n\n' "$DONTS"
+    printf '## Content Strategy\n\n'
+    printf '%s\n' "- **Goals**: $GOALS"
+    printf '%s\n' "- **Platforms**: $PLATFORMS"
+    printf '%s\n\n' "- **Content Mix**: 60% Educational, 20% Behind-the-scenes, 15% Promotional, 5% Interactive"
+    printf '## Writing Rules\n\n'
+    printf '1. Always write as if you ARE %s, not about %s.\n' "$BIZ_NAME" "$BIZ_NAME"
+    printf '2. Match the %s tone consistently across all platforms.\n' "$TONE"
+    printf '3. Use the brand personality (%s) to guide word choices.\n' "$PERSONALITY"
+    printf '4. Never use generic AI cliches like "In today'\''s digital landscape" or "Unlock the power of".\n'
+    printf '5. Every post must have a clear purpose: educate, entertain, sell, or engage.\n'
+    printf '6. Include a call-to-action in at least 50%% of posts.\n'
+    printf '7. Use hashtags strategically — 3-5 for Twitter/X, 10-15 for Instagram, 2-3 for LinkedIn.\n\n'
+    printf '## Style Examples\n\n'
+    echo "$EXAMPLES" | tr ',' '\n' | sed 's/^ */- /'
+  } > "${OUT_DIR}/brand-voice-guide.md"
+
+  echo "${OUT_DIR}/brand-voice-guide.md"
+}
+
+# =============================================================================
+# Actions
+# =============================================================================
+
+case "$ACTION" in
+  start)
+    if [ -z "$TEAM_ID" ]; then
+      echo '{"success":false,"error":"teamId is required"}'
+      exit 1
+    fi
+
+    SESSION_ID="onboard-$(date +%s)-$RANDOM"
+    mkdir -p "$LOCAL_DIR"
+
+    # Create session file
+    jq -n \
+      --arg id "$SESSION_ID" \
+      --arg teamId "$TEAM_ID" \
+      --arg templateId "$TEMPLATE_ID" \
+      --argjson questions "$QUESTIONS" \
+      '{
+        id: $id,
+        teamId: $teamId,
+        templateId: $templateId,
+        status: "in_progress",
+        currentQuestionIndex: 0,
+        totalQuestions: ($questions | length),
+        answers: {},
+        createdAt: (now | todate)
+      }' > "${LOCAL_DIR}/${SESSION_ID}.json"
+
+    FIRST_Q=$(echo "$QUESTIONS" | jq -r '.[0].text')
+
+    echo "{\"success\":true,\"sessionId\":\"${SESSION_ID}\",\"status\":\"in_progress\",\"totalQuestions\":10,\"currentQuestion\":1,\"questionText\":\"${FIRST_Q}\"}"
+    ;;
+
+  question)
+    if [ -z "$SESSION_ID" ]; then
+      echo '{"success":false,"error":"sessionId is required"}'
+      exit 1
+    fi
+
+    SESSION_FILE="${LOCAL_DIR}/${SESSION_ID}.json"
+    if [ ! -f "$SESSION_FILE" ]; then
+      echo '{"success":false,"error":"Session not found"}'
+      exit 1
+    fi
+
+    IDX=$(jq -r '.currentQuestionIndex' "$SESSION_FILE")
+    TOTAL=$(echo "$QUESTIONS" | jq 'length')
+
+    if [ "$IDX" -ge "$TOTAL" ]; then
+      echo '{"success":true,"status":"completed","message":"All questions answered. Run action=complete to generate the Brand Voice Guide."}'
+    else
+      Q_TEXT=$(echo "$QUESTIONS" | jq -r ".[$IDX].text")
+      Q_ID=$(echo "$QUESTIONS" | jq -r ".[$IDX].id")
+      Q_REQ=$(echo "$QUESTIONS" | jq -r ".[$IDX].required")
+      echo "{\"success\":true,\"questionNumber\":$((IDX + 1)),\"totalQuestions\":${TOTAL},\"questionId\":\"${Q_ID}\",\"questionText\":\"${Q_TEXT}\",\"required\":${Q_REQ}}"
+    fi
+    ;;
+
+  answer)
+    if [ -z "$SESSION_ID" ]; then
+      echo '{"success":false,"error":"sessionId is required"}'
+      exit 1
+    fi
+
+    SESSION_FILE="${LOCAL_DIR}/${SESSION_ID}.json"
+    if [ ! -f "$SESSION_FILE" ]; then
+      echo '{"success":false,"error":"Session not found"}'
+      exit 1
+    fi
+
+    IDX=$(jq -r '.currentQuestionIndex' "$SESSION_FILE")
+    Q_ID=$(echo "$QUESTIONS" | jq -r ".[$IDX].id")
+    Q_REQ=$(echo "$QUESTIONS" | jq -r ".[$IDX].required")
+    TOTAL=$(echo "$QUESTIONS" | jq 'length')
+
+    # Validate required
+    if [ "$Q_REQ" = "true" ] && [ -z "$VALUE" ]; then
+      echo '{"success":false,"error":"This question requires an answer"}'
+      exit 1
+    fi
+
+    # Save answer and advance
+    jq --arg qid "$Q_ID" --arg val "$VALUE" \
+      '.answers[$qid] = $val | .currentQuestionIndex += 1' \
+      "$SESSION_FILE" > "${SESSION_FILE}.tmp" && mv "${SESSION_FILE}.tmp" "$SESSION_FILE"
+
+    NEXT_IDX=$((IDX + 1))
+    if [ "$NEXT_IDX" -ge "$TOTAL" ]; then
+      jq '.status = "completed"' "$SESSION_FILE" > "${SESSION_FILE}.tmp" && mv "${SESSION_FILE}.tmp" "$SESSION_FILE"
+      echo "{\"success\":true,\"status\":\"completed\",\"message\":\"All questions answered! Run action=complete to generate the Brand Voice Guide.\"}"
+    else
+      NEXT_Q=$(echo "$QUESTIONS" | jq -r ".[$NEXT_IDX].text")
+      echo "{\"success\":true,\"questionNumber\":$((NEXT_IDX + 1)),\"totalQuestions\":${TOTAL},\"nextQuestion\":\"${NEXT_Q}\"}"
+    fi
+    ;;
+
+  batch)
+    if [ -z "$TEAM_ID" ]; then
+      echo '{"success":false,"error":"teamId is required"}'
+      exit 1
+    fi
+
+    SESSION_ID="onboard-$(date +%s)-$RANDOM"
+    mkdir -p "$LOCAL_DIR"
+
+    # Extract answers from input
+    ANSWERS=$(echo "$INPUT" | jq '.answers // {}')
+
+    # Create completed session
+    echo "$ANSWERS" | jq --arg id "$SESSION_ID" --arg teamId "$TEAM_ID" \
+      '{
+        id: $id,
+        teamId: $teamId,
+        status: "completed",
+        currentQuestionIndex: 10,
+        totalQuestions: 10,
+        answers: .,
+        createdAt: (now | todate)
+      }' > "${LOCAL_DIR}/${SESSION_ID}.json"
+
+    # Auto-generate if outputDir provided
+    if [ -n "$OUTPUT_DIR" ]; then
+      ANSWERS_FILE="${LOCAL_DIR}/${SESSION_ID}-answers.json"
+      echo "$ANSWERS" > "$ANSWERS_FILE"
+      GUIDE_PATH=$(generate_guide "$ANSWERS_FILE" "$OUTPUT_DIR")
+      rm -f "$ANSWERS_FILE"
+      echo "{\"success\":true,\"sessionId\":\"${SESSION_ID}\",\"status\":\"done\",\"guidePath\":\"${GUIDE_PATH}\"}"
+    else
+      echo "{\"success\":true,\"sessionId\":\"${SESSION_ID}\",\"status\":\"completed\",\"message\":\"Answers saved. Run action=complete with outputDir to generate guide.\"}"
+    fi
+    ;;
+
+  complete)
+    if [ -z "$SESSION_ID" ]; then
+      echo '{"success":false,"error":"sessionId is required"}'
+      exit 1
+    fi
+    if [ -z "$OUTPUT_DIR" ]; then
+      echo '{"success":false,"error":"outputDir is required"}'
+      exit 1
+    fi
+
+    SESSION_FILE="${LOCAL_DIR}/${SESSION_ID}.json"
+    if [ ! -f "$SESSION_FILE" ]; then
+      echo '{"success":false,"error":"Session not found"}'
+      exit 1
+    fi
+
+    STATUS=$(jq -r '.status' "$SESSION_FILE")
+    if [ "$STATUS" != "completed" ]; then
+      echo '{"success":false,"error":"Session is not complete. Answer all questions first."}'
+      exit 1
+    fi
+
+    # Extract answers to temp file
+    ANSWERS_FILE="${LOCAL_DIR}/${SESSION_ID}-answers.json"
+    jq '.answers' "$SESSION_FILE" > "$ANSWERS_FILE"
+
+    # Generate guide
+    GUIDE_PATH=$(generate_guide "$ANSWERS_FILE" "$OUTPUT_DIR")
+    rm -f "$ANSWERS_FILE"
+
+    # Update session
+    jq --arg path "$GUIDE_PATH" '.status = "done" | .guidePath = $path' \
+      "$SESSION_FILE" > "${SESSION_FILE}.tmp" && mv "${SESSION_FILE}.tmp" "$SESSION_FILE"
+
+    echo "{\"success\":true,\"sessionId\":\"${SESSION_ID}\",\"status\":\"done\",\"guidePath\":\"${GUIDE_PATH}\",\"message\":\"Brand Voice Guide generated successfully.\"}"
+    ;;
+
+  *)
+    echo "{\"success\":false,\"error\":\"Unknown action: ${ACTION}. Use start, question, answer, batch, or complete.\"}"
+    exit 1
+    ;;
+esac

package/config/skills/agent/marketing/submit-for-approval/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: submit-for-approval
+description: Submit marketing content (posts, articles) for human approval via Slack. Used by Writer and Strategist agents in the Marketing Team template.
+version: 1.0.0
+category: marketing
+assignableRoles:
+  - writer
+  - strategist
+  - content-writer
+  - content-strategist
+triggers:
+  - before_publish
+  - manual
+tags:
+  - marketing
+  - approval
+  - slack
+  - content
+execution:
+  type: script
+  script: execute.sh
+  interpreter: bash
+  timeout: 30000
+---
+
+# Submit for Approval
+
+Submits marketing content for human review and approval via Slack.
+
+## Usage
+
+```bash
+bash execute.sh '{"action":"submit","platform":"Instagram","contentType":"post","content":"Your post text here...","hashtags":["#tag1","#tag2"],"visualDirection":"Photo of product","scheduledTime":"2026-03-25T09:00:00Z"}'
+```
+
+## Actions
+
+### submit
+Submit content for approval. Sends a formatted message to the configured Slack channel.
+
+**Parameters:**
+- `platform` (required): Target platform (Instagram, X, LinkedIn, Facebook)
+- `contentType` (required): Content type (post, article, newsletter, thread)
+- `content` (required): The actual content text
+- `hashtags` (optional): Array of hashtags
+- `visualDirection` (optional): Visual/image brief
+- `scheduledTime` (optional): When to publish
+
+### status
+Check the status of a pending approval.
+
+**Parameters:**
+- `approvalId` (required): The approval request ID
+
+### list
+List all pending approvals for the current team.
+
+## Response Format
+
+```json
+{
+  "success": true,
+  "approvalId": "abc-123",
+  "status": "pending",
+  "message": "Content submitted for approval. The business owner will review via Slack."
+}
+```
+
+## Integration
+
+This skill integrates with the ContentApprovalService in the Crewly backend.
+The approval message is sent to Slack where the business owner can reply
+with "approve" or "reject [reason]" to resolve the request.

package/config/skills/agent/marketing/submit-for-approval/execute.sh

@@ -0,0 +1,138 @@
+#!/usr/bin/env bash
+# =============================================================================
+# submit-for-approval — Submit marketing content for human approval
+#
+# Submits content to the ContentApprovalService via the Crewly API.
+# The approval message is sent to the configured Slack channel.
+#
+# Usage:
+#   bash execute.sh '{"action":"submit","platform":"Instagram","contentType":"post","content":"...","hashtags":["#tag"]}'
+#   bash execute.sh '{"action":"status","approvalId":"abc-123"}'
+#   bash execute.sh '{"action":"list"}'
+# =============================================================================
+
+set -euo pipefail
+
+INPUT="${1:-"{}"}"
+
+# Parse input fields
+ACTION=$(echo "$INPUT" | jq -r '.action // "submit"')
+PLATFORM=$(echo "$INPUT" | jq -r '.platform // ""')
+CONTENT_TYPE=$(echo "$INPUT" | jq -r '.contentType // "post"')
+CONTENT=$(echo "$INPUT" | jq -r '.content // ""')
+HASHTAGS=$(echo "$INPUT" | jq -r '.hashtags // [] | join(", ")')
+VISUAL_DIRECTION=$(echo "$INPUT" | jq -r '.visualDirection // ""')
+SCHEDULED_TIME=$(echo "$INPUT" | jq -r '.scheduledTime // ""')
+APPROVAL_ID=$(echo "$INPUT" | jq -r '.approvalId // ""')
+TEAM_ID=$(echo "$INPUT" | jq -r '.teamId // ""')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // ""')
+
+# Crewly API base URL
+API_BASE="${CREWLY_API_URL:-http://localhost:3000}"
+
+case "$ACTION" in
+  submit)
+    # Validate required fields
+    if [ -z "$PLATFORM" ]; then
+      echo '{"success":false,"error":"platform is required"}'
+      exit 1
+    fi
+    if [ -z "$CONTENT" ]; then
+      echo '{"success":false,"error":"content is required"}'
+      exit 1
+    fi
+
+    # Build the approval request payload
+    PAYLOAD=$(jq -n \
+      --arg teamId "$TEAM_ID" \
+      --arg submittedBy "${CREWLY_SESSION_NAME:-unknown}" \
+      --arg platform "$PLATFORM" \
+      --arg contentType "$CONTENT_TYPE" \
+      --arg content "$CONTENT" \
+      --arg hashtags "$HASHTAGS" \
+      --arg visualDirection "$VISUAL_DIRECTION" \
+      --arg scheduledTime "$SCHEDULED_TIME" \
+      '{
+        teamId: $teamId,
+        submittedBy: $submittedBy,
+        platform: $platform,
+        contentType: $contentType,
+        content: $content,
+        hashtags: (if $hashtags == "" then [] else ($hashtags | split(", ")) end),
+        visualDirection: (if $visualDirection == "" then null else $visualDirection end),
+        scheduledTime: (if $scheduledTime == "" then null else $scheduledTime end)
+      }')
+
+    # Submit via API
+    RESPONSE=$(curl -s -X POST "${API_BASE}/api/content-approvals" \
+      -H "Content-Type: application/json" \
+      -d "$PAYLOAD" 2>/dev/null || echo '{"error":"API unreachable"}')
+
+    # Check if API call succeeded
+    if echo "$RESPONSE" | jq -e '.id' >/dev/null 2>&1; then
+      APPROVAL_ID=$(echo "$RESPONSE" | jq -r '.id')
+      echo "{\"success\":true,\"approvalId\":\"${APPROVAL_ID}\",\"status\":\"pending\",\"message\":\"Content submitted for approval. The business owner will review via Slack.\"}"
+    else
+      # Fallback: store locally if API is not available
+      APPROVAL_ID="local-$(date +%s)-$RANDOM"
+      APPROVAL_DIR="${PROJECT_PATH:-.}/.crewly/content-approvals"
+      mkdir -p "$APPROVAL_DIR"
+
+      echo "$PAYLOAD" | jq --arg id "$APPROVAL_ID" --arg status "pending" \
+        '. + {id: $id, status: $status, submittedAt: (now | todate)}' \
+        > "${APPROVAL_DIR}/${APPROVAL_ID}.json"
+
+      echo "{\"success\":true,\"approvalId\":\"${APPROVAL_ID}\",\"status\":\"pending\",\"message\":\"Content saved locally for approval (API not available). File: ${APPROVAL_DIR}/${APPROVAL_ID}.json\"}"
+    fi
+    ;;
+
+  status)
+    if [ -z "$APPROVAL_ID" ]; then
+      echo '{"success":false,"error":"approvalId is required"}'
+      exit 1
+    fi
+
+    # Check via API
+    RESPONSE=$(curl -s "${API_BASE}/api/content-approvals/${APPROVAL_ID}" 2>/dev/null || echo '{"error":"API unreachable"}')
+
+    if echo "$RESPONSE" | jq -e '.id' >/dev/null 2>&1; then
+      STATUS=$(echo "$RESPONSE" | jq -r '.status')
+      FEEDBACK=$(echo "$RESPONSE" | jq -r '.feedback // "none"')
+      echo "{\"success\":true,\"approvalId\":\"${APPROVAL_ID}\",\"status\":\"${STATUS}\",\"feedback\":\"${FEEDBACK}\"}"
+    else
+      # Fallback: check local file
+      APPROVAL_DIR="${PROJECT_PATH:-.}/.crewly/content-approvals"
+      LOCAL_FILE="${APPROVAL_DIR}/${APPROVAL_ID}.json"
+      if [ -f "$LOCAL_FILE" ]; then
+        STATUS=$(jq -r '.status' "$LOCAL_FILE")
+        echo "{\"success\":true,\"approvalId\":\"${APPROVAL_ID}\",\"status\":\"${STATUS}\",\"source\":\"local\"}"
+      else
+        echo "{\"success\":false,\"error\":\"Approval ${APPROVAL_ID} not found\"}"
+      fi
+    fi
+    ;;
+
+  list)
+    # List pending approvals via API
+    RESPONSE=$(curl -s "${API_BASE}/api/content-approvals?teamId=${TEAM_ID}&status=pending" 2>/dev/null || echo '[]')
+
+    if echo "$RESPONSE" | jq -e '.[0]' >/dev/null 2>&1; then
+      COUNT=$(echo "$RESPONSE" | jq 'length')
+      echo "{\"success\":true,\"count\":${COUNT},\"approvals\":${RESPONSE}}"
+    else
+      # Fallback: list local files
+      APPROVAL_DIR="${PROJECT_PATH:-.}/.crewly/content-approvals"
+      if [ -d "$APPROVAL_DIR" ]; then
+        COUNT=$(ls -1 "$APPROVAL_DIR"/*.json 2>/dev/null | wc -l | tr -d ' ')
+        echo "{\"success\":true,\"count\":${COUNT},\"source\":\"local\",\"directory\":\"${APPROVAL_DIR}\"}"
+      else
+        echo "{\"success\":true,\"count\":0,\"approvals\":[]}"
+      fi
+    fi
+    ;;
+
+  *)
+    echo "{\"success\":false,\"error\":\"Unknown action: ${ACTION}. Use submit, status, or list.\"}"
+    exit 1
+    ;;
+esac

package/config/skills/agent/marketing/weekly-content-planning/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: weekly-content-planning
+description: Generates a weekly content calendar with 5-7 posts across specified platforms. Wraps the content-calendar skill to create batch entries for the upcoming week.
+version: 1.0.0
+category: marketing
+skillType: claude-skill
+assignableRoles:
+  - strategist
+triggers:
+  - weekly content plan
+  - plan next week
+  - content planning
+  - weekly calendar
+tags:
+  - marketing
+  - content
+  - planning
+  - calendar
+  - weekly
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 30000
+---
+
+# Weekly Content Planning
+
+Generates a weekly content calendar with 5-7 posts across specified platforms. Uses the content-calendar skill to persist each entry.
+
+## Input Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `businessName` | Yes | Name of the business |
+| `industry` | Yes | Business industry/vertical |
+| `platforms` | Yes | JSON array of target platforms (e.g., `["x","linkedin"]`) |
+| `contentMix` | No | JSON object with content type ratios (default: `{"educational":40,"engagement":30,"promotional":20,"community":10}`) |
+| `weekStartDate` | Yes | Start date of the week in `YYYY-MM-DD` format |
+| `projectPath` | No | Project path for calendar storage |
+| `postCount` | No | Number of posts to plan (default: 5) |
+
+## Example
+
+```bash
+bash execute.sh '{"businessName":"Acme AI","industry":"artificial intelligence","platforms":["x","linkedin","instagram"],"weekStartDate":"2026-03-23","projectPath":"/path/to/project"}'
+```
+
+## Output
+
+Returns JSON with `success: true` and a `calendar` field containing the generated entries as a markdown table, plus an `entries` array with the raw entry data.