Stac Custom Extensions
Developmentstac-custom-extensionsStac Custom Extensions is an Agent Skill for development published in the StacDev/stac repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/StacDev/stac/blob/HEAD/skills/stac-custom-extensions/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/stac-custom-extensions, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 (
typeoractionType). - Output directory for generated files.
- Path to
main.dartfor registration check.
Output Contract
- Produce model + parser pair with consistent type ids.
- Include registration snippet for
Stac.initialize. - Include
build_runnercommand when json serialization is used.
References
- Read
references/custom-widget-checklist.mdfor widget model/parser flow. - Read
references/custom-action-checklist.mdfor action model/parser flow. - Read
references/parser-registration.mdfor initialization wiring. - Read
references/converters-guide.mdfor 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.tmplassets/templates/custom_widget_parser.dart.tmplassets/templates/custom_action.dart.tmplassets/templates/custom_action_parser.dart.tmpl