Overview
skills_lint is a Dart-based static analysis tool designed to validate Agent Skills defined in SKILL.md files. It checks frontmatter, naming conventions, file paths, and overall structure to ensure consistency and correctness. Ideal for integration into CI pipelines and pre-commit hooks, it helps maintain high-quality skill documentation across projects. The package supports multiple platforms including Android, iOS, Linux, macOS, and Windows, making it versatile for cross-platform development workflows.
Use cases
- Validating SKILL.md files in CI/CD pipelines
- Enforcing documentation standards in team projects
- Integrating with pre-commit hooks for automated checks
- Ensuring consistent skill metadata formatting
- Supporting agent skill development in large-scale applications
Key features
- Static analysis for SKILL.md files
- Frontmatter and structure validation
- Path and naming convention checks
- CI/CD and pre-commit integration
- Multi-platform support
Suitable for
- Teams maintaining agent skills documentation
- Developers using SKILL.md for skill definitions
- Projects requiring automated documentation validation
- Dart-based tools and frameworks
- Cross-platform development environments
Considerations
- Requires SKILL.md files to follow expected format
- Limited to validating SKILL.md only
- Dependent on correct configuration in CI/pre-commit
- Not applicable for non-Dart projects
- May need updates when SKILL.md schema evolves