skills.rest
AlexKapadia
AlexKapadiaCOMMUNITY
Explore all skills by this author →
GitHub

pixie-doctor

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
One-click install
npx skills add https://github.com/AlexKapadia/Pixie --skill pixie-doctor
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
birgitta410birgitta410
15

_local-setup

Automate local installation and configuration of the sensors-cli development environment.

Community
Basic
growthxaigrowthxai
430

output-services-check

Verify Docker containers, API server, and Temporal UI health during local development.

Official
Intermediate
AlexKapadiaAlexKapadia
6

revalidate-all

Re-run Pixie validation across all tools and summarize pass/warn/fail results.

Community
Advanced
EdanStarfireEdanStarfire
15

backend-tester

Run isolated backend test environments on port 8001 with curl.

Community
Intermediate