dig

Guide read-only investigation of bugs and system behavior in CLI workflows.

3|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/tomfordrumm/agent-skills --skill dig-tomfordrumm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dig
Source: https://github.com/tomfordrumm/agent-skills/tree/main/dig
Command: npx skills add https://github.com/tomfordrumm/agent-skills --skill dig-tomfordrumm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you understand bugs, features, or system behavior without accidentally making changes, so you can move forward with confidence.

Core Features & Use Cases

  • Investigation-only workflow: Reads files and inspects evidence to understand what’s happening, explicitly avoiding write operations.
  • Guided troubleshooting: Clarifies goals and constraints, gathers context from logs/configs/outputs, and proposes hypotheses.
  • Permission-gated changes: Explains the exact change needed and asks for explicit, single-use approval before modifying anything.

Quick Start

Ask the agent to investigate the issue you’re seeing and summarize the likely causes and the next read-only steps before proposing any changes.

Frequently Asked Questions about dig

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

FAQPage Schema
How do I debug system behavior without accidentally modifying codebase files or configs?

Read-only debugging lets you investigate bugs and system behavior by gathering evidence from files and logs without applying changes. The agent stays in investigation mode, analyzing outputs and proposing hypotheses before any modifications occur.

What is the best way to perform incident triage using a CLI agent?

Incident triage with a CLI agent involves guided troubleshooting that clarifies goals, gathers context from logs and configs, and proposes hypotheses. The agent maintains read-only operations by default to ensure safe investigation until root causes are identified.

Can I use a CLI agent for root cause analysis across configs and logs without write access?

Yes, root cause analysis can be performed in investigation-only mode where the CLI agent reads configs and logs to understand system behavior. It explicitly avoids write operations, requiring explicit single-use permission before modifying anything.

How does permission-gated troubleshooting work when investigating bugs?

Permission-gated troubleshooting explains the exact change needed and asks for explicit, single-use approval before modifying files or configs. The agent maintains investigation mode by default and only proceeds with changes after receiving user permission.

When do I need a read-only investigation workflow for my codebase?

A read-only investigation workflow is needed when you want to understand bugs, features, or system behavior before making any modifications. It ensures you can gather evidence and propose hypotheses safely, moving forward with confidence once root causes are clear.

What are the limitations of read-only debugging with CLI agents?

Read-only debugging with CLI agents limits modifications until explicit permission is granted. The agent cannot apply fixes or write changes during investigation mode, meaning all troubleshooting stays analytical until the user approves specific single-use modifications.