Skill

doctor

Check qult health for the current project. Verifies state files, gates, and MCP server connectivity. Use when hooks don't fire, gates seem broken, or after initial setup to confirm everything works. NOT for checking session progress (use /qult:status instead).

Install

npx claudepluginhub hir4ta/qult --plugin qult

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Diagnose qult setup issues in the current project.

SKILL.md

Similar Skills

test-driven-development

1 file

Guides strict Test-Driven Development (TDD): write failing tests first for features, bugfixes, refactors before any production code. Enforces red-green-refactor cycle.

antigravity-bundle-qa-testing

32.8k

systematic-debugging

10 files

Guides systematic root cause investigation for bugs, test failures, unexpected behavior, performance issues, and build failures before proposing fixes.

antigravity-bundle-qa-testing

32.8k

ab-test-setup

Guides A/B test setup with mandatory gates for hypothesis validation, metrics definition, sample size calculation, and execution readiness checks.

antigravity-bundle-qa-testing

32.8k

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitApr 4, 2026

Actions

View Source View Plugin View on GitHub View README

/qult:doctor

Diagnose qult setup issues in the current project.

Checks

.qult/ directory: Exists with .state/ subdirectory

Gates: .qult/gates.json exists and has at least one gate in on_write or on_commit

Plugin hooks: Verify hooks.json exists at ${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json via Bash: test -f "${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json" && echo OK || echo FAIL

Fallback hooks: Check if .claude/settings.local.json has qult hook entries. Report as [INFO] if present (fallback active) or [INFO] if absent (plugin-only mode)

Legacy files: Warn if any of these exist — suggest running /qult:init to clean up:

.qult/hook.mjs (old standalone hook)
.claude/rules/qult-gates.md (replaced by MCP instructions)
.claude/rules/qult-quality.md (replaced by MCP instructions)
.claude/rules/qult-plan.md (replaced by MCP instructions)
.claude/rules/qult.md (old single rule file)
Old settings.local.json hook entries containing .qult/hook.mjs

MCP server: Call mcp__plugin_qult_qult__get_gate_config() to verify the MCP server is responding

Pending fixes: Call mcp__plugin_qult_qult__get_pending_fixes() to check for stale errors

Session state: Call mcp__plugin_qult_qult__get_session_status() to verify state tracking works

Output format

Report each check as OK, INFO, WARN, or FAIL with details:

[OK] .qult/.state/ directory exists [OK] gates.json: 2 on_write, 1 on_commit gates [OK] plugin active (skills accessible) [INFO] fallback hooks: not registered (plugin-only mode). Run /qult:register-hooks if hooks don't fire. [WARN] legacy file: .claude/rules/qult-gates.md exists — run /qult:init to clean up [OK] MCP server responding

Fix suggestions

For each issue, suggest the fix:

Missing .qult/: Run /qult:init

Missing gates: Run /qult:init

Legacy files: Run /qult:init (cleans up automatically)

Hooks not firing: Run /qult:register-hooks

MCP not responding: Check plugin is enabled via /plugin

/qult:doctor

Diagnose qult setup issues in the current project.

Checks

.qult/ directory: Exists with .state/ subdirectory
Gates: .qult/gates.json exists and has at least one gate in on_write or on_commit
Plugin hooks: Verify hooks.json exists at ${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json via Bash: test -f "${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json" && echo OK || echo FAIL
Fallback hooks: Check if .claude/settings.local.json has qult hook entries. Report as [INFO] if present (fallback active) or [INFO] if absent (plugin-only mode)
Legacy files: Warn if any of these exist — suggest running /qult:init to clean up:
- .qult/hook.mjs (old standalone hook)
- .claude/rules/qult-gates.md (replaced by MCP instructions)
- .claude/rules/qult-quality.md (replaced by MCP instructions)
- .claude/rules/qult-plan.md (replaced by MCP instructions)
- .claude/rules/qult.md (old single rule file)
- Old settings.local.json hook entries containing .qult/hook.mjs
MCP server: Call mcp__plugin_qult_qult__get_gate_config() to verify the MCP server is responding
Pending fixes: Call mcp__plugin_qult_qult__get_pending_fixes() to check for stale errors
Session state: Call mcp__plugin_qult_qult__get_session_status() to verify state tracking works

Output format

Report each check as OK, INFO, WARN, or FAIL with details:

[OK] .qult/.state/ directory exists
[OK] gates.json: 2 on_write, 1 on_commit gates
[OK] plugin active (skills accessible)
[INFO] fallback hooks: not registered (plugin-only mode). Run /qult:register-hooks if hooks don't fire.
[WARN] legacy file: .claude/rules/qult-gates.md exists — run /qult:init to clean up
[OK] MCP server responding

Fix suggestions

For each issue, suggest the fix:

Missing .qult/: Run /qult:init
Missing gates: Run /qult:init
Legacy files: Run /qult:init (cleans up automatically)
Hooks not firing: Run /qult:register-hooks
MCP not responding: Check plugin is enabled via /plugin