gk-doctor

Diagnose and auto-remediate environment health issues in Node.js, Python, and Flutter projects.

1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/gkganesh12/gk-stack --skill gk-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gk-doctor
Source: https://github.com/gkganesh12/gk-stack/tree/main/skills-library/gk-doctor
Command: npx skills add https://github.com/gkganesh12/gk-stack --skill gk-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires node, git, npm, eslint, flutter, and includes references (resource) components.

What problem does it solve?

This skill eliminates session-wasting environment failures by proactively identifying and auto-remediating configuration drift, missing dependencies, and structural issues in development projects.

Core Features & Use Cases

  • Automated Health Checks: Validates node_modules integrity, git state, TypeScript path resolution, and framework-specific configurations like Tailwind and Vite.
  • Safe Auto-Remediation: Automatically fixes common issues like missing dependencies or incorrect file permissions while flagging complex problems for human review.
  • Use Case: Before starting a coding session, run this skill to ensure your environment is healthy, preventing the common pattern of spending the first 20 minutes of a session debugging configuration errors.

Quick Start

Run the doctor skill to diagnose your current project environment and apply any necessary automatic fixes.

Frequently Asked Questions about gk-doctor

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

FAQPage Schema
How do I run an environment health check for my Node.js or Flutter project?

To run an environment health check, execute the diagnostic skill to validate node_modules integrity, git state, and TypeScript path resolution. It safely auto-remediates common configuration drift and missing dependencies while flagging complex issues for manual review.

Why does my development environment have configuration drift and missing dependencies?

Configuration drift and missing dependencies occur when project files fall out of sync with version control or package manifests. The health check identifies these mismatches by validating framework-specific configurations like Tailwind and Vite, then safely auto-remediates them.

Can I automatically fix node_modules integrity issues without breaking my project setup?

You can automatically fix node_modules integrity issues through safe, non-destructive diagnostic routines. The auto-remediation prioritizes system stability by applying fixes for missing dependencies and incorrect file permissions while preserving your existing project configuration.

What's the best way to diagnose dependency drift across Node.js, Python, and Flutter environments?

The best way to diagnose dependency drift is using a comprehensive health check that targets common failure modes across Node.js, Python, and Flutter environments. It validates framework-specific configurations and automatically resolves detected inconsistencies to restore developer productivity.

Does automated environment diagnostics work with Vite and Tailwind configurations?

Automated environment diagnostics fully support Vite and Tailwind configurations. The health check validates these framework-specific setups alongside git state and TypeScript path resolution, ensuring your development environment is fully consistent before you start coding.

What should I do when auto-remediation flags complex configuration mismatches for human review?

When auto-remediation flags complex configuration mismatches for human review, you should manually inspect the structural issues. The diagnostics safely resolve missing dependencies automatically but deliberately avoids altering intricate file system inconsistencies that risk system stability.