stac-troubleshooter

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.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "stac-troubleshooter" with this command: npx skills add stacdev/stac/stacdev-stac-stac-troubleshooter

Stac Troubleshooter

Overview

Use this skill to run structured diagnostics and return precise fixes for Stac project issues.

Workflow

  1. Run scripts/stac_doctor.py --project-root <path> for baseline checks.
  2. Run scripts/check_build_outputs.py --project-root <path> --expected-dir stac/.build.
  3. Triage using focused playbooks under references/.
  4. Return root cause, fix commands, and post-fix verification steps.

Required Inputs

  • Project root path.
  • Failing command and output (if available).
  • Affected route/screen name (if runtime issue).

Output Contract

  • Classify issue as setup/build/deploy/runtime/cache/navigation.
  • Provide exact remedial commands and expected outcomes.
  • Include one verification command or file check per fix.

References

  • Read references/error-playbooks.md for common Stac errors and fixes.
  • Read references/cache-debug.md for stale content and cache strategy checks.
  • Read references/navigation-debug.md for route/action stack behavior.
  • Read references/migration-cheatsheet.md for JSON-to-Dart migration mapping.
  • Read references/known-gotchas.md for recurring pitfalls.

Scripts

  • scripts/stac_doctor.py --project-root <path> [--json]
  • scripts/check_build_outputs.py --project-root <path> --expected-dir stac/.build

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

stac-quickstart

No summary provided by upstream source.

Repository SourceNeeds Review
-32
stacdev
Coding

stac-custom-extensions

No summary provided by upstream source.

Repository SourceNeeds Review
-31
stacdev
Coding

stac-screen-builder

No summary provided by upstream source.

Repository SourceNeeds Review
-31
stacdev