pixie-doctor

Name: pixie-doctor
Availability: InStock
Author: alexkapadia

Diagnoses Pixie installation health across server, database, ports, dashboard, venv, Python, and uv versions.

6|1|Updated May 17, 2026

Search Tags:#python #uv #diagnostics #startup #health-check #pixie

Ready to run

npx skills add https://github.com/AlexKapadia/Pixie --skill pixie-doctor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: pixie-doctor
Source: https://github.com/AlexKapadia/Pixie/tree/main/.claude/skills/pixie-doctor
Command: npx skills add https://github.com/AlexKapadia/Pixie --skill pixie-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses Pixie ITSELF - server, database, ports, dashboard, .venv, Python and uv versions. Use when the user says Pixie won't start, the dashboard is broken, or tools aren't showing up. Do NOT use if one named tool is broken (debug-tool) or just checking status (pixie-status).

Core Features & Use Cases

Health checks: validates the host environment, Python/uv versions, and tool readiness to surface root causes.
Status report: provides a markdown summary with a prioritized fixes list.
Guided remediation: suggests concrete steps to restore Pixie to a healthy state and reappear in the UI.

Quick Start

Ask it to run a full Pixie installation health check and report any recommended fixes.

Frequently Asked Questions about pixie-doctor

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

FAQPage Schema

How do I run a Pixie health check to diagnose startup issues?▼

Run a full Pixie health check to diagnose startup issues by validating the host environment, Python and uv versions, server status, ports, and database readability to surface root causes.

Why is my Pixie dashboard broken and tools not showing up?▼

A broken Pixie dashboard or missing tools often stems from environment failures, incorrect Python and uv versions, or unreadable pixie.db and tools directories, which a full diagnostic health check identifies.

Do I need Python 3.12 and uv installed for Pixie to work?▼

Yes, Pixie requires Python version 3.12 or higher and the uv package manager to be present for a healthy installation, proper tool registration, and successful startup.

What is the best way to fix Pixie installation and database problems?▼

Fix Pixie installation and database problems by running a diagnostic check that generates a markdown status report with a prioritized list of concrete remediation steps to restore system health.

When should I not use a Pixie diagnostic health check?▼

Avoid using a Pixie diagnostic health check when only a single named tool is broken or if you just need to check status, as it specifically diagnoses system-wide startup, dashboard accessibility, and tool registration issues.