consult-echo

name	consult-echo
description	Search and cite Marin's shared Echo wiki, repository index, issues, pull requests, and optional Discord history. Use when prior cross-project decisions, incidents, workflows, exact errors, or reusable knowledge could inform a task, and before adding or revising an Echo wiki entry.

Skill: Consult Echo

Search Echo before rediscovering prior work:

uv run .agents/skills/consult-echo/scripts/echo.py search \
  "how do I diagnose a stalled TPU collective" --limit 10
uv run .agents/skills/consult-echo/scripts/echo.py get <domain:id>

Wiki, Marin repository files, pull requests, and issues are searched by default. Add --domain discord only when discussion history is relevant. Echo's file index follows marin-community/marin main; use rg for the current checkout, including fork-only and uncommitted files.

Open the complete result and cite its canonical URL when it affects the work. Run another search before writing so a near-duplicate can be edited instead.

Choose the durable home narrowly:

• Append distilled milestones for an active task to Echo's work log with task-logbook.
• Publish a specific incident or durable debugging outcome with write-ops-log.
• Publish or revise a cross-project design with write-design-doc.
• Update repository docs when guidance belongs to that product or subsystem.
• Edit an existing Echo wiki synthesis when several projects need the same decision, guardrail, or diagnostic pattern.

Keep raw logs, diffs, test output, and run artifacts in their source systems. Echo entries summarize the decision or result and link that evidence.