Agent skill

Consult Echo

by marin-community in marin-community/marin

Search or cite Echo at the start of a fresh Marin investigation when prior-work policy applies, another selected workflow requires it, or the user explicitly asks; reuse relevant results during the…

Apache-2.0Auto-check passed

Install Consult Echo

skills CLI
$ npx skills add marin-community/marin --skill consult-echo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install marin-community/marin consult-echo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/marin-community/marin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/consult-echo .claude/skills/consult-echo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
consult-echo
GitHub stars
3.9k
Token cost
~1.4k tokens
SKILL.md length
638 words
Files
2
Skills in repo
41
Repo updated
First seen
Licence
Apache-2.0

At a glance

Search or cite Echo at the start of a fresh Marin investigation when prior-work policy applies, another selected workflow requires it, or the user explicitly asks; reuse relevant results during the…

  • SKILL.md covers Search, Choose the durable home and Write or revise a wiki note
  • Calls uv

What it does

Consult Echo is an agent skill from marin-community/marin. Search or cite Echo at the start of a fresh Marin investigation when prior-work policy applies, another selected workflow requires it, or the user explicitly asks; reuse relevant results during the same logical investigation.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It works with Discord and GitHub. The repository describes itself as: Open-source framework for the research and development of foundation models. The licence is Apache-2.0.

Example prompts

  • “/consult-echo”

What it can do on your machine

Read from SKILL.md and the folder at commit be1f5f1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Consult Echo loads about 1.4k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 638 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from marin-community/marin at commit be1f5f1, republished under its Apache-2.0 licence (© marin-community). 638 words, ~1,393 tokens.

Download SKILL.mdSave it as .claude/skills/consult-echo/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
consult-echo
description
Search or cite Echo at the start of a fresh Marin investigation when prior-work policy applies, another selected workflow requires it, or the user explicitly asks; reuse relevant results during the same logical investigation.

Consult Echo

Search Echo before rediscovering prior work. Cite canonical Echo, GitHub, or Discord URLs for the evidence you use.

Treat one incident, debugging session, or research question as one logical investigation across continuation turns. Search once when that investigation starts, then reuse relevant results already fetched in the conversation. Do not search again merely because the user asks a follow-up question or requests the next operational step. Search again only when the incident, question, repository scope, or freshness requirement changes, when a selected workflow requires a current duplicate check, or when the user explicitly asks.

Use a natural-language federated search:

bash
uv run infra/marina/apps/echo/cli.py search "how do I diagnose a stalled TPU collective" --limit 10

Search covers wiki, file, pr, and issue by default. Repeat --domain to select a subset.

File search infers the configured Marin-community repository from the current Git checkout, including ordinary contributor forks. Pass --repository <owner/repo> to choose one configured repository or --repository all to search all six. The CLI prints the resolved file scope once. Searches that omit the file domain work outside a Git checkout.

Discord is excluded by default because messages may be noisy or untrusted. Add --domain discord only when discussion history is relevant, and open the canonical URL when surrounding thread context matters.

Fetch a result's full detail with the value in the SOURCE ID column:

bash
uv run infra/marina/apps/echo/cli.py get <source-id>

The GRADE KEY column is for feedback. get also accepts file grading keys with numeric suffixes, such as file:20849.

Grade evaluated results with the exact query and printed keys:

bash
uv run infra/marina/apps/echo/cli.py feedback --query "stalled TPU collective" \
  --grade wiki:730=0 --grade file:731=10 \
  <<< "The file result answered the task; wiki results were off-topic."

Use 0 for irrelevant and 10 for directly useful. Grade only evaluated results and always explain overall quality on stdin, including for an empty result set.

Use grep for exact strings in GitHub or Discord activity, narrowing with --source or --kind when needed:

bash
uv run infra/marina/apps/echo/cli.py grep "FAILED_PRECONDITION" --source github

Use rg for exact identifiers in the current checkout. Echo's file index follows the periodically refreshed GitHub head, so it does not contain branch-only or uncommitted files. Use wiki search --tag <tag> when tags, rather than federated relevance, define the desired synthesis. Authentication reuses the shared Marin login via iris login; see Echo setup and access.

Run this search sequence before adding or editing a wiki note.

Show full SKILL.md (288 more words)Show less

Choose the durable home

Every live infrastructure incident, as defined by write-ops-log, gets a standalone Echo record linked from its associated PR or issue. Also use the narrowest reusable home when the incident or other work changes durable guidance:

  • Update OPS.md for a recurring operational procedure, diagnostic workflow, or guardrail in one subsystem.
  • Update docs/ for reusable product or user guidance that belongs with the repository.
  • Edit an existing Echo wiki note for a cross-cutting pattern or synthesis that has no single repository home.
  • Add a wiki note only when the searches find no near-duplicate.

Create one incident entry per incident and edit it while the same incident continues. Keep raw logs and diffs in their source systems. Edit a near-duplicate synthesis instead of adding another.

Write or revise a wiki note

Write the shortest entry that changes a future action:

  • Lead with an actionable value: a decision, command, diagnostic discriminator, guardrail, or recovery step.
  • Include only the facts needed to support or apply that action. Link to the canonical PR, issue, dashboard, log bundle, or report for chronology and raw evidence instead of copying it into Echo.
  • Put the action in the title, use_when, or opening paragraph.
  • Keep chronology without a reusable decision in an issue, logbook, or source artifact.

Write an Open Knowledge Format document:

markdown
---
type: wiki-note
title: Stalled TPU collectives can have several low-power causes
use_when: when a distributed TPU job stalls before the first optimizer update
tags:
  - ops
  - debugging
  - iris
---

State the reusable pattern, how to distinguish its causes, and the evidence URLs.

Use lowercase kebab-case tags. Keep the title concrete and make use_when describe the future search trigger. Make the body stand alone. Cite canonical URLs inline. Concision still requires enough context to apply the guidance safely; do not omit a precondition, destructive-action warning, or material caveat.

Create a note:

bash
uv run infra/marina/apps/echo/cli.py wiki add --file note.md

Revise the closest existing note:

bash
uv run infra/marina/apps/echo/cli.py wiki show <id> > note.md
# Edit note.md.
uv run infra/marina/apps/echo/cli.py wiki edit <id> --file note.md

Both write commands print the canonical Echo URL. Return and cite that URL after every add or edit.

© marin-community, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/consult-echo of marin-community/marin.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit be1f5f1

Compare with similar skills

Consult Echo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Consult Echo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Consult Echo this skillmarin-community/marin3.9k—~1.4kAutomated safety check: PassApache-2.0
Openloomi Connectorsmelandlabs/openloomi1k—~3.3kAutomated safety check: PassApache-2.0
Project Managerpwrdrvr/openclaw-codex-app-server265—~1.5kAutomated safety check: PassMIT
Chat SDKdatabuddy-analytics/Databuddy1.2k—~2.6kAutomated safety check: PassAGPL-3.0
Fumadocsbetter-notify/better-notify313—~2.3kAutomated safety check: PassMIT
Releasepwrdrvr/openclaw-codex-app-server265—~2.2kAutomated safety check: PassMIT

Similar skills

  • Openloomi Connectors

    melandlabs/openloomi

    openloomi Connectors tools - manage the native 7 messaging integrations and pair with the composio skill for the 1000+ apps OAuth layer (Slack, Discord, X, Gmail, Outlook, Google…

    1k GitHub stars~3.3k tokensUpdated 14 days ago
    Productivity & AutomationAuto-check passed
  • Project Manager

    pwrdrvr/openclaw-codex-app-server

    Manage GitHub issues and the GitHub Project board for the current repository, while keeping the local tracker in sync.

    265 GitHub stars~1.5k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Chat SDK

    databuddy-analytics/Databuddy

    Build multi-platform chat bots with Chat SDK (chat npm package).

    1.2k GitHub stars~2.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Fumadocs

    better-notify/better-notify

    A skill your agent uses when writing MDX documentation pages for a Fumadocs project — frontmatter, meta.json, page ordering, and fumadocs-ui React components available inside MDX content.

    313 GitHub stars~2.3k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Release

    pwrdrvr/openclaw-codex-app-server

    Plan and publish a GitHub Release in a tag-driven repository.

    265 GitHub stars~2.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Writing Release Notes

    GoneTone/genshin-impact-wish-gacha-analyzer

    A skill your agent uses when drafting GitHub release notes or changelog content for this project (Genshin Impact Wish Gacha Analyzer).

    152 GitHub stars~1.6k tokensUpdated 3 days ago
    DevelopmentAuto-check passed

More from marin-community/marin

All 41 skills in this repo
  • Noslop

    marin-community/marin

    Deslop, simplify, or review low-value tests and prose only when explicitly requested for a branch or diff.

    3.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Use Iris

    marin-community/marin

    Use Iris to submit, inspect, debug, monitor, or recover jobs and tasks; diagnose scheduling and federation; deploy controllers; or reserve dev GPUs and TPUs.

    3.9k GitHub stars~745 tokensUpdated today
    Auto-check passed
  • Launch Rl

    marin-community/marin

    Define, validate, submit, or restart a Marin SkyRL experiment through its artifact main.

    3.9k GitHub stars~894 tokensUpdated today
    Auto-check passed
  • Marina Applet

    marin-community/marin

    Build, validate, publish, update, inspect, query, roll back, or archive a dynamic Marina applet.

    3.9k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Query Finelog

    marin-community/marin

    Query Finelog logs and telemetry for Iris tasks, workers, profiles, training, vLLM, and cross-cluster forwarding.

    3.9k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Trace Pulumi Diff

    marin-community/marin

    Run a read-only preview for a specified Marin infra/pulumi stack and trace each pending resource change to merged pull requests since its latest successful update when that update records a clean…

    3.9k GitHub stars~663 tokensUpdated today
    Auto-check passed

Works with

Questions about Consult Echo

What does Consult Echo do?

Search or cite Echo at the start of a fresh Marin investigation when prior-work policy applies, another selected workflow requires it, or the user explicitly asks; reuse relevant results during the…. Consult Echo is an agent skill from marin-community/marin. Search or cite Echo at the start of a fresh Marin investigation when prior-work policy applies, another selected workflow requires it, or the user explicitly asks; reuse relevant results during the same logical investigation.

How do I install Consult Echo in Claude Code?

Run `npx skills add marin-community/marin --skill consult-echo -a claude-code`. Or copy the skill folder (.agents/skills/consult-echo in marin-community/marin) into .claude/skills/consult-echo in your project. Claude Code loads it when a task matches its description.

How do I install Consult Echo in Codex?

Run `npx skills add marin-community/marin --skill consult-echo -a codex`. Or copy the skill folder (.agents/skills/consult-echo in marin-community/marin) into .agents/skills/consult-echo in your project. Codex loads it when a task matches its description.

Can I use Consult Echo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add marin-community/marin --skill consult-echo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/consult-echo, .gemini/skills/consult-echo, .github/skills/consult-echo and .opencode/skills/consult-echo in your project.

What does Consult Echo need to run?

Going by SKILL.md and its folder, Consult Echo needs the command-line tools its instructions call (uv).

Does Consult Echo access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Consult Echo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Consult Echo use?

Consult Echo is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Consult Echo use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Consult Echo?

Skills that share tags, products or a category with Consult Echo: Openloomi Connectors (melandlabs/openloomi, 1k stars), Project Manager (pwrdrvr/openclaw-codex-app-server, 265 stars), Chat SDK (databuddy-analytics/Databuddy, 1.2k stars) and Fumadocs (better-notify/better-notify, 313 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Consult Echo?

marin-community (a GitHub organization) maintains it in marin-community/marin, which has 3,902 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on October 8, 2026.

Source: marin-community/marin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.