config-lint

Validate and fix AI assistant configuration files for Anthropic and GitHub compliance.

Updated May 7, 2026
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill config-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: config-lint
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/config-lint
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill config-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually validating and fixing fragmented AI assistant configuration files (Claude Code skills, hooks, MCP servers, GitHub Copilot instructions, and CLAUDE.md files) for compliance with official Anthropic and GitHub best practices is time-consuming and error-prone, especially for team-shared projects where configuration consistency is critical.

Core Features & Use Cases

  • Unified multi-linter workflow: Runs 5 specialized linters in a single pass to cover all common AI assistant config types, eliminating the need to use separate tools for skills, hooks, MCP, Copilot instructions, and CLAUDE.md files.
  • Auto-remediation support: Automatically fixes common structural issues (such as deprecated hook output formats or missing required frontmatter fields) when run with the --fix flag.
  • Use Case: A developer preparing a new Claude Code project for team collaboration can use this skill to audit all configuration files before committing them to the repository, ensuring they meet governance standards and avoid common pitfalls like hardcoded secrets or invalid hook matchers.

Quick Start

Use the config-lint skill to validate and fix all AI assistant configuration files in your current project for compliance with official best practices.

Frequently Asked Questions about config-lint

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

FAQPage Schema
How do I validate AI assistant configuration files for best practices compliance?

You can validate AI assistant configuration files by running a unified multi-linter pass that checks Claude Code skills, hooks, MCP servers, GitHub Copilot instructions, and CLAUDE.md files against official Anthropic and GitHub standards, generating a report with severity tags and remediation guidance.

Can I automatically fix structural issues in Claude Code hook configurations and MCP settings?

Yes, you can automatically fix structural issues in Claude Code hook configurations and MCP settings by running the linter with the auto-remediation flag, which corrects problems like deprecated hook output formats and missing required frontmatter fields.

What is the best way to audit GitHub Copilot instruction files before committing to a team repository?

The best way to audit GitHub Copilot instruction files before committing is to use a unified config linter that checks for governance standards, hardcoded secrets, and structural compliance across both local and team-shared project environments in a single pass.

Does config linting support read-only validation for specific AI assistant config types?

Yes, config linting supports read-only validation and targeted linting of specific AI assistant config types, allowing you to audit Claude Code skill definitions, hook configurations, MCP server settings, or CLAUDE.md project memory files individually without applying automatic fixes.

Why should I lint CLAUDE.md project memory files for team-shared projects?

You should lint CLAUDE.md project memory files for team-shared projects because manual validation is error-prone, and linting ensures configuration consistency, prevents common pitfalls like invalid hook matchers, and enforces compliance with official best practices across the team.