Skip to content
cccskills
FreePublished on GitHub

design-system-adoption

Plan how teams will adopt an existing design system, a shared set of design components and guidelines. Develop onboarding materials, migration support, and measures of usage while addressing barriers faced by designers and developers.

OriginalShow the original description

Create adoption strategy and enablement materials to drive design system usage. Use when the system exists but teams ignore it. For contribution and versioning rules, use `design-system-governance` (design-systems).

Run score Not tested

See how to install

Good for

  • Planning adoption of an underused design system
  • Preparing getting started guides and workshops
  • Supporting migration from older design patterns
  • Choosing metrics to track adoption

Files included (1)

  • SKILL.md2.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Design System Adoption

You are an expert in driving design system adoption across design and engineering teams.

What You Do

You create strategies and materials that help teams adopt and consistently use a design system.

Adoption Strategy

Awareness

  • Launch announcements and demos
  • Documentation site with search and examples
  • Regular updates and changelog communication
  • Showcase projects that use the system well

Education

  • Getting started guides for designers and developers
  • Component usage guidelines with examples
  • Workshop series (introductory, advanced, contribution)
  • Office hours for questions and support

Enablement

  • Figma/Sketch library with proper setup instructions
  • Code packages with installation guides
  • Templates and starter kits
  • Migration guides from legacy patterns

Incentives

  • Celebrate teams that adopt well
  • Track and share adoption metrics
  • Reduce friction (make it easier to use the system than not)
  • Include system usage in code/design review criteria

Measuring Adoption

  • Component usage percentage in production
  • Number of custom/override styles
  • Support question volume (should decrease over time)
  • Time to implement new features (should decrease)
  • Consistency audit scores

Common Adoption Barriers

  • System doesn't cover team's needs
  • Documentation is incomplete or confusing
  • Components are too rigid to customize
  • Breaking changes too frequent
  • No clear contribution path

Overcoming Resistance

  • Listen to objections — they reveal real gaps
  • Offer migration support, not mandates
  • Show productivity gains with data
  • Start with willing teams, build momentum
  • Make contributing easy

Best Practices

  • Treat the design system as a product with users
  • Invest in documentation as much as components
  • Support both designers and developers equally
  • Maintain a public roadmap
  • Build community through contribution and feedback

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a-b-test-design

FreeSummary

Plan A/B experiments to measure the effect of a design change. Define a hypothesis, control and treatment versions, success metrics, sample size, and duration, with supporting measures to detect unintended consequences.

  • Planning a comparison between current and proposed designs
  • Defining success metrics for a change
  • Estimating sample size and test duration
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Assess an existing interface against WCAG 2.2 accessibility guidelines. Identify barriers in content and interactions, rate their severity and user impact, and document affected locations, remediation steps, and code examples to guide improvements.

  • Reviewing accessibility in an existing design or build
  • Checking keyboard access and assistive technology compatibility
  • Prioritizing fixes by severity and user impact
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Plan accessibility testing with people who use assistive technologies, such as screen readers and voice control. Define participant criteria, test environments, session procedures, coverage of WCAG accessibility guidelines, and a consistent format for reporting issues.

  • Planning test sessions with assistive technology users
  • Defining participant recruitment criteria
  • Mapping key user flows to test environments
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Review visual consistency to understand how an interface shapes trust and perceived ease of use. Examine spacing, alignment, typography, and overlooked screen states to guide visual improvements alongside usability testing.

  • Investigating poor feedback on a functional interface
  • Checking visual consistency before launch
  • Reviewing error, empty, and loading states
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

affinity-diagram

FreeSummary

Turn interview notes, observations, and survey responses into themes and actionable research insights. Group related evidence without preset categories, retain participant references, and prioritize findings by their impact on design decisions while noting patterns found in only one interview.

  • Synthesize findings across multiple interviews
  • Organize observation notes and survey responses
  • Prioritize research insights for design decisions
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

Refine a specific interface animation by choosing easing, meaning changes in speed, along with duration and movement order. Use it to tune buttons, modals, transitions, or loading indicators so motion guides attention and communicates changes.

  • Tune how a modal enters and exits
  • Adjust button and toggle animations
  • Coordinate the order of related movements
Owl-Listener/designer-skills3KUpdated Sep 6, 2026

See all skills by Owl-Listener

Report a problem with this skill