| 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
| Event |
Trigger |
Actions |
| quest-complete |
Quest marked done |
Log, celebrate, check level |
| emotion-change |
Emotion logged |
Update HA, set lights, alert if needed |
| sale |
Purchase received |
Log, celebrate, deliver, follow-up |
| daily |
Scheduled time |
Phase-specific actions |
| error |
Any failure |
Log, retry, escalate |
| social |
Content ready |
Post to platforms |
| report |
Report requested |
Generate and send |
| hardware |
Button/sensor |
Trigger appropriate action |
| parent |
Parent alert needed |
SMS/email to Joshua |
| ai |
AI generation needed |
Call Groq API |
10 Master Zaps
- Quest Complete Hub - Logs, celebrates, checks level up
- Emotion Change Hub - Updates HA, alerts if prolonged negative
- Sale Received Hub - Logs, delivers, requests review
- Daily Scheduler Hub - Hourly check, routes to phase actions
- Error Handler Hub - Logs, retries, escalates
- Social Media Hub - Posts content to all platforms
- Report Generator Hub - Creates daily/weekly reports
- Hardware Trigger Hub - Handles button/sensor events
- Parent Notification Hub - SMS/email to Joshua
- 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
- Every automation MUST have error handling
- Use Paths for conditional logic (not multiple zaps)
- Include delays between rapid-fire actions (2-5 seconds)
- Always send failures to error handler
- 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