Dart Skills Lint Validation
Testing & Qualitydart-skills-lint-validationDart Skills Lint Validation is an Agent Skill for testing & quality published in the flutter/skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use this skill when you need to validate AI agent skills with dart_skills_lint — running the linter, interpreting failures, fixing violations, and authoring custom rules.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/flutter/skills/blob/HEAD/tool/dart_skills_lint/skills/dart-skills-lint-validation/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/dart-skills-lint-validation, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Validating Skills with dart_skills_lint
This skill covers day-to-day use: running the linter, walking
through a failing run, and writing a custom rule when defaults
aren't enough. For first-time wiring (adding the dep, creating the
config file, generating a baseline) see
dart-skills-lint-setup. The
full rule reference (default severities, diagnostic shapes,
fixability) lives in RULES.md.
Running the linter
If dart_skills_lint is in pubspec.yaml:
dart run dart_skills_lint:cli -d .agents/skills
If it's installed globally with dart pub global activate:
dart pub global run dart_skills_lint:cli -d .agents/skills
Run dart run dart_skills_lint:cli --help for the full flag list
(skip the inline duplicate so it never goes stale).
Workflow for a failing run
- Run the validator.
- Read the errors. Each diagnostic names the rule that fired, the offending value, and a suggested fix when one applies.
- Fix the violations. For fixable rules
(
check-absolute-paths,check-trailing-whitespace,invalid-skill-name), pass--fixto write the corrections to disk; add--dry-runto preview the diff first. - Re-run to confirm the run is clean.
Task progress
- Run validator
- Read errors
- Fix violations (manual or
--fix/--fix --dry-run) - Verify clean run
Authoring a custom rule
Extend SkillRule and pass the rule into validateSkills:
import 'package:dart_skills_lint/dart_skills_lint.dart';
class DeprecatedSkillRule extends SkillRule {
@override
final String name = 'deprecated-skill';
@override
final AnalysisSeverity severity = AnalysisSeverity.warning;
@override
Future<List<ValidationError>> validate(SkillContext context) async {
final errors = <ValidationError>[];
final yaml = context.parsedYaml;
if (yaml == null) return errors;
if (yaml['metadata']?['deprecated'] == true) {
errors.add(ValidationError(
ruleId: name,
severity: severity,
file: 'SKILL.md',
message: 'This skill is marked as deprecated.',
));
}
return errors;
}
}
Wire it up in a Dart test:
import 'package:dart_skills_lint/dart_skills_lint.dart';
import 'package:test/test.dart';
void main() {
test('skills pass with deprecated-skill custom rule', () async {
final config = await ConfigParser.loadConfig();
await validateSkills(
config: config,
customRules: [DeprecatedSkillRule()],
);
});
}
Related
dart-skills-lint-setup— first-time wiring.RULES.md— canonical rule reference.README.md— installation, configuration, integration recipes.