douyinfe/semi-design
Overview
This skill is a practical guide for using the Semi Design React component library with the Semi MCP tooling. It helps you find component docs, inspect source and function code, and generate ready-to-use component snippets. Use it to speed up development, resolve integration issues, and follow proven patterns for theming and extension.
How this skill works
The skill walks through the MCP query workflow: discover a component, retrieve its file list, view component source, and inspect specific function implementations. It explains which MCP commands to run and how to target versions or full-code retrieval. It also summarizes common query patterns and step-by-step examples for typical UI scenarios.
When to use it
- When you need to look up a Semi Design component API or props quickly.
- When you want full component source or to inspect internal implementation details.
- When generating component code snippets or templates for a feature.
- When debugging integration issues or seeking recommended patterns for theming and customization.
- When adapting Semi to React 19 or other environment constraints.
Best practices
- Import components, icons, and styles directly to keep bundle size predictable and clear.
- Prefer theming through the design tokens and official customization APIs rather than patching styles inline.
- Query specific MCP functions to get just the code you need: component file list, file source, or function code to reduce noise.
- When props don’t cover a need, extend components via composition or controlled wrappers before modifying internal UI.
- Target the correct library version in queries to avoid API drift and unexpected behavior.
Example use cases
- Create a Table with server-side filtering and use the MCP workflow to fetch example implementations and helper functions.
- Build a validated Form by retrieving component examples and validator utilities to copy-safe patterns.
- Implement a tree-based cascade selector by inspecting component internals and adapting event hooks.
- Add drag-and-drop sorting by studying sample implementations and reusing exported utilities and handlers.
- Customize theme tokens and verify component style outcomes by pulling token definitions via MCP.
FAQ
Use the MCP file-list and file-source queries while specifying the target package version in the request; this returns the exact files and code for that release.
When should I extend a Semi component instead of overriding styles?
Extend via composition or a wrapper when behavior needs to change; reserve style overrides for cosmetic adjustments and use token-based theming for broad visual changes.