diagnose

Diagnose codebase problems by inspecting files, git history, and test cases.

2|1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/Vekta/PolyForge --skill diagnose-vekta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/Vekta/PolyForge/tree/main/skills/diagnose
Command: npx skills add https://github.com/Vekta/PolyForge --skill diagnose-vekta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps users pinpoint the root cause of software errors, unexpected behavior, or log entries, determining if it's a bug, configuration issue, or expected behavior.

Core Features & Use Cases

  • Root Cause Analysis: Identifies the fundamental reason behind a reported problem.
  • Severity Assessment: Determines the impact and urgency of the issue.
  • Actionable Recommendations: Suggests concrete next steps, such as creating an issue or attempting a fix.
  • Use Case: When a user encounters a NullPointerException in their application logs, they can use /diagnose to trace the error, understand its origin, and get a clear explanation of why it's happening and how to resolve it.

Quick Start

Use the diagnose skill to investigate the error message "TypeError: Cannot read properties of undefined (reading 'name')".

Frequently Asked Questions about diagnose

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

FAQPage Schema
How do I find the root cause of an unhandled exception in my codebase?

To find the root cause of an unhandled exception, you investigate specific problems within your codebase by inspecting files and tracing git history. This determines the exact origin and classifies the error as a bug, configuration issue, or expected behavior.

What is the best way to troubleshoot unexpected application behavior and log entries?

The best way to troubleshoot unexpected behavior and log entries is to perform detailed error analysis through file inspection and test case correlation. This identifies the fundamental reason behind the problem and assesses its severity.

Can I determine if an error is a bug or a configuration issue?

Yes, you can determine if an error is a bug or a configuration issue. By investigating the reported problem and analyzing its origin, the diagnostic process classifies the issue and provides actionable recommendations for resolving it.

How do I analyze a NullPointerException using git history and test cases?

To analyze a NullPointerException using git history and test cases, you investigate the specific error within the codebase. This correlates test cases with file changes to determine the root cause and severity of the exception.

Does error analysis provide actionable recommendations for fixing software bugs?

Yes, error analysis provides actionable recommendations for fixing software bugs. After determining the root cause and severity of an issue, it suggests concrete next steps such as creating an issue ticket or attempting a code fix.