OpenParable
Skip to content
← Back to skills

Stac Custom Extensions

Development
stac-custom-extensions

Stac 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  1. Choose extension type: widget or action.
  2. Scaffold model and parser files with scripts.
  3. Add generated files to app codebase and run codegen.
  4. Verify parser registration in main.dart.
  5. 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