style-checklisted
Install: claude install-skill hsigstad/research-kit
# style-check
Fast, deterministic, file-scoped prose-style scan. Wraps the canonical
linter at `research-kit/tools/style_lint.py`. Runs in milliseconds. No LLM.
## How to invoke
```bash
python3 ~/research/research-kit/tools/style_lint.py <file> [flags]
```
Common flags:
- `--format json` — JSON output
- `--severity warning` — minimum severity (`info | warning | error`)
- `--rule <name>` — only run a named rule (repeatable)
- `<dir>` — pass a directory to lint all `.tex` and `.md` under it
See `python3 style_lint.py --help` for the full surface.
Exits 1 if any violations remain at the requested severity. Useful for
gating submissions in CI.
## What it checks
Eighteen mechanical rules covering the deterministic part of
`research-kit/rules/writing_style.md`:
| Rule | Section reference |
|-------------------------------|----------------------------|
| `ai-tell` | §4 |
| `filler-phrase` | §17 (Quick reference) |
| `throat-clearing` | §2 |
| `editorializing` | §2 |
| `naked-this` | §4 |
| `word-choice` | §4 (plain-word table) |
| `self-categorizing` | §13 |
| `forward-reference` | §16 (robot-body linearity) |
| `hedging-opener` | §7 |
| `sentence-length`