// Diagnose Stac build, deploy, rendering, caching, and navigation issues using repeatable checks. Use when users report stac build finding no screens, deploy mismatches, runtime unknown widget/action errors, cache staleness, or migration regressions.
| name | stac-troubleshooter |
| description | Diagnose Stac build, deploy, rendering, caching, and navigation issues using repeatable checks. Use when users report stac build finding no screens, deploy mismatches, runtime unknown widget/action errors, cache staleness, or migration regressions. |
Use this skill to run structured diagnostics and return precise fixes for Stac project issues.
scripts/stac_doctor.py --project-root <path> for baseline checks.scripts/check_build_outputs.py --project-root <path> --expected-dir stac/.build.references/.references/error-playbooks.md for common Stac errors and fixes.references/cache-debug.md for stale content and cache strategy checks.references/navigation-debug.md for route/action stack behavior.references/migration-cheatsheet.md for JSON-to-Dart migration mapping.references/known-gotchas.md for recurring pitfalls.scripts/stac_doctor.py --project-root <path> [--json]scripts/check_build_outputs.py --project-root <path> --expected-dir stac/.buildScaffold and integrate custom Stac widgets and actions with parsers and registration checks. Use when users ask to build new StacParser or StacActionParser implementations, generate custom model classes, or verify parser registration inside Stac.initialize.
Help initialize and validate a Stac-enabled Flutter project and ship a first server-driven screen. Use when users ask to set up Stac CLI, run stac init/build/deploy, verify project prerequisites, or troubleshoot first-run setup and missing configuration files.
Build Stac DSL screens and themes from product requirements with safe defaults and reusable templates. Use when users ask to create or refactor StacScreen files, map UI requirements to Stac widgets/actions/styles, or scaffold new screen/theme files.