skills/stac-troubleshooter/SKILL.md
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.
npx skillsauth add stacdev/stac stac-troubleshooterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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/.builddevelopment
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.
tools
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.
tools
Scaffold 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.
development
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.