widget-design
Installation
SKILL.md
Widget Design Best Practices
Decision Framework
Platform Selection
Choose based on target client:
- GPT Apps: Target is ChatGPT. Requires
_meta.openaiwithwidgetAccessible: true. - MCP Apps: Target is any ext-apps client. Minimal config, works automatically.
Handler Type Selection
| Scenario | Handler | Reason |
|---|---|---|
| User interaction needed (buttons, inputs) | React (.tsx) |
State management with hooks |
| Display external widget library | Template literal | Just load scripts/styles |
| Dynamic content from tool params | React | Props flow naturally |
| Static HTML with no state | Template literal | Simpler, less overhead |