Agent skill

Analyze Io Traces

by moeru-ai in moeru-ai/airi

Read and analyze AIRI IO traces that Tamagotchi saved to local files.

MITAuto-check passed

Install Analyze Io Traces

skills CLI
$ npx skills add moeru-ai/airi --skill analyze-io-traces -a claude-code

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

GitHub CLI
$ gh skill install moeru-ai/airi analyze-io-traces --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/moeru-ai/airi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/analyze-io-traces .claude/skills/analyze-io-traces && 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
analyze-io-traces
GitHub stars
50k
Token cost
~542 tokens
SKILL.md length
177 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Read and analyze AIRI IO traces that Tamagotchi saved to local files.

  • The user asks why a chat
  • SKILL.md covers Find the files, Record shape, Common queries and Limits
  • Calls jq and pnpm
  • Audio turn was slow

What it does

Analyze Io Traces is an agent skill from moeru-ai/airi. Read and analyze AIRI IO traces that Tamagotchi saved to local files. Use when the user asks why a chat, speech, or audio turn was slow, failed, or behaved wrongly, and recording is enabled in Settings System Developer.

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

The repository describes itself as: 💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of… The licence is MIT.

When your agent uses it

  • The user asks why a chat
  • Audio turn was slow
  • Behaved wrongly
  • Recording is enabled in Settings System Developer

Example prompts

  • “/analyze-io-traces”

What it can do on your machine

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

    • jq
    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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

Analyze Io Traces loads about 542 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 177 words of instructions outside code blocks.

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

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 moeru-ai/airi at commit ec682e2, republished under its MIT licence (© moeru-ai). 177 words, ~542 tokens.

Download SKILL.mdSave it as .claude/skills/analyze-io-traces/SKILL.md (or your agent's skills folder).
name
analyze-io-traces
description
Read and analyze AIRI IO traces that Tamagotchi saved to local files. Use when the user asks why a chat, speech, or audio turn was slow, failed, or behaved wrongly, and recording is enabled in Settings > System > Developer.

Analyze IO traces

Tamagotchi saves each ended IO span as one JSON line when Record IO traces automatically is on. The setting is under Settings > System > Developer.

Find the files

Files are named <start time>.jsonl. A new file starts each time recording starts. Files older than seven days are deleted.

sh
ls -t "$HOME/Library/Application Support/ai.moeru.airi/io-traces"/*.jsonl | head -3
ls -t "$HOME/Library/Application Support/@proj-airi/stage-tamagotchi/io-traces"/*.jsonl | head -3

The first path is the packaged app on macOS. The second is pnpm dev on macOS. If APP_USER_DATA_PATH is set, use $APP_USER_DATA_PATH/io-traces. If recording is off or nothing ran yet, the folder does not exist. Ask the user to turn it on and reproduce the problem.

Record shape

Each line is one span with traceId, spanId, parentSpanId, name, startTimeNano, endTimeNano, status.code (2 means error), attributes, and events. Time values are decimal strings in nanoseconds. A trace is one interaction turn. Subsystems are in attributes["ai.moeru.airi.io.subsystem"].

Common queries

Set F to the newest file first.

sh
# Spans by name, slowest first, in milliseconds
jq -r '[.name, ((.endTimeNano|tonumber)-(.startTimeNano|tonumber))/1e6] | @tsv' "$F" | sort -t$'\t' -k2 -nr | head -20

# Spans with an error status
jq -c 'select(.status.code == 2) | {name, traceId, message: .status.message}' "$F"

# All spans of one trace in start order
jq -c 'select(.traceId == "TRACE_ID")' "$F" | jq -s 'sort_by(.startTimeNano|tonumber)'

# Time to first token for each LLM span
jq -c 'select(.events | any(.name | endswith("llm.first_token"))) | {traceId, events}' "$F"

Limits

Spans are saved only after they end. A call that never ends is not in the file. Spans record timing and counts, not prompts or replies. Say so when the cause needs content.

© moeru-ai, 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 .agents/skills/analyze-io-traces of moeru-ai/airi.

Open the folder on GitHubat commit ec682e2

Compare with similar skills

Analyze Io Traces 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.

Analyze Io Traces compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Analyze Io Traces this skillmoeru-ai/airi50k—~542Automated safety check: PassMIT
Observe Traceruvnet/ruflo74k—~522Automated safety check: NotesMIT
Tracezereight/gitlab-mcp2k1 repos~412Automated safety check: PassMIT
Distributed Tracingwshobson/agents40k12 repos~527Automated safety check: PassMIT
Arize Tracegithub/awesome-copilot40k1 repos~5.9kAutomated safety check: NotesMIT
Evidence-Driven TraceYeachan-Heo/oh-my-claudecode40k—~2.6kAutomated safety check: PassMIT

Similar skills

  • Observe Trace

    ruvnet/ruflo

    Trace agent execution by collecting spans and building a trace tree for a task

    74k GitHub stars~522 tokensUpdated yesterday
    Auto-check: notes
  • Trace

    zereight/gitlab-mcp

    Evidence-driven tracing with competing hypotheses in parallel.

    2k GitHub starsUsed in 1 repo~412 tokens
    DevelopmentAuto-check passed
  • Distributed Tracing

    wshobson/agents

    Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks.

    40k GitHub starsUsed in 12 repos~527 tokens
    DevOps & CloudAuto-check passed
  • Arize Trace

    github/awesome-copilot

    Official

    Downloads, exports, and inspects existing Arize traces and spans to understand what an LLM app is doing or debug runtime issues.

    40k GitHub starsUsed in 1 repo~5.9k tokens
    DevelopmentAuto-check: notes
  • Evidence-Driven Trace

    Yeachan-Heo/oh-my-claudecode

    Explains why something happened by generating competing hypotheses, gathering evidence in parallel, ranking explanations and proposing the next discriminating probe.

    40k GitHub stars~2.6k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Context Save

    garrytan/gstack

    Captures git state, decisions made and remaining work so that a later session can resume the task without losing context.

    136k GitHub stars~9.9k tokensUpdated today
    Agent WorkflowsAuto-check: notes

More from moeru-ai/airi

All 24 skills in this repo
  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    Auto-check passed
  • Review pending AIRI translations on Crowdin in a batch, then sync them into the repository.

    50k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Upload a local image or file to GitHub's user-attachments storage and return a URL suitable for issue, pull request, discussion, or comment Markdown.

    50k GitHub stars~554 tokensUpdated today
    Auto-check passed
  • Create PR

    moeru-ai/airi

    Prepare and create an AIRI pull request with verifiable change context, architecture evidence, and required visual evidence.

    50k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Test AIRI display-model imports with agent-browser across stage-tamagotchi Electron, stage-web, and stage-pocket mobile web layouts.

    50k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when Codex needs to inspect, debug, or automate an Electron app through agent-browser and Chrome DevTools Protocol, especially when the app has multiple BrowserWindow…

    50k GitHub stars~3.1k tokensUpdated today
    Auto-check passed

Questions about Analyze Io Traces

What does Analyze Io Traces do?

Read and analyze AIRI IO traces that Tamagotchi saved to local files. Analyze Io Traces is an agent skill from moeru-ai/airi. Read and analyze AIRI IO traces that Tamagotchi saved to local files.

When should I use Analyze Io Traces?

Analyze Io Traces fits situations like: the user asks why a chat; audio turn was slow; behaved wrongly; recording is enabled in Settings System Developer.

How do I install Analyze Io Traces in Claude Code?

Run `npx skills add moeru-ai/airi --skill analyze-io-traces -a claude-code`. Or copy the skill folder (.agents/skills/analyze-io-traces in moeru-ai/airi) into .claude/skills/analyze-io-traces in your project. Claude Code loads it when a task matches its description.

How do I install Analyze Io Traces in Codex?

Run `npx skills add moeru-ai/airi --skill analyze-io-traces -a codex`. Or copy the skill folder (.agents/skills/analyze-io-traces in moeru-ai/airi) into .agents/skills/analyze-io-traces in your project. Codex loads it when a task matches its description.

Can I use Analyze Io Traces 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 moeru-ai/airi --skill analyze-io-traces -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/analyze-io-traces, .gemini/skills/analyze-io-traces, .github/skills/analyze-io-traces and .opencode/skills/analyze-io-traces in your project.

What does Analyze Io Traces need to run?

Going by SKILL.md and its folder, Analyze Io Traces needs the command-line tools its instructions call (jq and pnpm).

Does Analyze Io Traces 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 Analyze Io Traces 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 Analyze Io Traces use?

Analyze Io Traces is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Analyze Io Traces use?

About 542 tokens (SKILL.md is roughly 2.2k 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 Analyze Io Traces?

Skills that share tags, products or a category with Analyze Io Traces: Observe Trace (ruvnet/ruflo, 74k stars), Trace (zereight/gitlab-mcp, 2k stars), Distributed Tracing (wshobson/agents, 40k stars) and Arize Trace (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Analyze Io Traces?

moeru-ai (a GitHub organization) maintains it in moeru-ai/airi, which has 50,267 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 11, 2026.

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