nestjs config doctor

    by Saeed Gholami

    3

    Diagnoses NestJS ConfigModule, .env, and Docker/Kubernetes environment failures — finds missing vars and misconfigurations before your app boots.

    Free

    1 installNo reviews yet

    Works with the AI tools you already use

    CClaude CodeCCursorCCodex CLIGGitHub CopilotGGemini CLIVVS CodeWWindsurf+15 more

    About this skill

    Overview

    NestJS Config & Environment Doctor is a specialized diagnostic skill for NestJS applications that fail to start, load incorrect configuration, or behave differently across local, container, and Kubernetes environments. It performs structured, evidence-based analysis of your configuration layer and delivers actionable remediation guidance.

    The Problem

    NestJS configuration failures are among the most common blockers before production deployment. Applications may boot with missing environment variables, fail silently when ConfigService.get() returns undefined, or work locally while breaking in Docker or Kubernetes due to misaligned Secret keys or missing validation. Generic debugging prompts do not follow a repeatable NestJS-specific diagnostic process.

    What This Skill Does

    • Executes a 14-point diagnostic matrix across ConfigModule, environment files, and deployment configuration
    • Determines configuration health status: BROKEN, MISCONFIGURED, or OK
    • Identifies root cause with file-level evidence and severity-ranked findings
    • Maps environment variables to their usage across the codebase
    • Generates a complete .env.example template from project analysis
    • Validates Docker ENV injection and Kubernetes Secret/ConfigMap key alignment
    • Recommends Joi or Zod startup validation patterns where validation is missing

    Supported Stack

    NestJS 9–11, @nestjs/config, Joi, Zod, Docker, Kubernetes ConfigMap and Secret resources.

    Ideal Use Cases

    • Application fails to start with configuration-related errors
    • ConfigService returns undefined for expected variables
    • Service runs locally but fails in Docker or Kubernetes
    • Startup validation errors from Joi or Zod schemas
    • Generating .env.example for team onboarding or CI/CD pipelines

    Security & Privacy

    This skill operates read-only and never outputs actual secret values from .env files. Sensitive values are redacted in all diagnostic output.

    Known Limitations

    • Scope is limited to configuration and environment setup
    • Does not perform full production-readiness or security audits
    • Does not connect to live clusters, containers, or databases
    • Does not modify source code unless explicitly requested by the user
    nestjs
    nodejs
    config
    environment
    dotenv
    docker
    kubernates
    devops

    Details

    How to install

    Drop the file into your AI Agent. Works with Claude, Cursor, ChatGPT, and 20+ more.

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    Read Files
    Terminal / Shell

    File Scopes

    nestjs-config-doctor/**
    package.json
    .env*
    .gitignore
    src/**
    **/app.module.ts
    **/main.ts
    Dockerfile
    docker-compose*.yml
    k8s/**
    **/deployment.yaml

    Read Files: Required to inspect package.json, .env files, TypeScript source, Dockerfile, and Kubernetes manifests for configuration issues. Terminal / Shell: Optional helper for ripgrep-based discovery commands referenced in the skill. The agent may also use built-in file search instead. This skill does not require write access, network access, browser access, or host environment variables. It performs read-only analysis of the buyer's project files.

    Creator

    Saeed Gholami

    Frequently Asked Questions

    Browse More Skills

    code-reviewer

    Reviews your code for bugs, security vulnerabilities, logic errors, performance issues, and style violations. Organizes findings by severity and suggests fixes with code examples.

    Free
    7985.0(3)
    humanize-writing

    humanize-writing

    Transform robotic AI drafts into natural, human-sounding prose with native-level flow and tone.

    Free
    2055.0(1)
    frontend-motion-wizard

    frontend-motion-wizard

    Advanced responsive layout and interactive micro-interaction engine for React, Tailwind CSS, and Framer Motion. Automatically injects fluid element states, mobile-first touch behaviors, adaptive viewports, and non-destructive layout transitions into static codebases

    Free
    425.0(2)

    java-best-practice-checker

    Expert Java code auditor for SE 8–24, flagging performance leaks, threading risks, and modernization gaps.

    Free
    365.0(1)

    Free