trace

Reproduce software failures and isolate root causes with read-only tools.

328|53|Updated Aug 1, 2025
One-click install
npx skills add https://github.com/automagik-dev/genie --skill trace-automagik-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/automagik-dev/genie/tree/main/skills/trace
Command: npx skills add https://github.com/automagik-dev/genie --skill trace-automagik-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a systematic approach to investigating and diagnosing the root cause of unknown software failures when the source of the problem is not immediately apparent.

Core Features & Use Cases

  • Root Cause Analysis: Identifies the fundamental reason behind a bug or failure.
  • Reproduction: Autonomously reproduces the reported issue to ensure a consistent understanding.
  • Tracing: Follows the execution flow to pinpoint where the failure originates.
  • Use Case: When a critical bug is reported but the error message is cryptic, use /trace to have an agent meticulously investigate, reproduce the bug, trace its execution path, and provide a clear report on the root cause, ready for the /fix skill.

Quick Start

Use the trace skill to investigate the authentication bug reported in the login flow.

Frequently Asked Questions about trace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of an unknown software failure?

To find the root cause of a software failure, you need a systematic approach to gather symptoms, reproduce the issue, and trace the execution path to isolate where it originates. This produces a structured report detailing evidence and a recommended correction.

What is the best way to debug a cryptic error message in my code?

Debugging a cryptic error message involves autonomously reproducing the reported issue to ensure consistent understanding, then following the execution flow to pinpoint the exact failure point. This isolates the fundamental reason behind the bug for a structured handoff.

How does automated bug investigation work in a read-only environment?

Automated bug investigation in a read-only environment works by dispatching a specialized agent to read files, execute bash commands, and search codebases. It investigates in isolation without modifying the system to safely isolate the failure point.

Can I trace an execution path without modifying the production environment?

Yes, you can trace an execution path without modifications by operating in a read-only environment. The investigation uses tools like Read, Bash, Glob, and Grep to gather evidence and map the causal chain safely without altering system state.

What do I need to reproduce a reported issue for root cause analysis?

To reproduce a reported issue for root cause analysis, you need the reported symptoms and access to the codebase. The investigation isolates the problem autonomously, ensuring a consistent understanding before tracing the failure origin.

When should I use a dedicated tracing tool instead of manual debugging?

You should use a dedicated tracing tool when a critical bug is reported but the source is not immediately apparent. It meticulously investigates, reproduces the bug, and outputs a structured report ready for a fixing agent to apply corrections.