/configure:linting

Check and configure linting tools against modern best practices.

When to Use This Skill

Use this skill when...	Use another approach when...
Setting up modern linting (Biome, Ruff, Clippy)	Just running linter (use /lint:check skill)
Migrating from ESLint/Prettier to Biome	Linters already properly configured
Validating linter configuration	Fixing specific lint errors (run linter and fix)
Ensuring language-specific best practices	Simple script with no linting needs
Configuring pre-commit lint integration	Debugging linter issues (check linter logs)

Context

• Project root: !pwd
• Biome config: !find . -maxdepth 1 -name 'biome.json' -o -name 'biome.jsonc'
• Ruff config: !grep -l 'tool.ruff' pyproject.toml
• Clippy config: !grep -l 'lints.clippy' Cargo.toml
• Legacy linters: !find . -maxdepth 1 \( -name '.eslintrc*' -o -name '.flake8' -o -name '.pylintrc' \)
• Package files: !find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' \)
• Pre-commit config: !find . -maxdepth 1 -name '.pre-commit-config.yaml'
• CI workflows: !find .github/workflows -maxdepth 1 -name '*.yml'

Parameters

Parse from $ARGUMENTS:

• --check-only: Report linting compliance status without modifications
• --fix: Apply all fixes automatically without prompting
• --linter <biome|ruff|clippy>: Override auto-detection and force specific linter

Modern linting preferences:

• JavaScript/TypeScript: Biome (unified linter + formatter, fast)
• Python: Ruff (replaces flake8, isort, pyupgrade)
• Rust: Clippy with workspace lints

Execution

Execute this linting configuration check:

Step 1: Detect project language and existing linters

Read the context values above and determine:

Indicator	Language	Detected Linter
biome.json	JavaScript/TypeScript	Biome
pyproject.toml [tool.ruff]	Python	Ruff
.flake8	Python	Flake8 (legacy)
Cargo.toml [lints.clippy]	Rust	Clippy

If --linter flag is set, use that linter regardless of detection.

Step 2: Verify latest tool versions

Use WebSearch or WebFetch to check current versions:

1. Biome: Check biomejs.dev or GitHub releases
2. Ruff: Check docs.astral.sh/ruff or GitHub releases
3. Clippy: Check Rust releases

Step 3: Analyze current linter configuration

For each detected linter, check configuration completeness:

Biome (for JS/TS):

• Config file exists with linter rules
• Formatter configured
• File patterns and ignores set
• Recommended rules enabled

Ruff (for Python):

• pyproject.toml has [tool.ruff] section
• Rules selected (E, F, I, N, etc.)
• Line length and target Python version set

Clippy:

• Cargo.toml has [lints.clippy] section
• Pedantic lints enabled
• Workspace-level lints if applicable

Step 4: Generate compliance report

Print a compliance report covering:

• Config file status (exists / missing)
• Linter enabled status
• Rules configuration (recommended / minimal / missing)
• Formatter integration
• Ignore patterns
• Lint scripts in package.json / Makefile
• Pre-commit hook integration
• CI/CD check integration

End with overall issue count and recommendations.

If --check-only is set, stop here.

Step 5: Configure linting (if --fix or user confirms)

Apply configuration using templates from REFERENCE.md.

For Biome (JS/TS):

1. Install Biome as dev dependency
2. Create biome.json with recommended rules
3. Add npm scripts (lint, lint:fix, format, check)

For Ruff (Python):

1. Install Ruff via uv add --group dev ruff
2. Add [tool.ruff] section to pyproject.toml
3. Configure rules, line length, target version

For Clippy (Rust):

1. Add [lints.clippy] section to Cargo.toml
2. Enable pedantic lints
3. Configure workspace-level lints if applicable

If legacy linters are detected (ESLint, Flake8, etc.), offer migration. See migration guides in REFERENCE.md.

Step 6: Configure pre-commit and CI integration

1. Add linter pre-commit hook to .pre-commit-config.yaml
2. Add linter CI check to GitHub Actions workflow
3. Use templates from REFERENCE.md

Step 7: Update standards tracking

Update .project-standards.yaml:

components:
  linting: "2025.1"
  linting_tool: "[biome|ruff|clippy]"
  linting_pre_commit: true
  linting_ci: true

Step 8: Print final compliance report

Print a summary of all changes applied, scripts added, integrations configured, and next steps for the user.

For detailed configuration templates, migration guides, and CI integration patterns, see REFERENCE.md.

Agentic Optimizations

Context	Command
Detect linter config	find . -maxdepth 1 \( -name 'biome.json' -o -name 'ruff.toml' -o -name '.eslintrc*' \) 2>/dev/null
Check Biome config	test -f biome.json && jq -c '.linter' biome.json 2>/dev/null
Check Ruff in pyproject	grep -A5 '\[tool.ruff\]' pyproject.toml 2>/dev/null
List lint scripts	jq -r '.scripts | to_entries[] | select(.key | contains("lint")) | "\\(.key): \\(.value)"' package.json 2>/dev/null
Quick compliance check	/configure:linting --check-only
Auto-fix configuration	/configure:linting --fix

Flags

Flag	Description
--check-only	Report status without offering fixes
--fix	Apply all fixes automatically without prompting
--linter <linter>	Override linter detection (biome, ruff, clippy)

Examples

# Check compliance and offer fixes
/configure:linting

# Check only, no modifications
/configure:linting --check-only

# Auto-fix and migrate to Biome
/configure:linting --fix --linter biome

Error Handling

• Multiple linters detected: Warn about conflict, suggest migration
• No package manager found: Cannot install linter, error
• Invalid configuration: Report parse error, offer to replace with template
• Missing dependencies: Offer to install required packages

See Also

• /configure:formatting - Configure code formatting
• /configure:pre-commit - Pre-commit hook configuration
• /configure:all - Run all compliance checks
• Biome documentation: https://biomejs.dev
• Ruff documentation: https://docs.astral.sh/ruff
• Clippy documentation: https://doc.rust-lang.org/clippy