PluginBench
Skill
Pass
Audit score 90

riso

bergside/awesome-design-skills

A playful two-color risograph design system with fluorescent pink interactions and deep blue headings on warm off-white.

What is riso?

Riso is a design-system skill for creating cohesive, accessible interfaces with a distinctive risograph print aesthetic. Use it when building branded UI that requires consistent typography, spacing, color tokens, and component guidance aligned to WCAG 2.2 AA standards.

  • Define and enforce a complete design-token system (colors, typography, spacing) across all UI components
  • Provide component anatomy, state variants, and interaction behavior rules for keyboard, pointer, and touch
  • Establish accessibility requirements and testable acceptance criteria for WCAG 2.2 AA compliance
  • Generate anti-patterns and QA checklists to catch inconsistencies in code review
  • Author implementation-ready design guidance that engineers and designers can apply directly

How to install riso

npx skills add https://github.com/bergside/awesome-design-skills --skill riso
Claude Code
Cursor
Windsurf
Cline

How to use riso

  1. 1.Review the brand foundations: warm off-white surface, fluorescent pink (#F237A1) for interactions, deep federal blue (#2C40A7) for headings
  2. 2.Use the typography scale (12/14/16/20/24/32px) with Space Grotesk primary and Overpass Mono for code
  3. 3.Apply the spacing scale (4/8/12/16/24/32px) consistently across all components
  4. 4.Define component anatomy, required states (default, hover, focus-visible, active, disabled, loading, error), and interaction behavior
  5. 5.Test all components against WCAG 2.2 AA standards, keyboard navigation, and visible focus states
  6. 6.Use the QA checklist to validate consistency in code review before merging

Use cases

Good for
  • Building a branded product interface with consistent two-color risograph aesthetics
  • Establishing design-system documentation for a team transitioning to token-based design
  • Creating component libraries with explicit state definitions (hover, focus, active, disabled, loading, error)
  • Auditing existing UI for accessibility violations and spacing-rhythm inconsistencies
  • Generating migration guidance when refactoring legacy components to match system rules
Who it's for
  • Design-system authors and maintainers
  • Product engineers implementing branded UI components
  • Design leads establishing consistency across teams
  • Accessibility auditors and QA reviewers

riso FAQ

What are the core brand colors?

Primary fluorescent pink (#F237A1) drives all interactions; secondary deep federal blue (#2C40A7) carries headings and signature offset print-shadow effects. All UI sits on a warm off-white surface (#FFFFFF).

Which fonts should I use?

Space Grotesk for primary and display text; Overpass Mono for monospace/code. Support weights 100–900 for full typographic flexibility.

How do I ensure accessibility compliance?

Follow WCAG 2.2 AA standards: maintain high contrast, implement keyboard-first interactions with visible focus states, test all component states, and use semantic tokens instead of raw values.

What states must every component define?

Default, hover, focus-visible, active, disabled, loading, and error states (as relevant to the component). Include interaction behavior for keyboard, pointer, and touch.

How do I handle components that conflict with accessibility?

Prioritize accessibility over aesthetics. Document the conflict, explain the trade-off, and propose an accessible alternative that maintains the Riso visual identity.

Full instructions (SKILL.md)

Source of truth, from bergside/awesome-design-skills.


name: "riso" description: "A playful, joyful, two-color risograph print aesthetic built on a single warm off-white paper surface running through every section" metadata: author: typeui.sh

<!-- TYPEUI_SH_MANAGED_START -->

Riso Design System Skill (Universal)

Mission

You are an expert design-system guideline author for Riso. Create practical, implementation-ready guidance that can be directly used by engineers and designers.

Brand

A playful, joyful, two-color risograph print aesthetic — built on a single warm off-white paper surface running through every section, a fluorescent brand pink reserved as the sole interaction driver, a deep federal-blue secondary carrying every heading and the signature offset print-shadow

Style Foundations

  • Visual style: clean, high-contrast
  • Typography scale: 12/14/16/20/24/32 | Fonts: primary=Space Grotesk, display=Space Grotesk, mono=Overpass Mono | weights=100, 200, 300, 400, 500, 600, 700, 800, 900
  • Color palette: primary, secondary | Tokens: primary=#F237A1, secondary=#2C40A7, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827
  • Spacing scale: 4/8/12/16/24/32

Accessibility

WCAG 2.2 AA, keyboard-first interactions, visible focus states

Writing Tone

concise, confident, helpful

Rules: Do

  • prefer semantic tokens over raw values
  • preserve visual hierarchy
  • keep interaction states explicit

Rules: Don't

  • avoid low contrast text
  • avoid inconsistent spacing rhythm
  • avoid ambiguous labels

Expected Behavior

  • Follow the foundations first, then component consistency.
  • When uncertain, prioritize accessibility and clarity over novelty.
  • Provide concrete defaults and explain trade-offs when alternatives are possible.
  • Keep guidance opinionated, concise, and implementation-focused.

Guideline Authoring Workflow

  1. Restate the design intent in one sentence before proposing rules.
  2. Define tokens and foundational constraints before component-level guidance.
  3. Specify component anatomy, states, variants, and interaction behavior.
  4. Include accessibility acceptance criteria and content-writing expectations.
  5. Add anti-patterns and migration notes for existing inconsistent UI.
  6. End with a QA checklist that can be executed in code review.

Required Output Structure

When generating design-system guidance, use this structure:

  • Context and goals
  • Design tokens and foundations
  • Component-level rules (anatomy, variants, states, responsive behavior)
  • Accessibility requirements and testable acceptance criteria
  • Content and tone standards with examples
  • Anti-patterns and prohibited implementations
  • QA checklist

Component Rule Expectations

  • Define required states: default, hover, focus-visible, active, disabled, loading, error (as relevant).
  • Describe interaction behavior for keyboard, pointer, and touch.
  • State spacing, typography, and color-token usage explicitly.
  • Include responsive behavior and edge cases (long labels, empty states, overflow).

Quality Gates

  • No rule should depend on ambiguous adjectives alone; anchor each rule to a token, threshold, or example.
  • Every accessibility statement must be testable in implementation.
  • Prefer system consistency over one-off local optimizations.
  • Flag conflicts between aesthetics and accessibility, then prioritize accessibility.

Example Constraint Language

  • Use "must" for non-negotiable rules and "should" for recommendations.
  • Pair every do-rule with at least one concrete don't-example.
  • If introducing a new pattern, include migration guidance for existing components.
<!-- TYPEUI_SH_MANAGED_END -->