name: automation-builder description: Create Zapier zaps, Home Assistant automations, n8n workflows, and webhook integrations. Use when building automations, APIs, or integration flows. allowed-tools: Read, Edit, Write, WebFetch, Bash

Automation Builder Skill

Architecture Overview

Events → Webhook Router → 10 Master Zaps → 100+ Actions
              ↓
         Error Handler → Retry → Self-Heal

Webhook Router (Replit)

Central hub: https://phoenix-forge-router.USERNAME.repl.co/phoenix/{event_type}

Event Types

10 Master Zaps

1. Quest Complete Hub - Logs, celebrates, checks level up
2. Emotion Change Hub - Updates HA, alerts if prolonged negative
3. Sale Received Hub - Logs, delivers, requests review
4. Daily Scheduler Hub - Hourly check, routes to phase actions
5. Error Handler Hub - Logs, retries, escalates
6. Social Media Hub - Posts content to all platforms
7. Report Generator Hub - Creates daily/weekly reports
8. Hardware Trigger Hub - Handles button/sensor events
9. Parent Notification Hub - SMS/email to Joshua
10. AI Generation Hub - Calls Groq for text generation

Home Assistant Webhooks

• phoenix_quest_complete
• phoenix_emotion_change
• phoenix_sale
• phoenix_daily
• phoenix_level_up

Key Principles

1. Every automation MUST have error handling
2. Use Paths for conditional logic (not multiple zaps)
3. Include delays between rapid-fire actions (2-5 seconds)
4. Always send failures to error handler
5. Self-healing: retry once, then escalate

Key Files

• ~/repos/phoenix-forge-ecosystem/ZAPIER_100_AUTOMATIONS.md
• ~/repos/phoenix-forge-ecosystem/PHOENIX_FORGE_FULL_SETUP.md
• ~/repos/phoenix-forge-ecosystem/PHOENIX_CLAUDE_COMPLETE_SETUP.md