metis: Skill for Claude Code

Interactive Widget System

Production-ready patterns for building interactive widget systems that integrate with AI/LLM backends for dynamic, structured user interfaces.

Overview

Interactive widget patterns for:

• LLM-driven widget generation
• Streaming response with structured components
• Dynamic form builders
• Action-response patterns
• Widget protocol design

Reference Documentation

System Overview

• overview - Widget system architecture and navigation
  • System components
  • Documentation structure
  • Quick reference

Technical Specification

• technical-spec - Complete technical specification
  • Widget protocol design
  • Backend integration
  • Frontend rendering
  • State management
  • Error handling

Implementation Guide

• implementation-guide - Step-by-step implementation
  • Backend widget generation
  • Frontend widget rendering
  • Event handling
  • Real-world examples

Quick Patterns

Widget Protocol (JSON)

{
  "type": "form",
  "id": "user-input-form",
  "content": {
    "fields": [
      {
        "type": "text",
        "name": "query",
        "label": "Enter your question",
        "required": true
      }
    ],
    "actions": [
      {
        "type": "submit",
        "label": "Send",
        "action": "submit_query"
      }
    ]
  }
}

Backend Widget Generation (Python)

def generate_widget_response(user_query: str) -> dict:
    """Generate structured widget response from LLM."""
    response = llm.generate(
        prompt=f"Generate a widget response for: {user_query}",
        output_schema=WidgetSchema
    )
    return {
        "type": response.widget_type,
        "content": response.content,
        "actions": response.available_actions
    }

Frontend Widget Renderer (Dart)

Widget buildWidget(Map<String, dynamic> widgetData) {
  switch (widgetData['type']) {
    case 'form':
      return FormWidget(data: widgetData['content']);
    case 'card':
      return CardWidget(data: widgetData['content']);
    case 'table':
      return TableWidget(data: widgetData['content']);
    default:
      return TextWidget(data: widgetData['content']);
  }
}