linting-audit

Audit ESLint or Biome configuration against an opinionated four-layer baseline.

3|5|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill linting-audit-bensheridanedwards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linting-audit
Source: https://github.com/BenSheridanEdwards/ArchitectPlaybook/tree/main/linting-audit
Command: npx skills add https://github.com/BenSheridanEdwards/ArchitectPlaybook --skill linting-audit-bensheridanedwards

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Lint configurations drift over time: rules get disabled without justification, suppressions pile up, type-aware rules silently no-op, and CI stops enforcing warnings. This Skill audits a TypeScript project's lint setup against an opinionated baseline so misconfiguration is surfaced before it erodes code quality. ## Core Features & Use Cases - Four-layer audit: Evaluates configuration shape, rule coverage, strictness and enforcement, and suppressions hygiene, preceded by a diagnostic snapshot of rule counts and suppression hotspots. - ESLint and Biome support: Auto-detects the installed linter (including dual-installation violations) and dispatches to linter-specific checks such as flat-config format, @typescript-eslint type-checked presets, or Biome domain rule sets. - Static-first with optional run enrichment: Read-only by default; the --with-run flag executes the linter in JSON-reporter mode to enrich findings with real warning and error counts. - Use Case: Run the audit on a React + TypeScript repo to discover that eslint-config-prettier is not last in extends, CI lacks --max-warnings=0, and three files exceed the suppression threshold, then generate an ordered implementation plan for the gaps. ## Quick Start Ask the AI to run /linting-audit on this repository and report the top lint configuration gaps.

Frequently Asked Questions about linting-audit

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

FAQPage Schema
How do I audit my ESLint configuration for gaps?

Run /linting-audit at the repository root of a TypeScript project. It reads your eslint.config file, package.json, source files, and CI workflows, then reports findings across four layers and offers to generate an implementation plan.

Does this lint audit support Biome as well as ESLint?

Yes, the audit auto-detects ESLint or Biome from package.json and configuration files, then dispatches to linter-specific checks. Having both installed is itself reported as a configuration-shape violation.

What is the difference between linting-audit and quality-gates-audit?

quality-gates-audit checks whether linting runs at pre-commit, pre-push, and CI stages, which is a lifecycle question. linting-audit checks whether the lint configuration itself is well-formed, covering rule coverage, strictness, and suppression hygiene.

Will the lint audit modify my configuration or run eslint --fix?

No, the audit is fully read-only and never invokes any linter with --fix or other mutating flags. It only writes report files under .architect-audits/linting-audit and optionally generates a descriptive implementation plan.

What happens if no linter is installed in the project?

The audit continues, marking the linter-foundation check as missing and linter-dependent checks as not-evaluated, while still evaluating independent suppression and CI checks. It recommends installing ESLint or Biome and running quality-gates-audit.

Why did --with-run degrade some checks to partial?

This happens when the lint command fails to start, for example due to a missing binary or invalid configuration. The static analysis still completes, and the findings record a recovery hint to run /preflight --audit=linting --install before retrying.