Skip to main content
skill CX Codex

design-system-adoption — Claude Code skill

Builds an adoption strategy and enablement materials when teams are bypassing an existing design system. It helps plan education, migration support and measurement.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Owl-Listener/designer-skills --skill design-system-adoption -a claude-code
Open on GitHub

What design-system-adoption does

This skill drafts a design system adoption plan: launch announcements, demos, searchable documentation with examples, training guides, workshops and office hours. It can also cover Figma or Sketch libraries, code packages, templates, starter kits and migration guides from legacy patterns.

It frames adoption through production component usage, custom or override styles, support-question volume, implementation time for new features and consistency audit scores. Confusing documentation is a reason to fix the docs before making system use a review criterion.

The skill addresses common resistance, including missing coverage, rigid components, frequent breaking changes and an unclear contribution path. Use design-system-governance for contribution and versioning rules.

What it helps with

  • create a design system adoption plan
  • write onboarding guides for designers and developers
  • define component adoption metrics
  • plan migration away from legacy patterns
  • address team resistance to system usage

Example prompts for the agent

  • Create an adoption strategy for teams that keep bypassing our design system.
  • Draft documentation, workshops and support materials for our design system rollout.
  • Which metrics should we track for production component adoption?

How to install design-system-adoption

1Skills CLI (Vercel)

npx skills add Owl-Listener/designer-skills --skill design-system-adoption -a claude-code

2Manually: put the files in place

~/.claude/skills/design-system-adoption/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/design-system-adoption/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about design-system-adoption

How do I install design-system-adoption in Claude Code?

Run npx skills add Owl-Listener/designer-skills --skill design-system-adoption -a claude-code, then run npx skills add Owl-Listener/designer-skills --skill design-system-adoption -a claude-code again. The skill file is at ~/.claude/skills/design-system-adoption/SKILL.md.

What does design-system-adoption do?

It creates strategies and enablement materials for getting teams to use a design system consistently. Its scope includes awareness, education, migration support, incentives and adoption measurement.

How does it differ from design-system-governance?

design-system-adoption focuses on getting teams to use the system. Use design-system-governance for contribution and versioning rules.

Source text

SKILL.md · MIT
---
name: design-system-adoption
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).
---
# 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

© Owl-Listener · MIT · Owl-Listener/designer-skills

Similar skills

Everything for Design →

From the same set109

version-control-strategy Defines version control strategies for design files, component libraries, and tokens. It helps teams stop chaotic file history and establish clear release routines. CX Codex +1 2,000installs critique-visual-hierarchy This skill reviews a rendered screen across four dimensions and tells you where the eye actually lands. Useful when attention goes to the wrong place. CX Codex +1 2,000installs click-test-plan Turns a findability question into a test plan: where users click first and whether they locate items in your navigation. Useful when a design is ready but untested. CX Codex +1 2,000installs design-sprint-plan Plans structured design sprints to move from a challenge statement to a tested prototype in days. Ideal when you need to compress discovery work into a single week. CX Codex +1 2,000installs team-workflow Designs an operating cadence for design teams, covering task tracking, regular rituals, and developer handoff. Helpful when day-to-day design collaboration lacks structure. CX Codex +1 2,000installs opportunity-framework Turns a pile of possible improvements into a ranked roadmap using impact-effort and RICE. Handy when ideas outnumber capacity. CX Codex +1 2,000installs design-review-process A skill that sets four review gates for design work, from concept to implementation QA. Useful when things ship without a consistent review step. CX Codex +1 2,000installs north-star-vision Articulates a long-horizon product vision across 1-year, 2-3 year, and 5+ year horizons. Useful when a team lacks a clear strategic direction. CX Codex +1 2,000installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor