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
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 --fixAlternatives
Packages that do the same job and could replace skills_lint.
- analyzer
Performs static analysis of Dart code for tool integration and embedding.
87Compare - undead
Reachability and dead/unused declaration analysis for Dart and Flutter packages.
72Compare - mews_pedantic
Dart and Flutter static analysis and lint rules incorporated in Mews.
75Compare - flutter_hooks_lint_plugin
A Dart analyzer plugin providing lint rules for flutter_hooks.
56Compare
Works with
Packages commonly used together with skills_lint: ones it builds on, ones built on it, and its own family.
- yamlskills_lint depends on itA Dart library for parsing YAML documents into Dart data structures.
- pubspec_parseskills_lint depends on itParse pubspec.yaml files with a type‑safe API and detailed error reporting.
- source_spanskills_lint depends on itStandard representation for source code locations, spans, and human-friendly error messages.
- json_annotationskills_lint depends on itProvides annotations for json_serializable to generate JSON (de)serialization code.
- argsskills_lint depends on itLibrary for parsing raw command-line arguments into options and values using GNU and POSIX styles.
- loggingskills_lint depends on itProvides configurable logging with levels and stream listeners for Dart apps.
- tarskills_lint depends on itMemory-efficient, streaming implementation of the tar file format
- checked_yamlSame familyProvides checkedYamlDecode to give detailed errors when decoding YAML with json_serializable.