lint-and-validate

Runs linters, type checkers, and type coverage analysis for Node.js and Python projects.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill lint-and-validate-helcio-nogueira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lint-and-validate
Source: https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026/tree/main/.agents/skills/lint-and-validate
Command: npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill lint-and-validate-helcio-nogueira

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Code changes often ship with syntax errors, style violations, or missing type annotations because developers skip running linters and type checkers. This Skill enforces a mandatory quality loop after every code modification, automatically detecting the project ecosystem and running the appropriate validation tools. ## Core Features & Use Cases - Unified Lint Runner: Detects Node.js or Python projects and runs the right tools (ESLint, tsc, Ruff, MyPy) with Windows-compatible command handling and a JSON summary report. - Type Coverage Analysis: Measures TypeScript and Python type annotation coverage, counting any/Any usage and untyped functions, then flags critical issues with exit codes. - Use Case: After editing a TypeScript module, ask the assistant to validate the change; it runs npm run lint and npx tsc --noEmit, reports failures, and blocks completion until the audit passes. ## Quick Start Run the lint and type validation checks on my project and fix any reported errors before marking the task done.

Frequently Asked Questions about lint-and-validate

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

FAQPage Schema
How do I run ESLint and TypeScript checks together on a project?▼

Use the lint_runner.py script with the project path as argument. It detects package.json, runs npm run lint or npx eslint, then runs npx tsc --noEmit, and outputs a combined pass/fail JSON summary.

How to check Python type hint coverage in a codebase?▼

Run type_coverage.py against the project directory. It scans Python files, counts functions with and without type hints, measures Any usage, and reports a coverage percentage with pass or fail status.

Does the lint runner work on Windows?▼

Yes, the script handles Windows by appending .cmd to npm and npx commands, enabling shell mode for path resolution, and reconfiguring console output to UTF-8 encoding.

What linters are supported for Python projects?▼

The runner uses Ruff for fast linting and style fixes, MyPy for static type checking, and Bandit for security issue detection. It detects Python projects via pyproject.toml or requirements.txt.

Why does the lint runner report no linters found?▼

This happens when the project lacks package.json, pyproject.toml, or requirements.txt, so no ecosystem is detected. Add the appropriate config file or install ESLint, Ruff, or MyPy to enable checks.

What counts as a type coverage failure?▼

Coverage below 50 percent for TypeScript or 40 percent for Python triggers a critical issue, as does excessive any or Any usage. Critical issues cause the script to exit with code 1.