skills.rest
marin-community
marin-communityOFFICIAL
Explore all skills by this author →
WebsiteGitHub

consult-echo

Search and capture shared Marin knowledge through the Echo CLI.

3.2k|266|Updated Mar 22, 2024
Search Tags:#CLI#Documentation#prior work#knowledge search#ECHO#marin#Wiki
One-click install
npx skills add https://github.com/marin-community/marin --skill consult-echo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: consult-echo
Source: https://github.com/marin-community/marin/tree/main/.agents/skills/consult-echo
Command: npx skills add https://github.com/marin-community/marin --skill consult-echo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams lose time rediscovering prior work and repeating solved problems because institutional knowledge is scattered across wikis, GitHub, and Discord. This Skill searches Marin's Echo knowledge base before starting work and captures reusable findings as durable wiki notes.

Core Features & Use Cases

  • Federated Search: Query wiki notes, files, PRs, and issues with natural language via infra/echo/cli.py search, with optional Discord and exact-string grep modes.
  • Result Grading: Fetch full result details by source ID and grade evaluated results with feedback to improve future search quality.
  • Knowledge Capture: Create or revise Open Knowledge Format wiki notes with actionable titles, use_when triggers, and canonical URL citations.
  • Use Case: Before diagnosing a stalled TPU collective, search Echo for prior incidents, cite the canonical evidence URLs, and write a wiki note documenting the reusable diagnostic pattern.

Quick Start

Ask the assistant to search Echo for prior work on your current Marin task and cite the relevant canonical URLs before writing any new documentation.

Frequently Asked Questions about consult-echo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Marin prior work with Echo?▼

Run `uv run infra/echo/cli.py search "your query" --limit 10` for a natural-language federated search. It covers wiki, file, PR, and issue domains by default, and you can repeat `--domain` to narrow the scope.

How do I create a wiki note in Echo?▼

Write an Open Knowledge Format markdown file with type, title, use_when, and tags frontmatter, then run `uv run infra/echo/cli.py wiki add --file note.md`. The command prints the canonical Echo URL to cite.

Does Echo search include Discord messages?▼

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.

Why does Echo file search not find my uncommitted changes?▼

Echo's file index follows the periodically refreshed GitHub head, so branch-only or uncommitted files are not indexed. Use `rg` for exact identifiers in the current local checkout instead.

When should I update OPS.md instead of adding an Echo wiki note?▼

Update OPS.md for recurring operational procedures or guardrails in one subsystem, and docs/ for reusable product guidance. Add an Echo wiki note only for cross-cutting patterns with no single repository home and no near-duplicate.

Related Skills

Explore More Software Engineering Skills→
open-thoughtsopen-thoughts
276

eval-agentic-launch-iris

Manages the full lifecycle of Iris evaluation jobs via the command line.

Official
Advanced
davidleedavidlee
26

capturing-memory

Create structured memory records with narrow memory_type during phase wrap-up.

Community
Intermediate
udecodeudecode
240

repo-research-analyst

Analyze repository architecture, conventions, and implementation patterns using ast-grep and ripgrep searches.

Official
Advanced
marin-communitymarin-community
1.2k

scrub-reflection-self-improvement

Scans GitHub issues and PRs to implement repository improvements.

Official
Intermediate