observability:session

84 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By bendrucker/claude (GitHub) · coding · 18 stars · scanned at commit 497d619

Query Claude Code session history via a DuckDB index over `~/.claude/projects/`. Use when asked about Claude Code activity ("how many tokens today?", "what did I work on this week?", "which sessions discussed X?") or instead of reading, grepping, or jq-ing session transcripts. Not for codebase search, git log queries, or arbitrary databases.

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

This is disclosed by the author in the skill's SKILL.md or README. It runs automatically when the plugin is installed. Expected for a coding skill.

Found in 13 places.

plugins/observability/skills/session/SKILL.md, line 31bun ${CLAUDE_SKILL_DIR}/scripts/refresh.ts
plugins/observability/skills/session/SKILL.md, line 45duckdb -readonly -json -init ${CLAUDE_SKILL_DIR}/resources/limits.sql ~/.local/share/claude-sessions/session.duckdb "SELECT model, SUM(output_tokens) FROM messa
plugins/observability/skills/session/SKILL.md, line 82duckdb -readonly -json -init ${CLAUDE_SKILL_DIR}/resources/limits.sql -cmd "SET VARIABLE query = 'taskpolicy renice setpriority cpu priority'" \

Show 10 more

plugins/observability/skills/session/SKILL.md, line 101duckdb -readonly -json -init ${CLAUDE_SKILL_DIR}/resources/limits.sql \
plugins/observability/skills/session/scripts/extensions.integration.ts, line 17const proc = Bun.spawnSync(
plugins/observability/skills/session/scripts/lock-holder.ts, line 20const proc = Bun.spawn(["bun", "-e", code], {
plugins/observability/skills/session/scripts/query.ts, line 86Bun.spawn(command, { ...options, stdout: "pipe", stderr: "pipe" });
plugins/observability/skills/session/scripts/refresh.integration.ts, line 2import { spawn } from "node:child_process";
plugins/observability/skills/session/scripts/refresh.integration.ts, line 42const proc = Bun.spawn(["bun", refreshScript, ...args], {
plugins/observability/skills/session/scripts/refresh.ts, line 4import { spawn } from "node:child_process";
plugins/observability/skills/session/scripts/writer-scripts.test.ts, line 55const proc = Bun.spawn(["bun", join(import.meta.dirname, script), ...args], {
plugins/observability/hooks/hooks.json, line 9"command": "bun \"${CLAUDE_PLUGIN_ROOT}/hooks/upload.ts\"",
plugins/observability/hooks/hooks.json, line 20"command": "bun \"${CLAUDE_PLUGIN_ROOT}/hooks/upload.ts\"",

Connects to the internet

This is disclosed by the author in the skill's SKILL.md or README. It runs automatically when the plugin is installed.

Found in 3 places.

plugins/observability/skills/session/fixtures/sessions/-Users-test-project/denials.jsonl, line 2{"type":"assistant","message":{"role":"assistant","content":[{"type":"tool_use","id":"deny-tool-1","name":"Bash","input":{"command":"git branch -D release-1","d
plugins/observability/skills/session/references/discovery.md, line 126. One or more grounding agents re-check every candidate (see [Grounding](#grounding)). They need `WebFetch`, which `analyst` lacks, so spawn them generic with
plugins/observability/hooks/upload.ts, line 102const res = await fetch(key, { method: "PUT", body }).catch((error: unknown) =>

Changes files outside its own folder

The author does not mention this.

Found in 2 places.

plugins/observability/skills/session/references/cross-machine.md, line 18mkdir -p ~/.claude/session-imports/<label>/projects
plugins/observability/skills/session/references/cross-machine.md, line 50mkdir -p ~/.claude/session-imports/cloud/projects

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'observability-session' ] || [ -L ~/.agents/skills/'observability-session' ]; then echo 'A skill folder named observability-session already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/bendrucker/claude' "$d" && git -C "$d" checkout --quiet '497d619eb22e6f93dd49c4d8f6ff4a52578e0949' -- 'plugins/observability/skills/session' && mkdir -p ~/.agents/skills && cp -R "$d"/'plugins/observability/skills/session' ~/.agents/skills/'observability-session' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'observability-session' ~/.claude/skills/'observability-session' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for bendrucker/claude shows the score of its lowest-scoring skill.

SkillTrust badge for bendrucker/claude

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/bendrucker/claude.svg)](https://zalavijaysinh.github.io/skilltrust/repos/bendrucker/claude/)

Score history

Date	Version	Score
2026-11-11	`497d619`	84
2026-11-08	`ebe6d12`	84
2026-11-06	`be8a32e`	84