brand-and-operations — Claude Code rule: features and setup
brand-and-operations is a Claude Code rule for brand consistency, motion, and UI copy. It loads when an agent sets an aesthetic direction, writes interface text, or works on system operations.
MIT ★ 3,216 updated 2026-10-20
/plugin marketplace add plugin87/ux-ui-agent-skills
/plugin install ux-ui-agent-skills@ux-ui-agent-skillsWhat brand-and-operations does
The rule sets guidance for interface styling, animation, UX writing, and design-system operations. Motion values come from tokens/motion.json; animations must also respect prefers-reduced-motion. UI transitions are capped at 500ms.
It covers concise interface labels, error messages, and empty states. The operations guidance describes token builds for CSS, Tailwind, iOS, and Android, plus Figma sync, accessibility checks, and visual regression testing. QA includes both automated gates and manual accessibility checks per release.
What it helps with
- choose an aesthetic direction for a UI
- rewrite error and empty-state messages
- set motion rules that respect reduced-motion preferences
- plan token builds and design-system QA
Example prompts for the agent
- Choose an aesthetic direction for this page and check its contrast.
- Rewrite the error and empty-state messages using the UX writing rules.
- Outline design-system QA for a release.
How to install brand-and-operations
1Plugin marketplace
/plugin marketplace add plugin87/ux-ui-agent-skills/plugin install ux-ui-agent-skills@ux-ui-agent-skills2Manually: put the files in place
.claude/rules/brand-and-operations.mdThe paths frontmatter field limits the files
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/brand-and-operations.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/brand-and-operations.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/brand-and-operations.mdManually: put the files in place
.clinerules/brand-and-operations.mdStep by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use
Questions about brand-and-operations
How do I install brand-and-operations in Claude Code?
Run these commands in order: /plugin marketplace add plugin87/ux-ui-agent-skills, then /plugin install ux-ui-agent-skills@ux-ui-agent-skills. The rule file is .claude/rules/brand-and-operations.md.
What does brand-and-operations do?
It defines guidance for visual direction, motion, and UX copy, and describes workflows for building and checking a design system.
What motion constraints does the rule set?
UI transitions should last 100 to 300ms and must not exceed 500ms. The rule also requires respecting prefers-reduced-motion.
Source text
brand-and-operations.md · MIT
# Rule: Brand, motion, copy, and operations Loaded when applying an aesthetic direction, writing UI copy, or running the system itself. Split out of `CLAUDE.md` so it loads only when the work calls for it. The headings below are unchanged, so any pointer to them still resolves. --- ## Brand Consistency ### Design Taste & Aesthetic Direction - **Anti-slop doctrine**: every output must beat the statistical defaults that make UI look machine-generated. See `taste/design-taste.md` (banned defaults, the Variance Mandate, typographic/spatial/color taste, pre-flight aesthetic check). - **Aesthetic systems**: pick an archetype or a named system (2,144 specs) from `taste/aesthetic-systems.md`; resolve it into tokens via the Library Contract; verify contrast after. - **Motion choreography**: compose motion with `taste/motion-choreography.md` (entrances, stagger, hover, overlays) on top of `tokens/motion.json`. - Taste sharpens tier 4 only. Re-run accessibility checks after applying any direction. ### Motion Design - **Duration**: 100 to 300ms for UI transitions. Never > 500ms. - **Easing**: `ease-out` for entrances, `ease-in` for exits, `ease-in-out` for state changes - **Purpose**: Every animation guides attention, shows connection, or provides feedback - **Reduced motion**: Always respect `prefers-reduced-motion`. Replace with fade or instant. - All motion values are tokenized: use `tokens/motion.json` (duration scale, easing curves, transition presets, keyframes). Never hardcode timing or easing. ### Voice & Tone - **UI copy**: Clear, concise, actionable. Frontload the verb. - Good: "Save changes" / Avoid: "Click here to save your changes" - Good: "Email is required" / Avoid: "The email field cannot be empty" - **Error messages**: Say what happened → why → how to fix it. - Good: "Password must be at least 8 characters. Try adding numbers or symbols." - Avoid: "Error: Invalid input" - **Empty states**: Explain the value → guide to first action. - Good: "No projects yet. Create your first project to get started." - Avoid: "No data" - Full UX writing system (voice principles, tone spectrum, error/empty-state formulas, microcopy patterns, inclusive language, and a pre-ship checklist) in `content/voice-tone.md`. --- ## Operations & Pipeline Keeping the system healthy at scale (governance, build, sync, QA, and performance): - **Governance**: versioning (SemVer for tokens/components), contribution path, deprecation policy, change communication: `workflows/governance.md`. - **Token build pipeline**: transform `tokens/*.json` (source of truth) → CSS vars / Tailwind `@theme` / iOS Asset Catalog / Android / Compose via Style Dictionary or Tokens Studio (DTCG): `workflows/token-build.md`. - **Figma integration**: token ↔ Figma Variable sync (3-tier collections + modes), Figma MCP usage, component parity: `workflows/figma-integration.md`. - **Design QA**: automated gates (token validation, axe a11y, visual regression across variants/states/themes/RTL) + manual a11y per release: `workflows/design-qa.md`. - **Performance**: Core Web Vitals (LCP/INP/CLS) budgets, loading/code-split strategy, layout-shift and animation-perf rules: `workflows/performance.md`. - **Icon system**: grid/stroke/sizing tokens, delivery, and a11y for icons as a governed subsystem: `components/icon-system.md`.
© Thientan Soparat · MIT · plugin87/ux-ui-agent-skills