Menu
Type-hint rules for echo-sdk — no Any unless boundary, Protocol for structural typing, narrow Unions, PEP 604 syntax. Use when writing public API signatures.
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 | python-typing-discipline |
| description | Type-hint rules for echo-sdk — no Any unless boundary, Protocol for structural typing, narrow Unions, PEP 604 syntax. Use when writing public API signatures. |
Python 3.11+. Use modern syntax and narrow types.
str | None, not Optional[str] (in new code). Existing Optional is fine — don't churn.list[str], dict[str, int] — not List/Dict from typing (in new code).Any is a smell. Use it only at true boundaries (provider SDKs, JSON blobs from external sources). Internally: name the type.Protocol for structural typing — when you want to accept "anything that has .run()" without inheritance, define a Protocol.Unions: str | int is fine; str | int | bytes | list | dict | None is a smell — usually means the function is doing too much.TYPE_CHECKING for circular-import-only imports:
if TYPE_CHECKING:
from echo.models.user_conversation import ConversationContext
"ConversationContext" (string) in signatures.Literal for finite string enums at API surfaces (SkillActivation = Literal["llm", "manual"]) — Pydantic models with enums are preferred for configs.AsyncGenerator[T, None] for async def generators; Iterator[T] for sync.Final for module-level constants that must not be reassigned (_RESERVED_META_TOOL_NAMES: Final = ("load_skill", ...))).def foo(x) -> Any → name the type; if you don't know, refactor.typing.List in new code → list[T].Union[X, None] → X | None.[[python-pydantic-v2]], [[generic-no-premature-abstraction]]