Menu
Validate at system boundaries, trust internally. No defensive fallbacks for impossible cases. Use whenever adding try/except, validation, or null-checks.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Router for any non-trivial echo-sdk task. Maps user intent to the right module skill and diagram. Invoke FIRST for any change to src/echo/ before reaching for a specific module skill.
Recipe for adding a new provider (LLM, transcriber, eval, prompt). Use whenever adding Cohere, Mistral, Deepgram, Phoenix, Promptlayer, etc. — anything that plugs into an existing get_*() factory.
End-to-end recipe for defining a Skill bundle and wiring it into a GenericAgent with the right activation mode and tool registry. Use when extending agent capability via swappable skills rather than baking tools in.
Building agents with BaseAgent / GenericAgent, including skill registration, activation modes (llm vs manual), and system-prompt composition. Use when editing src/echo/agents/ or building a new agent subclass.
Audio transcription provider abstraction (Gemini, EkaCare). Use when transcribing audio, adding a new transcriber, or shaping AudioInput.
Postgres support — asyncpg client, schema-aware binder, PgQueryTool surface. Use when querying postgres from a tool, modifying the binder, or adding a new DB engine.
| name | generic-error-handling-at-boundaries |
| description | Validate at system boundaries, trust internally. No defensive fallbacks for impossible cases. Use whenever adding try/except, validation, or null-checks. |
if x is None: ... for values your own code just constructed — that's noise.except Exception: pass. Either handle a specific exception type with a meaningful recovery, or let it propagate.MCPExecutionError (already wrapped); HTTP 401 from a provider → bubble as the provider's documented exception type.asyncio.CancelledError after cleanup; never absorb it.AgentResult(error=...), not five layers deep._run_agent / _run_agent_stream are the boundary that converts exceptions to AgentResult(error=...) / StreamEvent(ERROR). Tools, LLM providers, and skills should raise — don't catch.MCPError subclasses at the boundary with the MCP server.try: result = await tool.run() except Exception as e: return None → swallows real errors; tool failures become silent successes.if config and config.foo and config.foo.bar for Pydantic configs → if construction succeeded, the chain is fine.Exception to log + re-raise → just let it propagate; the boundary logs.[[generic-small-diffs]], [[python-async-discipline]]