# Lint

> Lint Stencila documents and summarise the diagnostics.

- Skill: `stencila/lint` (Agent Skill)
- Install (CLI): `npx skillmds@latest add stencila/lint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stencila/lint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: stencila (https://skillmd.com/u/stencila)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/stencila/lint

---


# /stencila:lint

Lint the files given in `$ARGUMENTS` (default: all Stencila documents —
`.smd`, `.myst`, `.qmd` — in the project).

Use the stencila CLI path reported in session context; otherwise
`${CLAUDE_PLUGIN_OPTION_STENCILA_PATH}` if set, else `stencila`. If no CLI
is available, point the user at `/stencila:doctor` and stop.

```sh
NO_COLOR=1 <stencila> lint <files...> --as json --yes
```

Parse the JSON diagnostics and summarise them grouped by file: count by
severity, then the individual messages with locations. Do not dump raw
JSON.

Only if the user asks to fix issues, re-run with `--fix` (rewrites files),
or `--format` for formatting-only fixes, then report what changed.