Tooluck logoTooluck
SKILL.md

research-observability

Agent skill fromLeanmcp/gateway-skills

Add file-based observability, tracing, and run analysis to LLM/agent experiments — per-turn transcripts, tool calls and results, reasoning traces, token/cost accounting, per-episode artifacts, plus terminal viewers and a run-comparison report. Platform-agnostic: one small adapter covers OpenAI, Gemini/Vertex, Anthropic, LiteLLM, Tinker, vLLM, or any custom inference stack, and the same tooling then works unchanged. Use this skill whenever the user wants observability, tracing, logging, or run tracking for model experiments; asks why an agent failed a task or wants to replay/debug/diff an episode; wants to compare models, arms, or ablations; wants to instrument a new folder, repo, or platform ("add observability here", "do the same for Tinker/Gemini/OpenAI"); wants to import or tie in existing experiment results so old runs show up alongside new ones; or wants eval runner scripts where many models share one protocol. Reach for this even when they only say "log what the model is doing",

How to install research-observability

install research-observability
# install the gateway-skills pack with the skills CLI
npx skills add Leanmcp/gateway-skills

# or add only this skill to Claude Code: copy the folder

skills/research-observability/

# into

~/.claude/skills/research-observability/ (all projects)

.claude/skills/research-observability/ (one project)

skills/research-observability/SKILL.md

MITFull file
1# Research observability
2
3Experiments you cannot replay are experiments you have to rerun. This skill
4installs a small, file-based observability layer over any LLM/agent experiment
5and the tools to read it: every generation, every tool call and result, every
6reasoning trace, every reward — on disk as plain JSONL, greppable, diffable, and
7re-gradable months later.
8
9The design bet: **the recording format is fixed and platform-independent, so
10adding a platform is writing one ~15-line normalizer, not re-plumbing
11observability.** LiteLLM, OpenAI, Gemini, Anthropic, Tinker and a bespoke
12inference server all produce identical files, and every viewer, report and diff
13downstream works with no further changes.
14
15## Start here
16
17**Adding observability to a project.** Follow
18[references/integration.md](references/integration.md) end to end — it is a
19seven-step procedure, starting with a survey of the repo (which platform, where
20the generations happen, where results go today) and ending with the existing
21runs imported so old and new sit in the same viewer. Do the survey before
22writing code; the answers determine every later choice.
23
24**A platform not yet wired.** [references/platforms.md](references/platforms.md)
25has working recipes for OpenAI, Gemini/Vertex, Anthropic, LiteLLM, Tinker, and
26vLLM/self-hosted, plus the 15-line template for anything else and the
27framework-level patterns (subclass the model class, or use the callback API).
28
29**Understanding or extending the format.**
30…

Excerpt shown under the repository's MIT license.

More skills in gateway-skills

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates