nav-diagnose

Detect quality drops in AI conversations and prompt re-anchoring to restore collaboration.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill nav-diagnose-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nav-diagnose
Source: https://github.com/qf-studio/navigator/tree/main/skills/nav-diagnose
Command: npx skills add https://github.com/qf-studio/navigator --skill nav-diagnose-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-assisted sessions degrade when the model repeats mistakes, hallucinates files, or drifts from your goal, and users often notice too late. This Skill detects collaboration quality drops early and prompts structured re-anchoring before frustration escalates. ## Core Features & Use Cases - Signal Detection: Analyzes user messages for repeated corrections, hallucination reports, context confusion, goal drift, and frustration patterns using regex-based heuristics. - Severity Classification: Categorizes issues as low, medium, high, or critical and generates a diagnostic report with evidence and suggestions. - Re-anchoring Templates: Provides goal, technical, and communication re-alignment templates to confirm understanding before continuing. - Use Case: After correcting the AI twice about plural REST endpoint naming, the Skill triggers a quality check, acknowledges the correction pattern, and confirms the convention before generating more endpoints. ## Quick Start Ask the AI to run a quality check on the recent conversation because something seems off with its responses.

Frequently Asked Questions about nav-diagnose

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

FAQPage Schema
How do I detect when an AI assistant is misunderstanding me?

Analyze recent user messages for repeated corrections, frustration phrases, and hallucination reports. This Skill classifies these signals by severity and generates a diagnostic report with re-anchoring suggestions to restore alignment.

How to analyze conversation messages for frustration signals in Python?

Use regex pattern matching against message text to detect frustration markers like "ugh", "still not right", or "I already said". The quality_detector.py script aggregates these signals across messages and reports issues above a configurable severity threshold.

When should conversation quality detection not trigger?

It should not trigger on single corrections, new requirements, fresh sessions with insufficient data, or when the user explicitly says things are fine. Over-triggering on normal iteration interrupts productive collaboration flow.

Can quality detection catch silent user frustration?

No, it cannot detect frustration that produces no textual signals, issues outside the conversation context, or problems with external systems. It only identifies patterns explicitly expressed in user messages.

What causes repeated correction loops with AI coding assistants?

Repeated corrections usually mean the model is not incorporating feedback into its working context. The fix is explicit re-anchoring: acknowledge the correction, restate the understood rule, and confirm before generating more output.