# 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.

- Skill name: `scopy-style-rules`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/analogdevicesinc/scopy/blob/HEAD/tools/scopy_dev_plugin/skills/scopy-style-rules/SKILL.md
- Repository: analogdevicesinc/scopy (499 GitHub stars when collected)

## SKILL.md

# Scopy Style Rules

## Core Functions

```cpp
#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

```cpp
// 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)

```cpp
#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.

---

Source: https://www.openparable.com/skill/design/scopy-style-rules (OpenParable). Cite the canonical URL above.
