Agent skill

Agenttrace Session Audit

by luoyuctl in luoyuctl/agenttrace

Audit local AI coding-agent sessions with agenttrace. An agent skill from luoyuctl/agenttrace.

MITAuto-check passedAI & LLM Engineering

Install Agenttrace Session Audit

skills CLI
$ npx skills add luoyuctl/agenttrace --skill agenttrace-session-audit -a claude-code

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

GitHub CLI
$ gh skill install luoyuctl/agenttrace agenttrace-session-audit --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/luoyuctl/agenttrace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agenttrace-session-audit .claude/skills/agenttrace-session-audit && 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
agenttrace-session-audit
GitHub stars
142
Used in
1 other repo
Token cost
~656 tokens
SKILL.md length
262 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Audit local AI coding-agent sessions with agenttrace. An agent skill from luoyuctl/agenttrace.

  • Works in 7 steps: Prefer the installed agenttrace binary… → If the binary is not available and the… → Start with discovery unless the user… → …
  • The user asks to inspect Claude Code
  • SKILL.md covers Workflow, Report Focus and Guardrails
  • Calls cargo

What it does

Agenttrace Session Audit is an agent skill from luoyuctl/agenttrace. Audit local AI coding-agent sessions with agenttrace. Use when the user asks to inspect Claude Code, Codex CLI, Qwen Code, Cline, Aider, Cursor exports, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, Copilot-style logs, or generic JSON/JSONL traces for cost, tokens, tool failures, latency, anomalies, health, diffs, or CI gates.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering LLM cost and token optimization. It works with Qwen, Kimi and Rust. The repository describes itself as: Local-first Rust TUI/CLI for auditing AI coding-agent sessions: cost, tokens, latency, failures, and health|本地运行的 Rust TUI/CLI,审计 AI 编程 Agent 会话的成本、Token、延迟、失败与健康度. The licence is MIT.

When your agent uses it

  • The user asks to inspect Claude Code
  • Copilot-style logs
  • Generic JSON/JSONL traces for cost

Example prompts

  • “/agenttrace-session-audit”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Prefer the installed agenttrace binary when it is available on PATH.
  2. If the binary is not available and the current directory is the luoyuctl/agenttrace repository, use cargo run -q -p agenttrace --.
  3. Start with discovery unless the user gave a specific file or directory
  4. For a fast human report, use Markdown
  5. For automation or CI, use JSON or health gates
  6. For a single recent session
  7. For a specific export or session directory

What it can do on your machine

Read from SKILL.md and the folder at commit 15ed07f. 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:

    • cargo

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

  • Network

    No URLs in SKILL.md.

    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

Agenttrace Session Audit loads about 656 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 262 words of instructions outside code blocks.

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

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 luoyuctl/agenttrace at commit 15ed07f, republished under its MIT licence (© luoyuctl). 262 words, ~656 tokens.

Download SKILL.mdSave it as .claude/skills/agenttrace-session-audit/SKILL.md (or your agent's skills folder).
name
agenttrace-session-audit
description
Audit local AI coding-agent sessions with agenttrace. Use when the user asks to inspect Claude Code, Codex CLI, Qwen Code, Cline, Aider, Cursor exports, Hermes Agent, OpenCode, OpenClaw, Pi, Oh My Pi, Kimi CLI, Copilot-style logs, or generic JSON/JSONL traces for cost, tokens, tool failures, latency, anomalies, health, diffs, or CI gates.
license
MIT
metadata.short-description
Audit AI agent session health

agenttrace Session Audit

Use this skill when session logs need an operational read: spend, token burn, cache use, tool failures, retry loops, latency, health, anomalies, and CI gate readiness.

Workflow

  1. Prefer the installed agenttrace binary when it is available on PATH.
  2. If the binary is not available and the current directory is the luoyuctl/agenttrace repository, use cargo run -q -p agenttrace --.
  3. Start with discovery unless the user gave a specific file or directory:
bash
agenttrace --doctor
agenttrace --overview
  1. For a fast human report, use Markdown:
bash
agenttrace --overview -f markdown -o agenttrace-overview.md
  1. For automation or CI, use JSON or health gates:
bash
agenttrace --overview -f json -o agenttrace-overview.json
agenttrace --overview --fail-under-health 80 --fail-on-critical --max-tool-fail-rate 15
  1. For a single recent session:
bash
agenttrace --latest
agenttrace --latest -f json
  1. For a specific export or session directory:
bash
agenttrace path/to/session-or-export.json
agenttrace --overview -d path/to/session-dir

Report Focus

  • Lead with the highest-risk sessions and the reason they matter.
  • Call out token/cost waste, repeated tool failures, retry loops, long gaps, and low health scores.
  • When proposing a CI gate, include the exact agenttrace command and threshold.
  • If no sessions are detected, run agenttrace --doctor and report the detected agent directories and next step.
  • Report the session capability level (Detailed, Aggregate, or Limited) before relying on latency or step evidence.
  • Treat Tool Steps as metadata-only evidence. Do not imply that Aggregate or Limited sources have a complete execution trace.

Guardrails

  • Treat prompts, code, and session contents as local/private data. Do not upload logs to external services.
  • Do not invent metrics. If a parser cannot infer cost, model, or latency, say which field is missing.
  • Do not compare missing event-level evidence as zero latency or zero failures; mark it unavailable.
  • Do not overwrite user reports unless the user asked for that output path.

© luoyuctl, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/agenttrace-session-audit of luoyuctl/agenttrace.

Open the folder on GitHubat commit 15ed07f

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in luoyuctl/agenttrace, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Agenttrace Session Audit 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.

Agenttrace Session Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agenttrace Session Audit this skillluoyuctl/agenttrace1421 repos~656Automated safety check: PassMIT
Omnifajarhide/omni374—~1.1kAutomated safety check: PassApache-2.0
Add Modelguoqingbao/xinfer334—~4.2kAutomated safety check: NotesMIT
Agfsubinium/agf157—~1.3kAutomated safety check: PassMIT
Check Modelguoqingbao/xinfer334—~3.8kAutomated safety check: PassMIT
Test Modelguoqingbao/xinfer334—~2.6kAutomated safety check: PassMIT

Similar skills

  • Omni

    fajarhide/omni

    A skill your agent uses when installing, verifying or configuring OMNI, when command output carries an [OMNI: ...] marker, or when output looks shorter than expected.

    374 GitHub stars~1.1k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Add Model

    guoqingbao/xinfer

    Adapt and port new LLM model architectures to this xinfer project.

    334 GitHub stars~4.2k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Agf

    subinium/agf

    Find local coding-agent sessions, inspect bounded metadata or summaries, and prepare a read-only resume plan with AGF.

    157 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed
  • Check Model

    guoqingbao/xinfer

    Check model compatibility with xinfer before loading. An agent skill from guoqingbao/xinfer.

    334 GitHub stars~3.8k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Test Model

    guoqingbao/xinfer

    Test LLM models served by xinfer for correctness, output quality, and performance.

    334 GitHub stars~2.6k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • LLM Council on Fireworks AI

    dair-ai/dair-academy-plugins

    Has several open-weight models answer a question, rank each other's anonymized answers, then lets a chairman model write the final response through Fireworks AI.

    614 GitHub stars~5k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check: notes

Works with

Questions about Agenttrace Session Audit

What does Agenttrace Session Audit do?

Audit local AI coding-agent sessions with agenttrace. An agent skill from luoyuctl/agenttrace. Agenttrace Session Audit is an agent skill from luoyuctl/agenttrace. Audit local AI coding-agent sessions with agenttrace.

When should I use Agenttrace Session Audit?

Agenttrace Session Audit fits situations like: the user asks to inspect Claude Code; copilot-style logs; generic JSON/JSONL traces for cost.

How do I install Agenttrace Session Audit in Claude Code?

Run `npx skills add luoyuctl/agenttrace --skill agenttrace-session-audit -a claude-code`. Or copy the skill folder (skills/agenttrace-session-audit in luoyuctl/agenttrace) into .claude/skills/agenttrace-session-audit in your project. Claude Code loads it when a task matches its description.

How do I install Agenttrace Session Audit in Codex?

Run `npx skills add luoyuctl/agenttrace --skill agenttrace-session-audit -a codex`. Or copy the skill folder (skills/agenttrace-session-audit in luoyuctl/agenttrace) into .agents/skills/agenttrace-session-audit in your project. Codex loads it when a task matches its description.

Can I use Agenttrace Session Audit 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 luoyuctl/agenttrace --skill agenttrace-session-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agenttrace-session-audit, .gemini/skills/agenttrace-session-audit, .github/skills/agenttrace-session-audit and .opencode/skills/agenttrace-session-audit in your project.

What does Agenttrace Session Audit need to run?

Going by SKILL.md and its folder, Agenttrace Session Audit needs the command-line tools its instructions call (cargo).

Does Agenttrace Session Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agenttrace Session Audit 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 Agenttrace Session Audit use?

Agenttrace Session Audit is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agenttrace Session Audit use?

About 656 tokens (SKILL.md is roughly 2.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 Agenttrace Session Audit?

Skills that share tags, products or a category with Agenttrace Session Audit: Omni (fajarhide/omni, 374 stars), Add Model (guoqingbao/xinfer, 334 stars), Agf (subinium/agf, 157 stars) and Check Model (guoqingbao/xinfer, 334 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agenttrace Session Audit?

luoyuctl (a GitHub user) maintains it in luoyuctl/agenttrace, which has 142 GitHub stars. The repository was last updated on October 6, 2026.

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