OpenParable
Skip to content
← Back to skills

Scopy Style Rules

Design
scopy-style-rules

Scopy Style Rules is an Agent Skill for design published in the analogdevicesinc/scopy repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Scopy styling system patterns including Style::setStyle, theme colors, section backgrounds, and widget styling. Auto-loads when applying styling to scopy widgets or sections.

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/analogdevicesinc/scopy/blob/HEAD/tools/scopy_dev_plugin/skills/scopy-style-rules/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/scopy-style-rules, 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.

Scopy Style Rules

Core Functions

#include <style.h>

// Apply predefined styles
Style::setStyle(widget, style::properties::label::menuBig);
Style::setStyle(widget, style::properties::widget::border_interactive);
Style::setStyle(widget, style::properties::widget::basicBackground, true, true);

// Set background colors
Style::setBackgroundColor(widget, json::theme::background_primary);
Style::setBackgroundColor(widget, json::theme::background_subtle);

// Get theme values
QString iconPath = Style::getAttribute(json::theme::icon_theme_folder);
QColor color = Style::getColor(json::theme::content_error);

Section Styling Pattern

// Standard section
Style::setBackgroundColor(sectionWidget, json::theme::background_primary);
Style::setStyle(sectionWidget, style::properties::widget::border_interactive);

// Section title
Style::setStyle(titleLabel, style::properties::label::menuBig);

Note: Not every section needs background_primary — check reference implementations to see which sections use it vs inherit parent background.

Key Style Properties

  • Labels: menuBig, menuMedium, menuSmall, subtle, deviceIcon
  • Buttons: basicButton, blueGrayButton, squareIconButton, borderButton
  • Widgets: border_interactive, basicBackground
  • Backgrounds: background_primary, background_secondary, background_subtle

Collapsible Section (for advanced sub-tabs)

#include <gui/widgets/menucollapsesection.h>

MenuSectionCollapseWidget *section = new MenuSectionCollapseWidget(
    "Section Title", MenuCollapseSection::MHCW_ARROW,
    MenuCollapseSection::MHW_BASEWIDGET, parent);
section->contentLayout()->addWidget(widget);

Rules

  • Never hardcode colors — always use theme system
  • Apply styles after widget creation
  • Check widget validity before styling
  • Always include #include <style.h>

Full Reference

See reference.md in this directory for the complete style catalog.