Skip to content
███████╗██╗  ██╗██╗██╗     ██╗     ███████╗      ██╗     ██╗███╗   ██╗████████╗
██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝      ██║     ██║████╗  ██║╚══██╔══╝
███████╗█████╔╝ ██║██║     ██║     ███████╗█████╗██║     ██║██╔██╗ ██║   ██║
╚════██║██╔═██╗ ██║██║     ██║     ╚════██║╚════╝██║     ██║██║╚██╗██║   ██║
███████║██║  ██╗██║███████╗███████╗███████║      ███████╗██║██║ ╚████║   ██║
╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝      ╚══════╝╚═╝╚═╝  ╚═══╝   ╚═╝

skills-lint

Token budget linter for agent skill files

Terminal
$npm install -g @haasstefan/skills-lint
skills-lint
  .github/skills/code-review/SKILL.md
  ├─ skill-structure   valid   ✓ PASS
  │
  └─ token-limit
     ╭─────────┬────────┬─────────┬────────┬────────╮
     │ Model   ┆ Tokens ┆ Warning ┆  Error ┆ Status │
     ╞═════════╪════════╪═════════╪════════╪════════╡
     │ gpt-5   ┆  4,281 ┆  16,000 ┆  32,000 ┆ ✓ PASS │
     │ gpt-4o  ┆  4,821 ┆   8,000 ┆  16,000 ┆ ✓ PASS │
     │ gpt-4   ┆  2,340 ┆   2,000 ┆   4,000 ┆ ⚠ WARN │
     ╰─────────┴────────┴─────────┴────────┴────────╯

  ──────────────────────────────────────────────────

  .github/skills/deploy/SKILL.md
  ├─ skill-structure   valid   ✓ PASS
  │
  └─ token-limit
     ╭─────────┬────────┬─────────┬────────┬─────────╮
     │ Model   ┆ Tokens ┆ Warning ┆  Error ┆ Status  │
     ╞═════════╪════════╪═════════╪════════╪═════════╡
     │ gpt-5   ┆  8,710 ┆  16,000 ┆  32,000 ┆ ✓ PASS  │
     │ gpt-4o  ┆  9,340 ┆   8,000 ┆  16,000 ┆ ⚠ WARN  │
     │ gpt-4   ┆  4,812 ┆   2,000 ┆   4,000 ┆ ✗ ERROR │
     ╰─────────┴────────┴─────────┴────────┴─────────╯

  ──────────────────────────────────────────────────

  (skill index)
  └─ skill-index-budget
     ╭────────┬────────┬─────────┬───────┬────────╮
     │ Model  ┆ Tokens ┆ Warning ┆ Error ┆ Status │
     ╞════════╪════════╪═════════╪═══════╪════════╡
     │ gpt-4o ┆    312 ┆   2,000 ┆  4,000 ┆ ✓ PASS │
     │ gpt-4  ┆    312 ┆   1,000 ┆  2,000 ┆ ✓ PASS │
     ╰────────┴────────┴─────────┴───────┴────────╯

  Results: 9 passed, 2 warnings, 1 error across 2 files

Released under the MIT License.