review-debug

Audit debug logging for ungated disk writes and missing coverage.

1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/cwilliams5/Alt-Tabby --skill review-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-debug
Source: https://github.com/cwilliams5/Alt-Tabby/tree/main/.claude/skills/review-debug
Command: npx skills add https://github.com/cwilliams5/Alt-Tabby --skill review-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill systematically audits debug logging and diagnostic output across a codebase to ensure that all such outputs are properly gated, preventing unnecessary disk writes and overhead in production environments, while also identifying critical gaps in logging coverage.

Core Features & Use Cases

  • Ungated Output Detection: Identifies instances where FileAppend, FileOpen, Tooltip, or other diagnostic writes occur without a corresponding configuration check.
  • Coverage Gap Analysis: Pinpoints failure paths, error conditions, or diagnostic-worthy events that lack any logging, which could hinder debugging efforts.
  • Use Case: A developer can use this Skill to perform a security and performance audit on a new feature's logging implementation, ensuring it adheres to best practices and doesn't introduce performance regressions or security vulnerabilities through excessive or unguarded logging.

Quick Start

Audit all debug logging and diagnostic output across the codebase for ungated disk writes and missing coverage.

Frequently Asked Questions about review-debug

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

FAQPage Schema
How do I find ungated debug logging and diagnostic disk writes in my codebase?

You can find ungated debug logging by auditing diagnostic outputs like FileAppend, FileOpen, and Tooltip writes to ensure they are wrapped in configuration checks. This identifies unguarded disk writes and missing logging coverage on failure paths that cause production overhead.

What is debug logging coverage gap analysis and when do I need it?

Debug logging coverage gap analysis identifies failure paths and error conditions lacking diagnostic logs. You need this when missing context hinders debugging efforts, ensuring critical diagnostic-worthy events are captured while preventing ungated disk write overhead in production.

How do I audit diagnostic output for performance overhead and missing configuration checks?

You audit diagnostic output for overhead by tracing FileAppend and FileOpen calls to verify configuration check wrappers. This validates findings against codebase evidence and call chains, ensuring diagnostic writes do not execute unless explicitly enabled in production.

Can I use parallel exploration agents to audit independent code areas for logging issues?

Yes, you can use parallel exploration agents to audit independent code areas for logging issues. This systematically isolates ungated diagnostic writes and coverage gaps, requiring validation of all findings against codebase evidence and call chains for accuracy.

What are the limitations of auditing debug logging without checking call chains?

Auditing debug logging without checking call chains risks false positives for ungated FileAppend or Tooltip writes. Validation against codebase evidence is required to confirm whether diagnostic outputs are properly gated by upstream configuration checks before reaching production.