Browserslist Validator

Validate .browserslistrc files and browserslist config in package.json for syntax errors, deprecated browsers, redundant queries, and best practices. Use whe...

Security Scan

The skill is internally consistent: it validates browserslist configs using a bundled Python script, requests no credentials or installs, and its instructions match its stated purpose.

Purpose & Capability

Name/description (browserslist validation) matches the delivered assets: SKILL.md documents commands that run the included Python validator and there are no unrelated environment variables, binaries, or install steps requested.

Instruction Scope

SKILL.md instructs the agent to run the included script against .browserslistrc or package.json. The script reads provided files and produces validation output; the instructions do not ask the agent to read other unrelated files, contact external endpoints, or exfiltrate data.

Install Mechanism

There is no install spec (instruction-only skill + bundled script). No network downloads, package installs, or archive extraction are required.

Credentials

The skill requires no environment variables, credentials, or config paths. The bundled script operates on local files supplied by the user (as expected for a linters/validator).

Persistence & Privilege

always is false and the skill does not request elevated or persistent presence. It does not modify other skills or system-wide settings in the provided materials.

Assessment

This skill appears to do exactly what it claims: a Python-based validator for browserslist configs. Before running: ensure you trust the source of the skill (it contains an executable script), have Python 3 available, and run the validator only on files you intend to analyze (it reads files you point it at). If you want extra assurance, open and review scripts/browserslist_validator.py locally (it contains no network calls or hidden endpoints in the provided content).

Validate .browserslistrc files and browserslist entries in package.json for syntax errors, deprecated browsers, redundant queries, and best practices.

Commands

# Full validation (all rules)
python3 scripts/browserslist_validator.py validate .browserslistrc

# Validate browserslist in package.json
python3 scripts/browserslist_validator.py validate package.json

# Quick syntax-only check
python3 scripts/browserslist_validator.py check .browserslistrc

# Estimate coverage
python3 scripts/browserslist_validator.py coverage .browserslistrc

# Explain each query in human-readable form
python3 scripts/browserslist_validator.py explain .browserslistrc

# JSON output
python3 scripts/browserslist_validator.py validate .browserslistrc --format json

# One-line PASS/WARN/FAIL summary
python3 scripts/browserslist_validator.py validate .browserslistrc --format summary

# Strict mode (warnings become errors)
python3 scripts/browserslist_validator.py validate .browserslistrc --strict

# Target environment
python3 scripts/browserslist_validator.py validate .browserslistrc --env production

Rules (20)

#	Category	Severity	Rule
S1	Syntax	E	File not found or unreadable
S2	Syntax	E	Empty config (no queries)
S3	Syntax	E	Invalid query syntax / unknown browser name
S4	Syntax	W	Duplicate queries
B1	Browsers	W	Dead/deprecated browser (IE, Blackberry, etc.)
B2	Browsers	W	Browser with <0.01% global usage
B3	Browsers	E	Browser version does not exist (e.g. Chrome 999)
B4	Browsers	E	Unknown browser name
Q1	Queries	W	Redundant query (covered by broader query)
Q2	Queries	W	Conflicting queries (e.g. > 1% and < 0.5%)
Q3	Queries	E	not dead without any positive query
Q4	Queries	W	Empty result after not negation
C1	Coverage	W	Very low total coverage (<80%)
C2	Coverage	W	Very high coverage (>99.5%, may include dead browsers)
C3	Coverage	I	No mobile browser coverage hint
C4	Coverage	I	No country-specific override detected
P1	Best Practices	W	IE queries present (recommend dropping IE)
P2	Best Practices	W	Unreasonably old versions (last 20 versions)
P3	Best Practices	W	all query used (too broad)
P4	Best Practices	W	Version pinning instead of range (Chrome 90)

Output Formats

• text (default): Human-readable with [E]/[W]/[I] severity prefix
• json: Machine-readable structured output
• summary: Single-line PASS / WARN / FAIL

Exit Codes

• 0 — No errors
• 1 — Errors found (or warnings in --strict mode)
• 2 — File not found or parse error