Skip to content
pubscout

skills_lint

0.5.3+1, released 2 weeks ago by google.dev

Static analysis linter and CLI tool for Agent Skills (SKILL.md) structure and metadata

$ flutter pub add skills_lint
Source repository

What it does

Validates Agent Skills directories and SKILL.md files against the Agent Skills specification. Checks YAML frontmatter, naming conventions, paths, and trailing whitespace. Supports auto-fixing violations, baseline generation, and SARIF/JSON reporting for CI pipelines.

AI-written summary of version 0.5.3+1, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Developing AI agent skills that require compliance with the Agent Skills specification
  • Enforcing SKILL.md conventions and path validation in CI/CD pipelines or pre-commit hooks
  • Auditing agent skills before publishing packages or sharing skill folders

Skip it when

  • Linting standard Dart/Flutter code (use lints or flutter_lints instead)
  • Projects that do not author or maintain Agent Skills specifications

Strengths

  • Supports multiple installation options including Dart pub, standalone binaries, shell scripts, and Homebrew
  • Provides automated multi-pass fixing with `--fix` and preview with `--dry-run`
  • Emits SARIF 2.1.0 output for seamless GitHub Code Scanning integration

Weaknesses

  • macOS standalone binaries are unsigned, requiring manual Gatekeeper quarantine removal
  • Requires Dart 3.12 or later when used as a Dart package

Setup

Kind
Pure Dart
Effort
Low
Code generation
Yes (build_runner)
Direct dependencies
9

Can be installed via `dart pub add --dev skills_lint`, `dart install skills_lint`, or standalone binaries.

# Run directly from CLI to validate a skills directory:
dart run skills_lint --skills-directory ./path/to/skills-root

# Or run an automated fix:
dart run skills_lint --skills-directory ./path/to/skills-root --fix

Alternatives

Packages that do the same job and could replace skills_lint.

Works with

Packages commonly used together with skills_lint: ones it builds on, ones built on it, and its own family.