qsd-doctor

Audit qsd deployments for planning artifact and runtime configuration integrity.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/thecomputer07/qsd --skill qsd-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qsd-doctor
Source: https://github.com/thecomputer07/qsd/tree/main/skills/qsd-doctor
Command: npx skills add https://github.com/thecomputer07/qsd --skill qsd-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate the health of a qsd installation by performing sanity checks on planning artifacts and runtime configurations.

Core Features & Use Cases

  • Eight checks including checkpoints validity, latest.json presence, settings.hooks consistency, no-symlink constraint, hook-log tail monitoring, intel-manifest availability, checkpoint prune warnings, and policy-drift detection.
  • Use cases include pre-session health validation and post-change regression checks across branches.

Quick Start

Run the doctor with the qsd CLI to validate your installation health.

Frequently Asked Questions about qsd-doctor

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

FAQPage Schema
How do I validate the integrity of planning artifacts in a long-running session?

To validate planning artifacts in long-running sessions, run a health-check via the qsd CLI to audit checkpoints, LATEST.json, and intel manifests, returning zero on success and non-zero on failure.

What does a qsd deployment health-check include?

A deployment health-check includes eight distinct checks covering checkpoints validity, LATEST.json presence, settings.hooks consistency, no-symlink constraint, hook-log tail monitoring, intel-manifest availability, and policy-drift detection.

Do I need node installed to run a qsd deployment doctor check?

Yes, you need node installed because the doctor check runs via the qsd CLI, which requires a node environment to execute its eight validation checks across branches and installations.

When should I run a deployment health-check for qsd?

You should run a deployment health-check for pre-session health validation and post-change regression checks to ensure the integrity of runtime configurations and planning artifacts across different branches.

How do I detect policy-drift and settings.hooks inconsistency in my qsd installation?

To detect policy-drift and settings.hooks inconsistency, execute the doctor command via the qsd CLI, which performs targeted sanity checks on your runtime configurations and emits a non-zero code upon detecting drift.

What is the best way to monitor hook-log tails and checkpoint prune warnings?

The best way to monitor hook-log tails and checkpoint prune warnings is by running the doctor validation, which audits these specific runtime configurations and planning artifacts to verify overall installation health.