setup-lint

Setup Lint

Interactive setup wizard for the code-lint plugin. Detects project languages and linters, asks what to enable, writes per-project config.

Step 1: Detect Project

Run the detection script to discover languages, linter configs, and available binaries:

bash "${CLAUDE_PLUGIN_ROOT}/skills/setup-lint/scripts/detect-project.sh" "${CLAUDE_PROJECT_DIR:-$(pwd)}"

If CLAUDE_PLUGIN_ROOT is not set, find the script relative to this SKILL.md file (./scripts/detect-project.sh).

Parse the JSON output — it describes which languages are present and which linters are available/configured.

Step 2: Interview User

For each detected language, use AskUserQuestion to confirm:

1. Language enablement: "I found Ruby files (Gemfile, .rubocop.yml). Enable Ruby linting?"
2. Linter selection: "rubocop and reek are available. Which linters do you want to enable?"
3. Autofix: "Auto-fix style issues before checking? (rubocop -A will run before rubocop lint)"
4. Exclusions: "Any paths to exclude beyond defaults? (Current defaults: test/, spec/, db/schema.rb)"

Defaults to suggest

Ruby:

• Enable: rubocop, reek
• Exclude: test/, spec/, db/schema.rb
• Autofix: rubocop only

JavaScript/TypeScript:

• Enable: eslint (or biome if configured)
• Exclude: node_modules/, dist/, build/
• Autofix: eslint --fix (or biome --write)

Python:

• Enable: ruff (preferred), flake8 as fallback
• Exclude: .venv/, __pycache__/, migrations/
• Autofix: ruff --fix

Go:

• Enable: golangci-lint
• Exclude: vendor/

Rust:

• Enable: clippy (whole-project only — won't run in hooks, only in /lint)

Markdown:

• Enable: markdownlint
• Exclude: node_modules/, vendor/
• Autofix: markdownlint --fix

HTML:

• Enable: prettier (for check + format)
• Exclude: node_modules/, dist/, build/
• Autofix: prettier --write

Shell:

• Enable: shellcheck
• Exclude: node_modules/, vendor/

Tool linters (language-agnostic)

After the per-language interview, check for tool linters detected in the JSON output (tool_linters key).