magic-mouth

What problem does it solve?

Magic Mouth is trigger → message. The entire craft is specifying the trigger boundary, the message payload, and the suppression/escalation rules. It is NOT: - One-time messages: "Send a Slack message now saying X" (no trigger, no automation)

• Full chatbots: "Build a conversational AI that understands context and handles open-ended questions" (requires NLU, dialogue management)
• Monitoring dashboards: "Set up Grafana with real-time graphs and trend analysis" (visualization, not message routing)
• Silent traps/wards: "Revert changes silently and log who tried" (defensive code manipulation, not messaging)
• Encryption: "Encrypt a message so only the recipient can read it" (cryptography, not event-driven delivery)
• Multimedia presentations: "Play a 20-slide deck with animations and narration" (media playback, not conditional messaging) In this grimoire, Magic Mouth is treated as a metaphorical spell with a shipping-now delivery profile. Canonical reference input: Magic Mouth (spell).

When To Use

• Use this spell when the user describes an event-driven message automation: a specific trigger condition (X) should cause a specific message or notification (Y) to be sent without manual intervention.
• Look for these patterns in the request:
• "When [condition], send/post/notify [message/recipient]"
• "Set up an autoresponder for [scenario]"
• "Create an alert rule for [metric/event]"
• "Design a webhook handler that posts to [channel] when [event]"
• Mentions of triggers, fire conditions, suppression rules, rate limits, or escalation stages
• Explicit no-fire cases ("don't fire if...", "suppress duplicates for...", "only once per...")

Prerequisites

• Environment variables available to Hermes: SLACK_TOKEN.
• Primary credential or token: SLACK_TOKEN.
• Binaries on PATH: curl.

Setup

1. Confirm the required environment variables are available inside the active Hermes runtime, not just in a shell profile.
2. Verify the required binaries resolve on PATH before you rely on them in a procedure.
3. Choose a non-production or low-risk target first if the skill can page, unlock, alert, or touch a live integration.

Procedure

1. Restate the target, the success condition, and any no-touch boundaries before taking action.
2. Extract the trigger: Identify the exact condition that fires the message (metric threshold, event type, time window, keyword match). Note any compound conditions or timing delays ("wait 5 minutes before firing").
3. Specify the payload: List every variable in the message (who, what, where, severity, links). Write the response template with placeholders.
4. Define boundaries: Document no-fire cases, rate limits, suppression windows, and escalation stages. Explicitly state what happens on repeated triggers.
5. Return the spec: Produce a trigger-response specification with test cases covering: nominal fire, no-fire, repeated-trigger suppression, and escalation progression. If Slack or a messaging API is available, include the concrete API call or workflow configuration.
6. Package the result as the deliverables below, with confidence, assumptions, and unresolved risk called out explicitly.

Deliverables

• A trigger-response specification or message template.
• Example payloads covering nominal and edge-case inputs.
• Notes on rate limits, suppression, escalation, and logging.

Pitfalls / Guardrails

• Keep the metaphor anchored to a real mechanism instead of drifting into lore.
• Do not automate messages requiring human judgment, empathy, or legal review
• Protect against loops, spam, and easily-spoofed trigger conditions
• Always include a suppression mechanism for repeated triggers
• Do not rely on a live integration until credentials, target scope, and rollback expectations are verified.

Verification

• Check that the result includes every deliverable promised above.
• Check that confirmed facts, assumptions, and inferences are visibly separated.
• Check that the metaphor still maps cleanly to a real operational mechanism.
• Check the required environment variables and binaries in the active Hermes runtime before trusting the procedure on a live target.

Example Invocation

/magic-mouth turn this trigger into a reliable automated response and show me the exact fire conditions

Quick Start

Configure a trigger-to-message workflow by specifying the event, the payload, and escalation rules.