lint-and-validate
Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers onKeywords: lint, format, check, validate, types, static analysis.
When & Why to Use This Skill
The Lint and Validate skill automates essential quality control procedures, including linting, static analysis, and type checking. Designed for modern development workflows, it ensures code correctness and adherence to project standards across Node.js, TypeScript, and Python environments by enforcing a strict 'Quality Loop' after every modification, effectively reducing technical debt and preventing runtime errors.
Use Cases
- Automated Code Linting: Instantly identify and fix stylistic and syntax issues using tools like ESLint and Ruff to maintain a clean and consistent codebase.
- Static Type Analysis: Prevent complex runtime bugs by performing rigorous type checking with TypeScript (tsc) and MyPy during the development process.
- Security Vulnerability Scanning: Proactively detect high-level security risks in project dependencies and source code using integrated tools like npm audit and Bandit.
- Standardized Development Workflow: Implement a mandatory validation step that ensures no code is committed or marked as complete without passing predefined quality benchmarks.
| name | lint-and-validate |
|---|---|
| description | Automatic quality control, linting, and static analysis procedures. Use after every code modification to ensure syntax correctness and project standards. Triggers onKeywords: lint, format, check, validate, types, static analysis. |
| allowed-tools | Read, Glob, Grep, Bash |
Lint and Validate Skill
MANDATORY: Run appropriate validation tools after EVERY code change. Do not finish a task until the code is error-free.
Procedures by Ecosystem
Node.js / TypeScript
- Lint/Fix:
npm run lintornpx eslint "path" --fix - Types:
npx tsc --noEmit - Security:
npm audit --audit-level=high
Python
- Linter (Ruff):
ruff check "path" --fix(Fast & Modern) - Security (Bandit):
bandit -r "path" -ll - Types (MyPy):
mypy "path"
The Quality Loop
- Write/Edit Code
- Run Audit:
npm run lint && npx tsc --noEmit - Analyze Report: Check the "FINAL AUDIT REPORT" section.
- Fix & Repeat: Submitting code with "FINAL AUDIT" failures is NOT allowed.
Error Handling
- If
lintfails: Fix the style or syntax issues immediately. - If
tscfails: Correct type mismatches before proceeding. - If no tool is configured: Check the project root for
.eslintrc,tsconfig.json,pyproject.tomland suggest creating one.
Strict Rule: No code should be committed or reported as "done" without passing these checks.
Scripts
| Script | Purpose | Command |
|---|---|---|
scripts/lint_runner.py |
Unified lint check | python scripts/lint_runner.py <project_path> |
scripts/type_coverage.py |
Type coverage analysis | python scripts/type_coverage.py <project_path> |