debug-tool

Community

Diagnose and fix Pixie tools fast.

AuthorAlexKapadia
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Diagnoses and fixes ONE Pixie tool that fails validation, crashes, hangs, or returns wrong output – validator-first. Use when the user reports a broken tool, a tool that crashes, or outputs incorrect results. Do NOT use if Pixie itself is broken (pixie-doctor), for style (lint-tool), or just logs (view-logs).

Core Features & Use Cases

  • Validator-first diagnosis: runs the Pixie validator to locate failures and guide repairs.
  • Kill file-guided fixes: reads .build/KILL_FILE.md entries related to the symptoms and applies documented fixes.
  • Guided remediation: proposes concrete edits, then re-validates until the tool passes.

Quick Start

Diagnose a failing tool by starting with the validator, then follow its guided steps to identify, read the kill file, propose a fix, and re-run validation.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: debug-tool
Download link: https://github.com/AlexKapadia/Pixie/archive/main.zip#debug-tool

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.