nori-lint

library0.4.0jsnpmunverified

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+.

devops testing

npm install nori-lint

package ↗

INSTALL

IMPORT

SIG · NORI-LINT

nori-lint

devopsjavascriptv0.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

nori-lint

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

✗ nori-lint --help

Package is a CLI tool, not a library. Use npx or global install.

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

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

norilint --version

Debug

Known issues

gotchaLLM 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.

affects: >=0.1.0

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

fix

Consider using --format json for machine parsable output.

affects: >=0.1.0

Errors

Common errors & fixes

Command not found: nori-lint

Not installed or not in PATH

fix

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

Error: Cannot find module 'nori-lint'

Running without npx and not globally installed

fix

Use npx nori-lint instead of nori-lint

Upgrade

Version history

0.4.0latest on npm

Audit

Dependencies

noderequiredRequires Node.js 20+ for script execution

Agent activity

2 hits · last 30 days

node

Resources

packagehttps://www.npmjs.com/package/nori-lint ↗