Linter

Linter

Run repo linting with a fix-first workflow and conservative config fallback when direct fixes are not enough.

Workflow

1. Confirm the repo root path.
2. Run scripts/lint-repo.sh --root <path>.
3. Prefer direct source fixes first.
4. Apply fallback config rules only for unresolved rule IDs.

Checks

• Shell:
  • Discover *.sh and *.bash files.
  • Run bash -n for syntax checks.
  • Run shellcheck -x for static analysis.
• Markdown:
  • Discover all nested .md files.
  • Run markdownlint --fix first.
  • If issues remain, run an extra formatter pass (prettier --prose-wrap always or mdformat when available).
  • Re-run markdownlint; only if still unresolved, create .markdownlint.json fallback rules when safe.
• Python:
  • Discover all *.py files.
  • Run ruff check --fix first.
  • Re-run ruff check; if unresolved, add targeted Ruff ignores in pyproject.toml when safe.

Execution Mode

Scripts in this skill are reference-only by default. Execute scripts only when the user explicitly starts the request with Run or Execute (or equivalent).

Commands

# Full pass: fix first, then fallback config only if required
scripts/lint-repo.sh --root .

# Check-only mode
scripts/lint-repo.sh --root . --no-fix --no-config-fallback

Converted and distributed by TomeVault — claim your Tome and manage your conversions.