| name | stac-custom-extensions |
| description | 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. |
Stac Custom Extensions
Overview
Use this skill to add custom widgets/actions that serialize cleanly and register correctly in a Stac app.
Workflow
- Choose extension type: widget or action.
- Scaffold model and parser files with scripts.
- Add generated files to app codebase and run codegen.
- Verify parser registration in
main.dart.
- Validate runtime wiring with a minimal usage example.
Required Inputs
- PascalCase extension name.
- Runtime type id (
type or actionType).
- Output directory for generated files.
- Path to
main.dart for registration check.
Output Contract
- Produce model + parser pair with consistent type ids.
- Include registration snippet for
Stac.initialize.
- Include
build_runner command when json serialization is used.
References
- Read
references/custom-widget-checklist.md for widget model/parser flow.
- Read
references/custom-action-checklist.md for action model/parser flow.
- Read
references/parser-registration.md for initialization wiring.
- Read
references/converters-guide.md for converter usage patterns.
Scripts
scripts/scaffold_custom_widget.py --name <Name> --type <widgetType> --out-dir <path>
scripts/scaffold_custom_action.py --name <Name> --action-type <actionType> --out-dir <path>
scripts/check_parser_registration.py --main-dart <path> --parser-class <ClassName>
Templates
assets/templates/custom_widget.dart.tmpl
assets/templates/custom_widget_parser.dart.tmpl
assets/templates/custom_action.dart.tmpl
assets/templates/custom_action_parser.dart.tmpl