Menú
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.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
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]]