Scopy Style Rules
Designscopy-style-rulesScopy 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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.