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.
How do I install this agent skill?
npx skills add https://github.com/stacdev/stac --skill stac-troubleshooterIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a diagnostic utility designed for the Stac framework. It performs local filesystem checks to identify build, configuration, and runtime errors in Stac projects. No malicious behavior, network exfiltration, or obfuscation was detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
9/9 files flagged
What does this agent skill do?
Stac Troubleshooter
Overview
Use this skill to run structured diagnostics and return precise fixes for Stac project issues.
Workflow
- Run
scripts/stac_doctor.py --project-root <path>for baseline checks. - Run
scripts/check_build_outputs.py --project-root <path> --expected-dir stac/.build. - Triage using focused playbooks under
references/. - 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.mdfor common Stac errors and fixes. - Read
references/cache-debug.mdfor stale content and cache strategy checks. - Read
references/navigation-debug.mdfor route/action stack behavior. - Read
references/migration-cheatsheet.mdfor JSON-to-Dart migration mapping. - Read
references/known-gotchas.mdfor recurring pitfalls.
Scripts
scripts/stac_doctor.py --project-root <path> [--json]scripts/check_build_outputs.py --project-root <path> --expected-dir stac/.build
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/stacdev/stac/stac-troubleshooter">View stac-troubleshooter on skillZs</a>