config-doctor

Compare Squadrant default settings against user customizations to identify configuration drift.

2|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/tu11aa/squadrant --skill config-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: config-doctor
Source: https://github.com/tu11aa/squadrant/tree/main/plugin/skills/config-doctor
Command: npx skills add https://github.com/tu11aa/squadrant --skill config-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Helps you reconcile discrepancies in Squadrant configurations, ensuring they align with your desired settings and defaults.

Core Features & Use Cases

  • Identify and Address Configuration Drift: Surfaces any changes from default configurations that need review.
  • Change Defaults and Invalid Values: Manages 'changed-default' and 'invalid' values identified by squadrant config check.
  • User Decision Making: Allows users to adopt new defaults or maintain their customized values.

Quick Start

Run squadrant config check --json to get a structured drift report, and follow the steps provided to resolve configuration issues.

Frequently Asked Questions about config-doctor

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

FAQPage Schema
How do I detect configuration drift in my project settings?

Configuration drift is detected by running `squadrant config check --json` to generate a structured report. This command surfaces discrepancies between default settings and custom values, identifying any 'changed-default' or 'invalid' values that require review.

What is configuration drift and how does it affect project management?

Configuration drift occurs when customized project settings deviate from required defaults over time. It causes inconsistencies across environments, making project management unpredictable and requiring manual reconciliation to align configurations with desired standards.

How do I resolve invalid configuration values in Squadrant?

To resolve invalid configuration values in Squadrant, execute the config check command and manually input decisions based on the generated report. You can choose to adopt new default settings or maintain your existing customized values for each discrepancy.

Do I need to manually review every configuration discrepancy?

Yes, resolving configuration discrepancies requires manual input to decide whether to adopt new defaults or maintain customized values. The tool surfaces the changes from default configurations, but the user must make the final decision for each issue.

What's the best way to correct customized settings that differ from defaults?

The best way to correct customized settings is to use a CLI tool that compares current values against defaults and suggests resolutions. This allows you to systematically review each discrepancy and decide whether to revert to defaults or keep customizations.

When should I run a configuration check for my project?

You should run a configuration check when you suspect settings have diverged from your requirements or after updates that might introduce new defaults. It helps identify configuration drift early and ensures your project aligns with desired standards.