pmai-doctor

Diagnoses PMAI framework installations and consumer repository health with read-only checks.

4|Updated May 26, 2026
One-click install
npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-doctor-yyg501
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmai-doctor
Source: https://github.com/YYG501/PM-AI-Harness/tree/main/skills/doctor
Command: npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-doctor-yyg501

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working with the PMAI product workflow framework, it is hard to tell whether the framework itself, the host AI tool integration, or the current project repository is misconfigured. This Skill runs a structured, read-only diagnostic that separates framework health from project progress and tells you exactly what needs fixing. ## Core Features & Use Cases - Read-only diagnostics: Runs pmai doctor --check --json and reports seven fixed check areas covering installation, AI tool integration, required project files, documentation, prototypes, active work, and project safety. - Version verification: When the local CLI cannot confirm whether a newer PMAI version exists, it requests host-authorized network access to compare the remote main branch commit against the installed head. - Gated repair workflow: Every fix (framework upgrade, hook reinstallation, consumer entry sync, legacy cleanup, compatibility declarations) requires explicit PM confirmation before execution, followed by a re-check. - Use Case: You return to a project after weeks away and are unsure whether PMAI is up to date and the repo structure is still valid. Run the doctor to get a one-line conclusion, a full seven-item report, and a prioritized list of issues to resolve. ## Quick Start Ask the AI to check whether PMAI and the current project are healthy using the pmai-doctor skill.

Frequently Asked Questions about pmai-doctor

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

FAQPage Schema
How do I check if my PMAI installation is healthy?

Run the pmai-doctor skill, which executes pmai doctor --check --json and reports seven check areas: installation, AI tool integration, required files, documentation, prototypes, active work, and project safety. It gives a single conclusion plus a full per-item report.

What is the difference between pmai-doctor and pmai-status?

pmai-status only reports product progress, the current module, and the next step. pmai-doctor only reports framework health, available upgrades, and whether the consumer repository structure matches the installed version.

Can pmai-doctor fix problems automatically?

No. The skill is read-only by default. Repairs such as framework upgrades, hook reinstallation, entry sync, or legacy cleanup each require explicit PM confirmation, and only one confirmed repair action is executed at a time before re-checking.

Does pmai-doctor work in a directory without an initialized project?

Yes. It can run in a consumer repository, a plain Git repository, or an uninitialized directory. It does not require PRODUCT-STATE.md and does not execute the project preamble.

Why does pmai-doctor say the version cannot be confirmed?

When the local CLI reports update availability as unknown, the skill must request host-authorized network access to compare the remote main branch commit. If the host denies access or the query times out, it reports the version as temporarily unconfirmable rather than guessing.