Skip to content
Agent Orchestration
Skill

/read-the-trace

Extract the actual cause from a stack trace instead of pattern-matching the error type. Use on any crash or exception.

BOOST
From plugin
loopkit
75553 skills1 agent4 commands2 MCP
Install
$ npx -y skills add Archive228/loopkit --skill read-the-trace --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/read-the-trace

Context preview

The summary Claude sees to decide when to auto-load this skill.

Extract the actual cause from a stack trace instead of pattern-matching the error type. Use on any crash or exception.

SKILL.md

read-the-trace.SKILL.md
name: read-the-trace
description: Extract the actual cause from a stack trace instead of pattern-matching the error type. Use on any crash or exception.
when_to_use: a stack trace, an exception, "TypeError/NullPointer/undefined", a crash log

Read the Trace

LLMs love to see "TypeError" and generate a generic fix without reading the trace. Don't.

  • Find the **deepest frame in YOUR code** — not the library frame at the top. That's where the bad value entered.
  • Read the actual values: what was null/undefined/wrong-type, and where it came from.
  • Trace it one level up: why was that value bad? The root is usually 1-2 frames above the throw.
  • Reproduce with that exact input before fixing.

A TypeError can mean a hundred things. The trace tells you which one — read all of it, including the "caused by".

Ships withloopkit

33 battle-tested skills + minimal .claude harness for any coding agent (Claude Code, Cursor, Codex, Gemini CLI).

Get the whole plugin

Other skills on loopkit.