Skip to content

adamayoung/TMDb / .claude/skills/lint

Lint code with swiftlint and swiftformat

FileKindSize
SKILL.mdskill md1.5 KB
---
name: lint
description: Lint code with swiftlint and swiftformat
---

# Lint code

Run `make lint` from the project root to check code style. It runs **eight**
checks, in order: six Python scripts under `Scripts/` — `lint-witnesses`
(`check-defaulted-witnesses.py`, protocol conveniences that would witness their
own requirement), `lint-fixtures` (`check-fixtures.py`, JSON fixture hygiene),
`lint-curation` (`check-docc-curation.py`, public methods missing from their
DocC page), `lint-prose` (`check-prose-call-forms.py`, code samples calling a
method that does not exist), `lint-readme-version`
(`check-readme-version.py`, README's `.package(from:)` vs the newest
`CHANGELOG.md` release) and `lint-run-list` (`run-script-tests.py` — despite
the target's name, **every** suite under `Scripts/tests/`: the `/triage-issues`
run-list builder, the `/deliver` selection-prose anti-drift cases, the
`deliver-runfile.py` writer, and the workflow cache-key/change-gate cases) —
then `swiftlint --strict .`, then `swiftformat --lint .`.

Each script enforces something no single-file linter can see, and a failure in
any of them is **not** a formatting problem: `/format` will not fix it.

Run this directly — it is fast and low-output, so delegating to a subagent would
cost more (subagent overhead) than it saves.

If you see `superfluous_disable_command` errors on files you did not just change,
it is usually a swiftlint version-drift artifact (the pin is swiftlint 0.63.2 /
swiftformat 0.61.1), not a real violation. Run `/format` to auto-fix fixable
violations.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall