dart-skills-lint-setup

✓ Official★ 2,585

by flutter · part of flutter/skills

Use this skill when you need to set up validation for AI agent skills in a Dart project for the first time. Adds the linter as a dev_dependency, creates a configuration file, and generates a baseline for legacy repos.

🧩 One of 7 skills in the flutter/skills package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Setting up Skill Validation with dart_skills_lint

This skill covers first-time wiring of dart_skills_lint into a repository. For ongoing use — running the linter, interpreting output, and writing custom rules — see the dart-skills-lint-validation skill. For copy-pasteable CI workflow and pre-commit hook recipes, see the Recipes section of the README.

Steps

Add dart_skills_lint as a dev_dependency. Prefer a git dependency (the package isn't on pub.dev yet):
```
dev_dependencies:
  dart_skills_lint:
    git:
      url: https://github.com/flutter/skills.git
      path: tool/dart_skills_lint
```
Isolate the dependency in a tool/ package when you can, instead of putting it on the root pubspec.yaml — keeps the linter's deps out of your runtime closure. If you must add it to multiple pubspec.yaml files, ensure the ref: (commit hash) is identical across all of them so resolution doesn't diverge.
Create dart_skills_lint.yaml at the repository root so both the CLI and any embedded test invocation share the same config:
```
dart_skills_lint:
  rules:
    check-relative-paths: error
    check-trailing-whitespace: error
  directories:
    - path: ".agents/skills"
```
Rules enabled by default — check-absolute-paths, valid-yaml-metadata, invalid-skill-name, description-too-long — only need to be listed if you want to change their severity. See RULES.md for the full list.
Generate a baseline if you're integrating into a repository with pre-existing skills that have legacy violations you don't want to fix immediately:
```
dart run dart_skills_lint:cli --skills-directory=.agents/skills --generate-baseline
```
This writes the current set of failures into an ignore file so the next run exits clean. New violations introduced after the baseline still surface as errors.
Wire it into CI. Use the GitHub Actions recipe from the README verbatim, or follow the pre-commit hook recipe below it.

When you're done

The dart-skills-lint-validation skill takes over from here for day-to-day use.