← ClaudeAtlas

trace-skill-activitylisted

Records and queries what agents actually did, attributed to the skill that was active, using qvr's experimental audit subsystem. Use when a user wants observability into agent or skill behavior — e.g. "track what my skills are doing", "audit agent tool calls", "which skill ran during this session", "show recent agent activity", or "export agent traces for analysis". Covers qvr audit enable, install-hooks, status, logs, sessions, and export. Experimental and opt-in; the command surface and storage may change.
astra-sh/qvr · ★ 2 · AI & Automation · score 71
Install: claude install-skill astra-sh/qvr
# Trace skill activity with qvr audit `qvr audit` captures an atomic trace of every tool, file op, and command an agent runs — **attributed to the skill that was active** — into a local SQLite database (`~/.quiver/skillops.db`). It answers "what did this agent actually do, and which skill drove it?" The subsystem is **experimental, opt-in, and disabled by default**; its command surface, storage format, and output shapes may change. ## When to use this - The user wants visibility into agent tool/file/command activity. - They want to attribute actions to the skill that was active. - They want to export traces for external analysis, replay, or archival. This is observability only — it does not change what skills are installed (that's `onboard-skills`) or verify their integrity (that's `verify-skill-supply-chain`). ## How it works (two layers) - **Raw traces** — the agent's own transcript lines and hook payloads, captured verbatim. This is the source of truth (`qvr audit export`, `sessions show`). - **Derived spans** — Turn / Tool / Skill spans projected from the raw traces, as shown by `qvr audit logs`. A deriver must exist for the agent; without one the agent is raw-only and the derived views stay empty (the `DERIVES` column in `status` reports, per agent, whether a deriver exists). ## Workflow ### 1. Enable capture and wire agent hooks `enable` sets `ops.enabled` in config and creates the database. `install-hooks` adds a hook to each detected agent's config th