frustration-check

What problem does it solve?

Automatically intercept frustration cues in conversations to reset direction and resume productive work.

Core Features & Use Cases

• Frustration mode: deliver one non-preachy line, reflect on recent turns, offer three paths, run the chosen path, and confirm refined intent before resuming.
• Assist mode: provide a light nudge when the user expresses doubt, helping to recall context and re-align goals without derailing the session.
• Opt-out and first-run setup: supports a default configuration with per-user settings and a first-run bootstrap.
• Per-session state: maintains a lightweight score and turn-tracking to manage progression and recovery across prompts.
• Safety and guidance: avoids automatic weblookups unless consented, and respects user control over drift scanning.

Quick Start

Enable the frustration-check skill, run scripts/init_settings.py on first activation, and begin using prompts to trigger the hook.