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
     ╭─────────┬────────┬─────────┬────────┬────────╮
     │ ModelTokensWarningErrorStatus │
     ╞═════════╪════════╪═════════╪════════╪════════╡
     │ 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
     ╭─────────┬────────┬─────────┬────────┬─────────╮
     │ ModelTokensWarningErrorStatus  │
     ╞═════════╪════════╪═════════╪════════╪═════════╡
     │ 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
     ╭────────┬────────┬─────────┬───────┬────────╮
     │ ModelTokensWarningErrorStatus │
     ╞════════╪════════╪═════════╪═══════╪════════╡
     │ 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.