scrcpy-option-ui-builder

This skill should modify the category screens and add the requested scrcpy options to the UI, depending on the type of the option (text, toggle, dropdown, etc.). Use this skill for adding new scrcpy options in the UI.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The scrcpy-option-ui-builder is a specialized Claude skill designed to automate the development of configuration interfaces for scrcpy-based applications. It streamlines the process of adding new UI options—such as toggles, text fields, and dropdowns—by automatically modifying Flutter/Dart category screens, updating navigation routes, and generating necessary localization strings. This tool ensures architectural consistency and significantly reduces the manual boilerplate required to expose new scrcpy command-line arguments in a graphical user interface.

Use Cases

  • Automating the addition of new scrcpy configuration options (e.g., bitrate, resolution, or cropping) into existing UI category screens.
  • Creating entirely new configuration category screens from scratch, including route registration and navigation menu integration.
  • Generating standardized UI components and corresponding i18n translation keys to maintain a consistent user experience across the application settings.
namescrcpy-option-ui-builder
descriptionThis skill should modify the category screens and add the requested scrcpy options to the UI, depending on the type of the option (text, toggle, dropdown, etc.). Use this skill for adding new scrcpy options in the UI.

Scrcpy option UI builder

Working directory: /lib/presentation/scrcpy_config/

UI option screens are present in @lib/presentation/scrcpy_config.

Common, re-usable widgets are present in @lib/presentation/scrcpy_config/widgets.

Steps

  1. Gather information
  2. Extend or create UI code in the <category_screen>.dart file
  3. Create necessary translations for the the UI Control

1. Gather information

  • Refer to /docs/scrcpy_options to find information about the scrcpy option (Argument, name, description, is advanced).
  • Find the corresponding argument class in /lib/application/model/scrcpy/arguments/
  • If the argument class doesn't exist, first create it using this skill
  • Use this argument class in the UI code to get existing value and to update it.

2. Create <category_screen>.dart

2. Extend existing UI Code

  • If the <category_screen>.dart file for requested scrcpy option and the respective category already exists, then extend the Scrollable Column, with the new control(s)

Use /lib/presentation/scrcpy_config/widgets/config_item.dart for wrapping the actual UI control.

  • The ConfigItem widget expects:
  1. label (key and translation label) to show title, description and argument tooltip.
  2. child the actual control widget (toggle/switch/text input/comboBox/etc.)

3. Create translations

  • Currently, the project only supports english language.
  • The translation file is present here
  • Refer to the existing translations under this path inside the JSON: e.g. confg/video/noVideo
  • Expected path: config/<category>/<argument.label>
  • Required translations: title, description, arg
  • Optional: default (default value for the control e.g. for comboBox)