build-component-ui_skill

Overview

This skill is an expert assistant for developing Keboola component configuration schemas and UI. It focuses on configSchema.json and configRowSchema.json, conditional fields using options.dependencies, UI elements, sync actions, and schema testing. It helps design, validate, and test schemas and can launch schema-tester and run Playwright tests for automation.

How this skill works

I inspect your schema requirements, design a flat property structure, and apply options.dependencies for any conditional fields. I recommend and generate appropriate UI element definitions (text, textarea, select, checkbox, encrypted fields) and add sync action patterns for dynamic loading. I also guide you to run the interactive schema-tester and set up Playwright MCP tests for critical schemas.

When to use it

• When building or updating configSchema.json or configRowSchema.json
• When you need conditional fields that show/hide based on other values
• When adding dynamic selects or sync-action buttons that call async actions
• When preparing schemas for production and needing automated Playwright tests
• When validating encryption needs (# prefixed fields) and required/default settings

Best practices

• Always keep properties flat; avoid oneOf/allOf for conditional logic
• Use options.dependencies (not JSON Schema dependencies) for all conditional fields
• Use boolean true/false and arrays for multiple dependency values (not strings)
• Prefix encrypted fields with # and set format: password for secrets
• Add clear descriptions, sensible defaults, and mark required fields explicitly
• Test interactively with schema-tester and add Playwright tests for critical flows

Example use cases

• Create auth flow: basic vs API key with conditional username/password and #api_key fields
• Show incremental options only when sync_type == incremental using options.dependencies
• Load entity sets with a dynamic select using an async sync action and autoload cache
• Add a Test Connection button as an async sync-action that validates credentials
• Write Playwright tests to assert visibility and enabled state of conditional fields