flutter-design-system
Create, extend, or repair semantic Flutter design systems covering tokens, themes, typography, color, spacing, geometry, motion, and component contracts. Use for ThemeData work, design-token extraction, dark mode, component standardization, UI consistency, or migration away from scattered visual constants.
How do I install this agent skill?
npx skills add https://github.com/musabekisakov-imj/flutter-design-engineer --skill flutter-design-systemIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a collection of architectural guidelines, reference documentation, and starter boilerplate for creating semantic Flutter design systems. Analysis found no malicious patterns, unauthorized data access, or executable risks.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Flutter Design System
Build a semantic system that serves the product; do not impose a generic component library.
Process
- Inventory existing
ThemeData, extensions, constants, text styles, colors, radii, spacing, shared widgets, and package dependencies. - Identify visual language and product constraints. Read
references/visual-direction.md,references/typography-and-color.md, andreferences/layout-and-density.md. - Define semantic roles before values:
- surfaces, content, borders, accents, status, and interaction states;
- display, title, body, label, and numeric typography roles;
- spacing, radius, elevation, icon size, control height, and motion roles.
For products spanning multiple domains, read
references/connected-product-workflows.md; give domains semantic accents without fragmenting the shared system.
- Map roles into
ColorScheme,TextTheme, component themes, and narrowly scopedThemeExtensions. - Support light/dark contrast and platform behavior without duplicating raw values throughout widgets.
- Define component contracts for behavior and states, not only appearance.
- Migrate incrementally. Avoid replacing mature project primitives unless the new system resolves a documented issue.
Rules
- Prefer semantic names such as
surfaceRaisedover color names such asgray100in widget code. - Keep domain meaning out of universal primitives when a local component is clearer.
- Avoid excessive token granularity that makes ordinary UI changes require system archaeology.
- Test text scaling, RTL, disabled/error states, and theme transitions.
- Keep package APIs stable when modifying a library.
Use starter assets in assets/starter/ as adaptation examples, not mandatory architecture.
Deliver
Document token decisions, migration boundaries, component contracts, theme coverage, and verification performed. State intentional exceptions.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/musabekisakov-imj/flutter-design-engineer/flutter-design-system">View flutter-design-system on skillZs</a>