oxsecurity/megalinter

diagnose-config

Diagnose MegaLinter .mega-linter.yml configuration issues. Use when linters aren't running as expected or configuration seems wrong.

First seen Aug 3, 2026

Installation

$ npx skills add oxsecurity/megalinter --skill diagnose-config

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from oxsecurity/megalinter · top by installs.

npx skills add oxsecurity/megalinter

Browse all from oxsecurity/megalinter

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 2.6K
License LICENSE
Default branch main
Open issues 25
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsRead Grep Glob
More metadata
internal
1

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,890 B
  • docs SUMMARY.md 155 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3 installs

SKILL.md

Diagnose MegaLinter configuration. Read the .mega-linter.yml (or path provided in $ARGUMENTS) and check for:

  1. Configuration hierarchy: Env vars override .mega-linter.yml, which overrides descriptor defaults. Both .mega-linter.yml and .megalinter.yml are recognized.
  2. ENABLE/DISABLE conflicts: ENABLELINTERS/DISABLELINTERS take precedence over ENABLE/DISABLE (descriptor-level). You can't enable a linter if its descriptor is disabled.
  3. Filter patterns: Validate FILTERREGEXINCLUDE/FILTERREGEXEXCLUDE regex syntax
  4. Linter variable naming: Must be UPPERCASE with separator matching the generated name DESCRIPTORLINTERNAME (e.g., PYTHONPYLINTARGUMENTS, not pylint_arguments)
  5. Flavor compatibility: If using a flavor image, verify the enabled linters exist in that flavor by checking flavors/<flavor>/flavor.json
  6. EXTENDS: If using remote config inheritance via HTTPS URLs, verify they're accessible
  7. APPLY_FIXES: Check the fix mode is compatible with the CI system — auto-commit requires write access to the branch
  8. Pre/Post commands: Validate PRECOMMANDS and POSTCOMMANDS syntax (each needs command and cwd fields, cwd is root or workspace)
  9. Common mistakes:

- Using lowercase linter names (must be UPPERCASE) - Missing separator in linter-specific vars - Setting VALIDATEALLCODEBASE=true in CI (slow — usually want diff-only) - Forgetting {LINTER}FILTERREGEXINCLUDE/EXCLUDE overrides global filters

Reference megalinter/config.py for the full resolution logic.