Dart & Flutter SDK Skills (dart-sdk-skills) 🎯

Authoritative, version-by-version agent skills for the Dart & Flutter SDKs: language features, core APIs, experimental feature flags (--enable-experiment), static metaprogramming (Macros & Augmentations), widget deprecations, Material 3 migrations, minSdk compatibility, and legacy codebase rescue (Dart 1.0 & Flutter 1.0 to modern Dart 3.13+ & Flutter 3.47+).

Designed to bridge LLM training cutoff gaps, ensuring AI coding agents (Claude Code, Google Antigravity, OpenAI Codex, GitHub Copilot, Cursor, Cline) write syntactically and semantically correct code across all target SDKs.

📦 Single-Command Universal Installation

Install both skills globally or into your local project workspace with any compatible package manager:

Option 1: Using npx skills (Node / universal)

# Install globally for all agents
npx skills add RandalSchwartz/dart-sdk-skills -g

# Or install for a specific project
npx skills add RandalSchwartz/dart-sdk-skills

Option 2: Using the Dart skills CLI

# Install globally
skills add https://github.com/RandalSchwartz/dart-sdk-skills --global --all

# Or install locally
skills add https://github.com/RandalSchwartz/dart-sdk-skills

Option 3: Manual Installation for Google Antigravity

Clone or symlink the skill directories into your Antigravity config:

git clone https://github.com/RandalSchwartz/dart-sdk-skills.git ~/Projects/Dart/dart-sdk-skills
ln -s ~/Projects/Dart/dart-sdk-skills/skills/dart-sdk-changelog ~/.gemini/config/skills/dart-sdk-changelog
ln -s ~/Projects/Dart/dart-sdk-skills/skills/flutter-sdk-changelog ~/.gemini/config/skills/flutter-sdk-changelog

🛠️ Included Skills

This repository bundles two top-level, progressively disclosed skills:

1. dart-sdk-changelog (Dart Language & Core APIs)

• SKILL.md: Core router, activation triggers, and fast minSdk matrix.
• macros-and-augmentations-guide.md: Syntax and mechanics for augment, augmented(), import augment, @JsonCodable(), and the 3-phase macro pipeline.
• experimental-features-guide.md: Complete guide to --enable-experiment, Beta preview vs. stable-gated release tiers, and graduation history.
• rescuing-legacy-dart-apps.md: 4-stage pipeline for migrating Dart 1.x & pre-2.12 codebases to modern Dart 3.x.
• how-to-find-minsdk.md: Systematic methodology for finding minSdk lower bounds.
• version-matrix.md: Searchable matrix mapping every feature and API to introducing Dart versions.
• Version Reference Guides: Detailed breakdowns for Dart 2.x milestones and every Dart 3.x release (3.0 through 3.14).

2. flutter-sdk-changelog (Flutter Framework & Widgets)

• SKILL.md: Fast widget & API replacement matrix.
• material-ui-and-cupertino-ui-migration.md: Runbook and guide for the decoupling of standalone material_ui and cupertino_ui packages from the core framework.
• widget-deprecations-and-replacements.md: Complete before/after dictionary (WillPopScope ➔ PopScope, Color.withOpacity ➔ Color.withValues, MaterialState ➔ WidgetState, 2021 TextTheme).
• material-2-to-material-3-guide.md: Full M2 to M3 theming, ColorScheme.fromSeed, and component migration.
• flutter-to-dart-version-matrix.md: Complete mapping from Flutter 1.0 to 3.49+ with bundled Dart SDKs and engine milestones.
• rescuing-legacy-flutter-apps.md: 5-phase structured runbook for stepping legacy Flutter apps to modern Flutter.

🚀 Fast Language Feature Matrix

🎨 Fast Flutter Widget Replacement Matrix

🤖 Maintenance & Agent Upgrade Runbook

For AI agents and maintainers updating this repo when new Dart or Flutter SDK versions are released, see AGENTS.md.

Local Validation & Quality Gates

# Verify static analysis & style standards
dart analyze --fatal-infos

# Run comprehensive link integrity and skill validation tests
dart test

# Refresh skill hashes & index in skills-lock.json
dart run tool/update_skills_index.dart

🌐 Community Resources & Live Trackers

• FlutterReleases.com: Independent live Flutter SDK release tracker, archive explorer, and interactive Flutter/Dart compatibility checker.

📄 License

MIT © 2026 Randal L. Schwartz

{
  "name": "dart-sdk-skills",
  "owner": {
    "name": "Randal L. Schwartz",
    "url": "https://github.com/RandalSchwartz"
  },
  "description": "Authoritative version-by-version agent skills for the Dart SDK and Flutter framework.",
  "plugins": [
    {
      "name": "dart-sdk-skills",
      "source": "./",
      "description": "Authoritative version-by-version agent skills for the Dart SDK and Flutter framework, including minSdk verification, widget replacements, and legacy modernization."
    }
  ]
}