# Linter

> Lint and auto-fix Shell, Markdown, and Python files in a repository. Use when users ask to lint shell scripts with shellcheck and bash -n, lint all nested Markdown files with markdownlint (fix first, then .markdownlint.json fallback rules), or lint Python files with ruff (fix first, then targeted Ruff rules in pyproject.toml). Use when this capability is needed.

- Skill: `tomevault-io/linter` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/linter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/linter/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/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

```bash
# 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](https://tomevault.io/claim/nebius) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->