nori-lint

0.4.0 verified Fri May 01 auth: no javascript

An opinionated linter for SKILL.md files used by AI agents. Current stable version is 0.4.0. It enforces token efficiency and structural discipline by applying static rules (fast, deterministic) and optionally LLM-powered rules. Key differentiators include a focus on minimizing context window usage, a two-tier rule system, auto-fix capabilities, and integration with the Nori ecosystem (Nori Skillsets, Nori Sessions). Requires Node.js 20+.

Common errors

error Command not found: nori-lint ↓

cause Not installed or not in PATH

fix

Install globally: npm install -g nori-lint, or use npx nori-lint

error Error: Cannot find module 'nori-lint' ↓

cause Running without npx and not globally installed

fix

Use npx nori-lint instead of nori-lint

Warnings

gotcha LLM rules require an API key and are non-deterministic; running fix twice may produce different results. ↓

fix Use static rules only for deterministic fixes, or accept non-determinism.

deprecated The --format option with 'text' default may be deprecated in future for more structured output. ↓

fix Consider using --format json for machine parsable output.

Install

npm install nori-lint

yarn add nori-lint

pnpm add nori-lint

Imports

nori-lint
wrong
```
nori-lint --help
```
correct
```
npx nori-lint lint /path/to/SKILL.md
```
Package is a CLI tool, not a library. Use npx or global install.

Quickstart

Lint a SKILL.md file for common issues using static rules.

npx nori-lint lint /path/to/SKILL.md