diff --git a/tool/dart-skills-lint/.agents/skills/add-dart-lint-validation-rule/SKILL.md b/tool/dart_skills_lint/.agents/skills/add-dart-lint-validation-rule/SKILL.md similarity index 97% rename from tool/dart-skills-lint/.agents/skills/add-dart-lint-validation-rule/SKILL.md rename to tool/dart_skills_lint/.agents/skills/add-dart-lint-validation-rule/SKILL.md index 8c08954e..a8a3995d 100644 --- a/tool/dart-skills-lint/.agents/skills/add-dart-lint-validation-rule/SKILL.md +++ b/tool/dart_skills_lint/.agents/skills/add-dart-lint-validation-rule/SKILL.md @@ -1,6 +1,6 @@ --- name: add-dart-lint-validation-rule -description: Instructions for adding a new validation rule and CLI flag to dart-skills-lint. +description: Instructions for adding a new validation rule and CLI flag to dart_skills_lint. --- # Add a New Validation Rule and Flag @@ -100,10 +100,10 @@ test('triggers error when description does not end with period', () async { name: 'test-skill', description: 'This description does not end with a period', ); - + final validator = Validator(rules: {descriptionTrailingPeriodCheck}); final result = await validator.validate(tempDir); - + expect(result.validationErrors.any((e) => e.ruleId == 'description-trailing-period'), isTrue); }); test('skips error when description ends with period', () async { @@ -111,10 +111,10 @@ test('skips error when description ends with period', () async { name: 'test-skill', description: 'This description ends with a period.', ); - + final validator = Validator(rules: {descriptionTrailingPeriodCheck}); final result = await validator.validate(tempDir); - + expect(result.validationErrors.any((e) => e.ruleId == 'description-trailing-period'), isFalse); }); ``` @@ -125,10 +125,10 @@ test('skips error when description ends with period', () async { When a new rule is introduced, verify that you synchronize sibling markdown files! -1. **`README.md`:** +1. **`README.md`:** * Add your flag under the **Usage** and **Flags** sections so users know it exists. * Add descriptive lines under **Specification Validation**. -2. **`documentation/knowledge/SPECIFICATION.md`:** +2. **`documentation/knowledge/SPECIFICATION.md`:** * If the rule implements standard specifications traits, add constraints parameters under Section 5.1 (Validation parameters). --- diff --git a/tool/dart-skills-lint/.agents/skills/dart-best-practices/SKILL.md b/tool/dart_skills_lint/.agents/skills/dart-best-practices/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/dart-best-practices/SKILL.md rename to tool/dart_skills_lint/.agents/skills/dart-best-practices/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/dart-cli-app-best-practices/SKILL.md b/tool/dart_skills_lint/.agents/skills/dart-cli-app-best-practices/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/dart-cli-app-best-practices/SKILL.md rename to tool/dart_skills_lint/.agents/skills/dart-cli-app-best-practices/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/dart-doc-validation/SKILL.md b/tool/dart_skills_lint/.agents/skills/dart-doc-validation/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/dart-doc-validation/SKILL.md rename to tool/dart_skills_lint/.agents/skills/dart-doc-validation/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/dart-matcher-best-practices/SKILL.md b/tool/dart_skills_lint/.agents/skills/dart-matcher-best-practices/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/dart-matcher-best-practices/SKILL.md rename to tool/dart_skills_lint/.agents/skills/dart-matcher-best-practices/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/dart-modern-features/SKILL.md b/tool/dart_skills_lint/.agents/skills/dart-modern-features/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/dart-modern-features/SKILL.md rename to tool/dart_skills_lint/.agents/skills/dart-modern-features/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/dart-package-maintenance/SKILL.md b/tool/dart_skills_lint/.agents/skills/dart-package-maintenance/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/dart-package-maintenance/SKILL.md rename to tool/dart_skills_lint/.agents/skills/dart-package-maintenance/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/dart-test-fundamentals/SKILL.md b/tool/dart_skills_lint/.agents/skills/dart-test-fundamentals/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/dart-test-fundamentals/SKILL.md rename to tool/dart_skills_lint/.agents/skills/dart-test-fundamentals/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/flutter_skills_ignore.json b/tool/dart_skills_lint/.agents/skills/flutter_skills_ignore.json similarity index 100% rename from tool/dart-skills-lint/.agents/skills/flutter_skills_ignore.json rename to tool/dart_skills_lint/.agents/skills/flutter_skills_ignore.json diff --git a/tool/dart-skills-lint/.agents/skills/ignore.json b/tool/dart_skills_lint/.agents/skills/ignore.json similarity index 100% rename from tool/dart-skills-lint/.agents/skills/ignore.json rename to tool/dart_skills_lint/.agents/skills/ignore.json diff --git a/tool/dart-skills-lint/.agents/skills/test-driven-development/SKILL.md b/tool/dart_skills_lint/.agents/skills/test-driven-development/SKILL.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/test-driven-development/SKILL.md rename to tool/dart_skills_lint/.agents/skills/test-driven-development/SKILL.md diff --git a/tool/dart-skills-lint/.agents/skills/test-driven-development/testing-anti-patterns.md b/tool/dart_skills_lint/.agents/skills/test-driven-development/testing-anti-patterns.md similarity index 100% rename from tool/dart-skills-lint/.agents/skills/test-driven-development/testing-anti-patterns.md rename to tool/dart_skills_lint/.agents/skills/test-driven-development/testing-anti-patterns.md diff --git a/tool/dart-skills-lint/.gitignore b/tool/dart_skills_lint/.gitignore similarity index 100% rename from tool/dart-skills-lint/.gitignore rename to tool/dart_skills_lint/.gitignore diff --git a/tool/dart-skills-lint/README.md b/tool/dart_skills_lint/README.md similarity index 100% rename from tool/dart-skills-lint/README.md rename to tool/dart_skills_lint/README.md diff --git a/tool/dart-skills-lint/analysis_options.yaml b/tool/dart_skills_lint/analysis_options.yaml similarity index 100% rename from tool/dart-skills-lint/analysis_options.yaml rename to tool/dart_skills_lint/analysis_options.yaml diff --git a/tool/dart-skills-lint/bin/dart_skills_lint.dart b/tool/dart_skills_lint/bin/dart_skills_lint.dart similarity index 100% rename from tool/dart-skills-lint/bin/dart_skills_lint.dart rename to tool/dart_skills_lint/bin/dart_skills_lint.dart diff --git a/tool/dart-skills-lint/dart_skills_lint.yaml b/tool/dart_skills_lint/dart_skills_lint.yaml similarity index 100% rename from tool/dart-skills-lint/dart_skills_lint.yaml rename to tool/dart_skills_lint/dart_skills_lint.yaml diff --git a/tool/dart-skills-lint/documentation/feature_design_docs/PRODUCTION_READYNESS.md b/tool/dart_skills_lint/documentation/feature_design_docs/PRODUCTION_READYNESS.md similarity index 97% rename from tool/dart-skills-lint/documentation/feature_design_docs/PRODUCTION_READYNESS.md rename to tool/dart_skills_lint/documentation/feature_design_docs/PRODUCTION_READYNESS.md index 2c420768..ad1674b8 100644 --- a/tool/dart-skills-lint/documentation/feature_design_docs/PRODUCTION_READYNESS.md +++ b/tool/dart_skills_lint/documentation/feature_design_docs/PRODUCTION_READYNESS.md @@ -1,7 +1,7 @@ # Production Readiness Evaluation: `dart-skills-lint` ## Executive Summary -`dart-skills-lint` is a well-structured Dart CLI tool designed to enforce the Agent Skills specification. It demonstrates solid engineering fundamentals, including a decoupled architecture, comprehensive testing, and adherence to Dart CLI best practices. However, while the core logic is robust, it lacks several critical "production-grade" features required for broad ecosystem adoption and enterprise-level CI/CD integration. +`dart_skills_lint` is a well-structured Dart CLI tool designed to enforce the Agent Skills specification. It demonstrates solid engineering fundamentals, including a decoupled architecture, comprehensive testing, and adherence to Dart CLI best practices. However, while the core logic is robust, it lacks several critical "production-grade" features required for broad ecosystem adoption and enterprise-level CI/CD integration. **Current Status:** **Beta / Tooling Candidate** *Suitable for internal use by Dart-savvy teams, but not yet ready for a broad, multi-language developer audience.* @@ -17,7 +17,7 @@ - **Configuration:** Initial support for `dart_skills_lint.yaml` allows for some flexibility in rule enforcement (error vs. warning). ### 2. Required Features Missing (Gaps) -- **Distribution & Portability:** +- **Distribution & Portability:** - No pre-compiled binaries. Users are forced to have a Dart SDK installed, which is a barrier for non-Dart developers (e.g., Python or JS agent creators). - Not yet published to `pub.dev`. - **Machine-Readable Output:** The tool only outputs human-readable logs. Production CI/CD pipelines often require JSON, SARIF, or JUnit XML formats for automated reporting and dashboarding. diff --git a/tool/dart-skills-lint/documentation/feature_design_docs/completion_migration_plan.md b/tool/dart_skills_lint/documentation/feature_design_docs/completion_migration_plan.md similarity index 100% rename from tool/dart-skills-lint/documentation/feature_design_docs/completion_migration_plan.md rename to tool/dart_skills_lint/documentation/feature_design_docs/completion_migration_plan.md diff --git a/tool/dart-skills-lint/documentation/feature_design_docs/legacy_patterns_report.md b/tool/dart_skills_lint/documentation/feature_design_docs/legacy_patterns_report.md similarity index 100% rename from tool/dart-skills-lint/documentation/feature_design_docs/legacy_patterns_report.md rename to tool/dart_skills_lint/documentation/feature_design_docs/legacy_patterns_report.md diff --git a/tool/dart-skills-lint/documentation/feature_design_docs/pub_vs_skill_report.md b/tool/dart_skills_lint/documentation/feature_design_docs/pub_vs_skill_report.md similarity index 100% rename from tool/dart-skills-lint/documentation/feature_design_docs/pub_vs_skill_report.md rename to tool/dart_skills_lint/documentation/feature_design_docs/pub_vs_skill_report.md diff --git a/tool/dart-skills-lint/documentation/knowledge/SPECIFICATION.md b/tool/dart_skills_lint/documentation/knowledge/SPECIFICATION.md similarity index 100% rename from tool/dart-skills-lint/documentation/knowledge/SPECIFICATION.md rename to tool/dart_skills_lint/documentation/knowledge/SPECIFICATION.md diff --git a/tool/dart-skills-lint/documentation/knowledge/architecture_overview.md b/tool/dart_skills_lint/documentation/knowledge/architecture_overview.md similarity index 100% rename from tool/dart-skills-lint/documentation/knowledge/architecture_overview.md rename to tool/dart_skills_lint/documentation/knowledge/architecture_overview.md diff --git a/tool/dart-skills-lint/lib/src/config_parser.dart b/tool/dart_skills_lint/lib/src/config_parser.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/config_parser.dart rename to tool/dart_skills_lint/lib/src/config_parser.dart diff --git a/tool/dart-skills-lint/lib/src/entry_point.dart b/tool/dart_skills_lint/lib/src/entry_point.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/entry_point.dart rename to tool/dart_skills_lint/lib/src/entry_point.dart diff --git a/tool/dart-skills-lint/lib/src/models/analysis_severity.dart b/tool/dart_skills_lint/lib/src/models/analysis_severity.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/models/analysis_severity.dart rename to tool/dart_skills_lint/lib/src/models/analysis_severity.dart diff --git a/tool/dart-skills-lint/lib/src/models/check_type.dart b/tool/dart_skills_lint/lib/src/models/check_type.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/models/check_type.dart rename to tool/dart_skills_lint/lib/src/models/check_type.dart diff --git a/tool/dart-skills-lint/lib/src/models/ignore_entry.dart b/tool/dart_skills_lint/lib/src/models/ignore_entry.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/models/ignore_entry.dart rename to tool/dart_skills_lint/lib/src/models/ignore_entry.dart diff --git a/tool/dart-skills-lint/lib/src/models/ignore_entry.g.dart b/tool/dart_skills_lint/lib/src/models/ignore_entry.g.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/models/ignore_entry.g.dart rename to tool/dart_skills_lint/lib/src/models/ignore_entry.g.dart diff --git a/tool/dart-skills-lint/lib/src/models/skills_ignores.dart b/tool/dart_skills_lint/lib/src/models/skills_ignores.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/models/skills_ignores.dart rename to tool/dart_skills_lint/lib/src/models/skills_ignores.dart diff --git a/tool/dart-skills-lint/lib/src/models/skills_ignores.g.dart b/tool/dart_skills_lint/lib/src/models/skills_ignores.g.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/models/skills_ignores.g.dart rename to tool/dart_skills_lint/lib/src/models/skills_ignores.g.dart diff --git a/tool/dart-skills-lint/lib/src/models/validation_error.dart b/tool/dart_skills_lint/lib/src/models/validation_error.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/models/validation_error.dart rename to tool/dart_skills_lint/lib/src/models/validation_error.dart diff --git a/tool/dart-skills-lint/lib/src/rules.dart b/tool/dart_skills_lint/lib/src/rules.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/rules.dart rename to tool/dart_skills_lint/lib/src/rules.dart diff --git a/tool/dart-skills-lint/lib/src/skills_ignores_storage.dart b/tool/dart_skills_lint/lib/src/skills_ignores_storage.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/skills_ignores_storage.dart rename to tool/dart_skills_lint/lib/src/skills_ignores_storage.dart diff --git a/tool/dart-skills-lint/lib/src/validator.dart b/tool/dart_skills_lint/lib/src/validator.dart similarity index 100% rename from tool/dart-skills-lint/lib/src/validator.dart rename to tool/dart_skills_lint/lib/src/validator.dart diff --git a/tool/dart-skills-lint/pubspec.lock b/tool/dart_skills_lint/pubspec.lock similarity index 100% rename from tool/dart-skills-lint/pubspec.lock rename to tool/dart_skills_lint/pubspec.lock diff --git a/tool/dart-skills-lint/pubspec.yaml b/tool/dart_skills_lint/pubspec.yaml similarity index 100% rename from tool/dart-skills-lint/pubspec.yaml rename to tool/dart_skills_lint/pubspec.yaml diff --git a/tool/dart-skills-lint/skills-lock.json b/tool/dart_skills_lint/skills-lock.json similarity index 100% rename from tool/dart-skills-lint/skills-lock.json rename to tool/dart_skills_lint/skills-lock.json diff --git a/tool/dart-skills-lint/test/absolute_paths_test.dart b/tool/dart_skills_lint/test/absolute_paths_test.dart similarity index 100% rename from tool/dart-skills-lint/test/absolute_paths_test.dart rename to tool/dart_skills_lint/test/absolute_paths_test.dart diff --git a/tool/dart-skills-lint/test/cli_integration_test.dart b/tool/dart_skills_lint/test/cli_integration_test.dart similarity index 100% rename from tool/dart-skills-lint/test/cli_integration_test.dart rename to tool/dart_skills_lint/test/cli_integration_test.dart diff --git a/tool/dart-skills-lint/test/config_file_test.dart b/tool/dart_skills_lint/test/config_file_test.dart similarity index 100% rename from tool/dart-skills-lint/test/config_file_test.dart rename to tool/dart_skills_lint/test/config_file_test.dart diff --git a/tool/dart-skills-lint/test/directory_structure_test.dart b/tool/dart_skills_lint/test/directory_structure_test.dart similarity index 100% rename from tool/dart-skills-lint/test/directory_structure_test.dart rename to tool/dart_skills_lint/test/directory_structure_test.dart diff --git a/tool/dart-skills-lint/test/field_constraints_test.dart b/tool/dart_skills_lint/test/field_constraints_test.dart similarity index 100% rename from tool/dart-skills-lint/test/field_constraints_test.dart rename to tool/dart_skills_lint/test/field_constraints_test.dart diff --git a/tool/dart-skills-lint/test/ignore_models_test.dart b/tool/dart_skills_lint/test/ignore_models_test.dart similarity index 100% rename from tool/dart-skills-lint/test/ignore_models_test.dart rename to tool/dart_skills_lint/test/ignore_models_test.dart diff --git a/tool/dart-skills-lint/test/metadata_validation_test.dart b/tool/dart_skills_lint/test/metadata_validation_test.dart similarity index 100% rename from tool/dart-skills-lint/test/metadata_validation_test.dart rename to tool/dart_skills_lint/test/metadata_validation_test.dart diff --git a/tool/dart-skills-lint/test/relative_path_flag_test.dart b/tool/dart_skills_lint/test/relative_path_flag_test.dart similarity index 100% rename from tool/dart-skills-lint/test/relative_path_flag_test.dart rename to tool/dart_skills_lint/test/relative_path_flag_test.dart diff --git a/tool/dart-skills-lint/test/relative_paths_test.dart b/tool/dart_skills_lint/test/relative_paths_test.dart similarity index 100% rename from tool/dart-skills-lint/test/relative_paths_test.dart rename to tool/dart_skills_lint/test/relative_paths_test.dart diff --git a/tool/dart-skills-lint/test/resolve_rules_test.dart b/tool/dart_skills_lint/test/resolve_rules_test.dart similarity index 100% rename from tool/dart-skills-lint/test/resolve_rules_test.dart rename to tool/dart_skills_lint/test/resolve_rules_test.dart diff --git a/tool/dart-skills-lint/test/skills_ignores_storage_test.dart b/tool/dart_skills_lint/test/skills_ignores_storage_test.dart similarity index 100% rename from tool/dart-skills-lint/test/skills_ignores_storage_test.dart rename to tool/dart_skills_lint/test/skills_ignores_storage_test.dart diff --git a/tool/dart-skills-lint/test/test_utils.dart b/tool/dart_skills_lint/test/test_utils.dart similarity index 100% rename from tool/dart-skills-lint/test/test_utils.dart rename to tool/dart_skills_lint/test/test_utils.dart