code-style-lint
/code-style-lint
Discipline for code style and static analysis, adopt the ecosystem's established formatter as the non-negotiable source of truth, enforce it at pre-commit and CI rather than in review, and treat linting (real defects) as a separate concern from formatting (appearance). Use when setting up a new project's tooling, when a code review comment is about whitespace/naming/formatting instead of behavior, or when the user asks how to configure a linter or formatter.
- Author
- aethrox ↗
- Repository
- doctrine ↗
- Licence
- MIT
- Last repository change
- 11.09.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 11.09.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Discipline for code style and static analysis, adopt the ecosystem's established formatter as the non-negotiable source of truth, enforce it at pre-commit and CI rather than in review, and treat linting (real defects) as a separate concern from formatting (appearance). Use when setting up a new project's tooling, when a code review comment is about whitespace/naming/formatting instead of behavior, or when the user asks how to configure a linter or formatter.
Original author description
Discipline for code style and static analysis, adopt the ecosystem's established formatter as the non-negotiable source of truth, enforce it at pre-commit and CI rather than in review, and treat linting (real defects) as a separate concern from formatting (appearance). Use when setting up a new project's tooling, when a code review comment is about whitespace/naming/formatting instead of behavior, or when the user asks how to configure a linter or formatter.
How it works
- Phase 1: Adopt the ecosystem's standard, don't invent one
- Phase 2: Prefer opinionated over configurable
- Phase 3: Enforcement layers, in order
- Phase 4: Linting is a separate concern from formatting
- Done when
SKILL.md preview
--- name: code-style-lint description: Discipline for code style and static analysis, adopt the ecosystem's established formatter as the non-negotiable source of truth, enforce it at pre-commit and CI rather than in review, and treat linting (real defects) as a separate concern from formatting (appearance). Use when setting up a new project's tooling, when a code review comment is about whitespace/naming/formatting instead of behavior, or when the user asks how to configure a linter or formatter. --- # Code Style & Lint Enforcement Style is not a matter for human debate. A language's established, widely-adopted formatter is the single source of truth for how code looks, enforced automatically before a human ever reads the diff, so no reviewer ever spends attention on brace placement or import order again. ## Phase 1: Adopt the ecosystem's standard, don't invent one Reach for the tool the language community has already converged on, rather than a project-specific configuration built from scratch: | Language | Formatter | Linter | |---|---|---| | Go | `gofmt` (or `goimports`): not configurable by design | `go vet`, `staticcheck` | | Rust | `rustfmt` | `clippy` | | Python | `black` (or `ruff format`) | `ruff` / `flake8`, type-checked with `mypy`/`pyright` | | JavaScript / TypeScript | `prettier` | `eslint` | | Java | `google-java-format` | Error Prone, Checkstyle | Where no single de facto tool dominates, fall back to a named, published style guide (e.g. the Google style guides) rather than an ad hoc house style; a house style is a style nobody outside the project can look up, onboard against, or get tooling support for. ## Phase 2: Prefer opinionated over configurable An opinionated formatter (`gofmt`, `prettier`, `black`) that offers few or no style options is worth more than a configurable one, even though it feels less flexible; every open configuration option is a decision the team has to make once and then defend forever, which reopens exactly the debate the formatter exists to close. Where the chosen tool does expose options, set them once at project setup, commit the config file, and treat re-opening that discussion as a smell: a request to change a formatter setting midway through a project is usually a style preference relitigating itself, not a real defect being fixed. ## Phase 3: Enforcement layers, in order 1. **Editor / local, on save or on commit.** The formatter runs automatically before code is even staged; a pre-commit hook (or editor format-on-save) so a contributor never has to remember to run it manually. 2. **CI, in blocking mode.** Re-run the same formatter and linter in CI and fail the build on any diff or violation. This is the actual gate; local hooks can be skipped or misconfigured, so CI is what a merge actually depends on, not a courtesy check. 3. **Code review never re-litigates style.** If a review comment is about formatting, spacing, or naming convention the linter could catch, that is a signal the pipeline is missing a check, not a legitimate review comment; fix Phase 1/2's tooling, don't leave the enforcement to a human's attention in every future review. ## Phase 4: Linting is a separate concern from formatting A **formatter** changes appearance without changing meaning (whitespace, line breaks, quote style). A **linter** flags real defects and risky patterns a formatter can't see: unused variables, unreachable code, an `==` where `===` was meant, a missing `await`, an unhandled promise rejection. Both run at the same enforcement layers (Phase 3), but they are not interchangeable; a project that only formats and never lints still ships the class of bug a linter exists to catch before a human does. ## Done when - [ ] The project uses the ecosystem's established formatter/linter pair, not a bespoke house style. - [ ] Formatting and linting run automatically pre-commit and are a blocking CI check, not a manual or advisory step. - [ ] No open review comment is about something the automated tooling should have caught. - [ ] Linting (defect detection) is configured and enforced separately from formatting (appearance).
Files in this package (2)
- SKILL.md 4 KB
- agents/openai.yaml 1 KB
Versions
The database has no other skills named code-style-lint.
Database snapshot: 13.11.2026 · package version 505b0ed9d0c7 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90run-lint
Use when a ticket or acceptance criterion requires the linter/formatter to pass, or after editing code to confirm it meets the repo's style and static-analysis rules before submitting for review. Invoke for "lint must pass", "fix the formatting", "no new warnings", or as the… - 100lint
Linting and code standards skill. ESLint, Prettier, Biome, Ruff, golangci-lint. Custom rules, auto-fix, pre-commit hooks, style enforcement. Triggers on: /godmode:lint, "linting", "code style", "prettier", "eslint", "formatter", "pre-commit hooks". - 100code-generation
Formatting rules for Java code generators that build source code via string concatenation. Use when the user asks to "fix formatter-off", "fix code generation formatting", "fix auto-formatted string concatenation", or "add formatter off", and proactively when writing, reviewing,… - 90re0-style
Fix code in a named change or file list so it matches the conventions its own repository already keeps: run the project's configured formatter and linter in fix mode through the project's own toolchain, then fix by hand what no tool decides (naming, import order, file layout,… - 90code-linting
Discover and run the linters and format checks relevant to changed code. Use after code edits or when the user asks for lint, formatting, or static-analysis validation. - 100sasjs-lint
Linting and formatting SAS code with @sasjs/lint - the .sasjslint rules and their defaults, severityLevel and exit codes, per-file @sasjslint overrides, what the formatter fixes, and how the SASjs CLI, VS Code extension and SASjs Server run it. Use when configuring lint rules,…