mac_doctor

Diagnose and repair macOS issues affecting ProwlrBot installation and runtime.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ProwlrBot/prowlrbot --skill mac-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac_doctor
Source: https://github.com/ProwlrBot/prowlrbot/tree/main/src/prowlrbot/ext/skills/mac_doctor
Command: npx skills add https://github.com/ProwlrBot/prowlrbot --skill mac-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and repairs macOS-specific issues that prevent ProwlrBot from installing, running, or loading local model backends on Apple Silicon and Intel Macs.

Core Features & Use Cases

  • Progressive diagnostic ladder covering environment, Python, Gatekeeper, networking, and performance issues.
  • Apple Silicon and Intel compatibility with guidance for ML backends (Ollama, MLX, llama.cpp) and local backends.
  • Real-world use cases including installation failures, port conflicts, SSL cert issues, and Gatekeeper blocks.
  • Use Case: When ProwlrBot won't install or runs slowly on macOS, follow Mac Doctor steps to repair the environment and reload modules.

Quick Start

Invoke the Mac Doctor diagnostic flow to identify and repair macOS-specific issues affecting ProwlrBot on both Apple Silicon and Intel Macs.

Frequently Asked Questions about mac_doctor

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

FAQPage Schema
How do I fix ProwlrBot installation failures on macOS?

ProwlrBot installation failures on macOS are resolved by running the Mac Doctor diagnostic ladder to identify environment, Python, and Gatekeeper blocks. It applies safe remediation steps with post-repair verification to ensure successful module loading and installation.

Why does Gatekeeper block Python scripts from running on macOS?

Gatekeeper blocks Python scripts on macOS to enforce security by preventing unverified code execution. The Mac Doctor diagnostic flow identifies these Gatekeeper blocks and applies safe remediation steps to allow verified ProwlrBot runtime components to execute properly.

Does the Mac Doctor diagnostic flow support both Apple Silicon and Intel Macs?

Yes, the Mac Doctor diagnostic flow supports both Apple Silicon and Intel Macs. It addresses environment, Python, networking, and performance problems across both architectures, providing specific compatibility guidance for local ML backends like Ollama and MLX.

How do I troubleshoot slow local model backends on macOS?

To troubleshoot slow local model backends on macOS, use Mac Doctor to run its progressive diagnostic ladder covering performance and environment issues. It diagnoses runtime problems affecting Ollama, MLX, and llama.cpp, applying repairs with post-repair verification.

What is the best way to resolve SSL certificate and port conflicts on macOS?

The best way to resolve SSL certificate and port conflicts on macOS is through the Mac Doctor diagnostic ladder. It identifies networking and environment problems and enforces safe remediation with defined prerequisites to restore proper ProwlrBot connectivity.