code-investigator

Investigate code to confirm specifications and generate evidence-based reports with file/line references.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/atman-33/skills --skill code-investigator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-investigator
Source: https://github.com/atman-33/skills/tree/main/skills/code-investigator
Command: npx skills add https://github.com/atman-33/skills --skill code-investigator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill systematically investigates code to confirm specifications and provide evidence-based reports with precise file/line references. It also saves findings to a persistent memory for future reference and can generate flow diagrams to visualize complex interactions.

Core Features & Use Cases

  • Evidence-based specification confirmation: Trace code to verify behavior with exact file/line evidence.
  • Visual flow documentation: Generate Mermaid diagrams for multi-file or complex workflows.
  • Persistent memory storage: Save investigations in a searchable format for future reuse.
  • Uncertainty handling: Clearly distinguish confirmed facts from unknowns and track runtime dependencies.

Quick Start

  1. Start a new investigation by specifying a target codebase path.
  2. Plan the investigation scope, identify entry points, and trace call chains.
  3. Generate a report with confirmed specifications and an optional Mermaid diagram, then save to memory.

Frequently Asked Questions about code-investigator

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

FAQPage Schema
How do I trace code to confirm specifications with exact file and line references?

Code investigation traces call chains from identified entry points to confirm specifications, providing evidence-based reports with precise file and line references. It distinguishes confirmed facts from unknowns and tracks runtime dependencies.

What is the best way to investigate a bug by understanding current code behavior?

Bug investigation requires understanding current code behavior by systematically tracing execution paths. This approach identifies entry points, follows call chains, and generates reports with exact evidence, explicitly noting any uncertainties encountered during the trace.

Can I generate Mermaid diagrams to visualize multi-file code workflows?

Yes, visual flow documentation generates Mermaid diagrams for multi-file or complex workflows. This visualizes interactions traced during the code investigation, helping you understand intricate call chains and system behaviors.

How do I save code investigation findings for future reference?

You can save investigation findings to persistent memory storage. This stores the confirmed specifications and evidence-based reports in a searchable format, ensuring future reuse without needing to re-trace the same code paths.

Does this code investigation approach handle uncertainty in runtime dependencies?

Yes, uncertainty handling clearly distinguishes confirmed facts from unknowns and tracks runtime dependencies. When tracing code to verify behavior, it explicitly notes areas where specifications cannot be fully confirmed due to dynamic runtime conditions.

What are the limitations of evidence-based code investigation for complex systems?

Evidence-based code investigation is limited by runtime dependencies and unknowns that cannot be statically traced. It explicitly notes these uncertainties in its reports, ensuring you understand which specifications are confirmed facts versus dynamic behaviors requiring runtime analysis.