coss
Helps implement coss UI components correctly. Use when building UIs with coss primitives and patterns (buttons, dialogs, selects, forms, menus, tabs, segmented controls, inputs, toasts, etc.), migrating from shadcn/Radix to coss/Base UI, composing trigger-based overlays, or troubleshooting coss component behavior. Covers imports, accessibility, Tailwind styling, and common pitfalls.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 852
- Forks
- 63
01 前言 Front Matter
- name
- coss
- license
- MIT
- metadata
- { "author": "cosscom" }
- description
- Helps implement coss UI components correctly. Use when building UIs with coss primitives and patterns (buttons, dialogs, selects, forms, menus, tabs, segmented controls, inputs, toasts, etc.), migrating from shadcn/Radix to coss/Base UI, composing trigger-based overlays, or troubleshooting coss component behavior. Covers imports, accessibility, Tailwind styling, and common pitfalls.
- compatibility
- Requires Tailwind CSS v4 and @base-ui/react. Designed for React projects using the coss component registry.
02 资源文件 62
- 参考文档references/cli.md3.1 KB
- 参考文档references/component-registry.md5.4 KB
- 参考文档references/portal-props.md1.8 KB
- 参考文档references/primitives/accordion.md2.1 KB
- 参考文档references/primitives/alert-dialog.md2.9 KB
- 参考文档references/primitives/alert.md2.1 KB
- 参考文档references/primitives/autocomplete.md4.3 KB
- 参考文档references/primitives/avatar.md1.8 KB
- 参考文档references/primitives/badge.md1.6 KB
- 参考文档references/primitives/breadcrumb.md1.8 KB
- 参考文档references/primitives/button.md2.5 KB
- 参考文档references/primitives/calendar.md1.5 KB
- 参考文档references/primitives/card.md1.9 KB
- 参考文档references/primitives/checkbox-group.md1.9 KB
- 参考文档references/primitives/checkbox.md2.0 KB
- 参考文档references/primitives/collapsible.md1.3 KB
- 参考文档references/primitives/combobox.md3.2 KB
- 参考文档references/primitives/command.md2.9 KB
- 参考文档references/primitives/context-menu.md3.4 KB
- 参考文档references/primitives/dialog.md4.0 KB
- 参考文档references/primitives/drawer.md3.0 KB
- 参考文档references/primitives/empty.md1.6 KB
- 参考文档references/primitives/field.md2.3 KB
- 参考文档references/primitives/fieldset.md1.3 KB
- 参考文档references/primitives/form.md2.9 KB
- 参考文档references/primitives/frame.md1.7 KB
- 参考文档references/primitives/group.md1.6 KB
- 参考文档references/primitives/input-group.md2.7 KB
- 参考文档references/primitives/input.md1.8 KB
- 参考文档references/primitives/kbd.md1.2 KB
- 参考文档references/primitives/label.md1.3 KB
- 参考文档references/primitives/menu.md3.3 KB
- 参考文档references/primitives/meter.md1.5 KB
- 参考文档references/primitives/number-field.md2.2 KB
- 参考文档references/primitives/otp-field.md2.4 KB
- 参考文档references/primitives/pagination.md2.0 KB
- 参考文档references/primitives/popover.md2.6 KB
- 参考文档references/primitives/preview-card.md1.8 KB
- 参考文档references/primitives/progress.md1.5 KB
- 参考文档references/primitives/radio-group.md2.7 KB
- 参考文档references/primitives/scroll-area.md4.0 KB
- 参考文档references/primitives/select.md3.7 KB
- 参考文档references/primitives/separator.md1.3 KB
- 参考文档references/primitives/sheet.md2.6 KB
- 参考文档references/primitives/sidebar.md3.9 KB
- 参考文档references/primitives/skeleton.md1.5 KB
- 参考文档references/primitives/slider.md1.4 KB
- 参考文档references/primitives/spinner.md1.5 KB
- 参考文档references/primitives/switch.md2.0 KB
- 参考文档references/primitives/table.md2.7 KB
- 参考文档references/primitives/tabs.md2.5 KB
- 参考文档references/primitives/textarea.md1.9 KB
- 参考文档references/primitives/toast.md3.5 KB
- 参考文档references/primitives/toggle-group.md2.2 KB
- 参考文档references/primitives/toggle.md1.7 KB
- 参考文档references/primitives/toolbar.md2.2 KB
- 参考文档references/primitives/tooltip.md2.2 KB
- 参考文档references/rules/composition.md1.5 KB
- 参考文档references/rules/forms.md1.7 KB
- 参考文档references/rules/migration.md5.2 KB
- 参考文档references/rules/styling.md5.0 KB
- 参考文档references/segmented-control.md2.7 KB
03 SKILL.md 正文
coss ui
coss ui is a component library built on Base UI with a shadcn-like developer experience plus a large particle catalog.
What this skill is for
Use this skill to:
- pick the right coss primitive(s) for a UI task
- write correct coss usage code (imports, composition, props)
- avoid common migration mistakes from shadcn/Radix assumptions
- reference particle examples to produce practical, production-like patterns
Source of truth
- coss components docs:
apps/ui/content/docs/components/*.mdxhttps://github.com/cosscom/coss/tree/main/apps/ui/content/docs/components
- coss particle examples:
apps/ui/registry/default/particles/p-*.tsxhttps://github.com/cosscom/coss/tree/main/apps/ui/registry/default/particles
- coss particles catalog:
https://coss.com/ui/particles - docs map for agents:
https://coss.com/ui/llms.txt
Out of scope
- Maintaining coss monorepo internals/build pipelines.
- Editing registry internals unless explicitly requested.
Principles for agent output
- Use existing primitives and particles first before inventing custom markup.
- Prefer composition over custom behavior reimplementation.
- Follow coss naming and APIs from docs exactly.
- Keep examples accessible and production-realistic.
- Prefer concise code that mirrors coss docs/particles conventions.
- Assume Tailwind CSS v4 conventions in coss examples and setup guidance.
Critical usage rules
Always apply before returning coss code:
- Do not invent coss APIs. Verify against component docs first.
- For trigger-based primitives (Dialog, Menu, Select, Popover, Tooltip), follow each primitive's documented trigger/content hierarchy and composition API; do not mix patterns across components.
- Preserve accessibility labels and error semantics.
- Consult primitive-specific guides for component invariants and edge cases.
- For manual install guidance, include all required dependencies and local component files referenced by imports.
- Prefer styled coss exports first; use
*Primitiveexports only when custom composition/styling requires it.
Rule references (read on demand when the task touches these areas):
./references/rules/styling.md— Tailwind tokens, icon conventions, data-slot selectors./references/rules/forms.md— Field composition, validation, input patterns./references/rules/composition.md— Trigger/popup hierarchies, grouped controls./references/rules/migration.md— shadcn/Radix to coss/Base UI migration patterns./references/segmented-control.md— choose Radio Group, links, Toggle Group, or Tabs before applying segmented-control styling./references/portal-props.md— optionalportalPropson composed popups and toast providers (keepMounted,container, which surfaces support it)
Component discovery
All 54 primitives have dedicated reference guides at ./references/primitives/<name>.md. To find the right one for a task, consult the component registry index:
./references/component-registry.md
Usage workflow
- Identify user intent (single primitive, composed flow, form flow, overlay flow, feedback flow).
- Consult
references/component-registry.mdto identify candidate primitives. - Select primitives from coss docs first; avoid custom fallback unless needed.
- Check at least one particle example for practical composition patterns. Particle files live at
apps/ui/registry/default/particles/p-<name>-<N>.tsx(e.g.p-dialog-1.tsx). - Write minimal code using documented imports/props.
- Self-check accessibility and composition invariants.
Installation reference
See ./references/cli.md for full install/discovery workflow.
Quick CLI pattern:
npx shadcn@latest add @coss/<component>
Quick manual pattern:
- install dependencies listed in the component docs page
- copy required component file(s)
- update imports to match the target app alias setup
Primitive Guidance
Every primitive has a reference guide at ./references/primitives/<name>.md with imports, minimal patterns, inline code examples, pitfalls, and particle references. Use the component registry to find the right file.
High-risk primitives (read these guides first -- they have the most composition gotchas):
./references/primitives/dialog.md— modal overlays, form-in-dialog, responsive dialog/drawer./references/primitives/menu.md— dropdown actions, checkbox/radio items, submenus./references/primitives/context-menu.md— right-click/long-press menus at the pointer./references/primitives/select.md— items-first pattern, multiple, object values, groups./references/primitives/form.md— Field composition, validation, submission./references/primitives/input-group.md— addons, DOM order invariant, textarea layouts./references/primitives/toast.md— toastManager (not Sonner), anchored toasts, providers
Output Checklist
Before returning code:
- imports and props match coss docs
- composition structure is valid for selected primitive(s)
- accessibility and explicit control types (
button,input, etc.) are present - migration-sensitive flows are verified (type/lint, keyboard/a11y behavior, and SSR-sensitive primitives like Select/Command)
04 同仓库更多 Skills
slide-authoring
Technical reference for writing or editing open-slide pages — file contract, 1920×1080 canvas, type scale, layout, palette/visual direction, assets, speaker notes, stepped reveals, page transitions, and morph transitions. Consult this whenever you are about to write or modify any file under `slides/<id>/`, including from inside the `create-slide` or `apply-comments` workflows, or for any ad-hoc slide edit. Triggers on phrases like "edit slide", "tweak this page", "fix the layout", "change the palette", "reveal one by one", "add a transition", "morph transition", "write the speaker notes", "generate the script / talk track", "investigate the slide framework", "how do slides work here".
current-slide
Resolve which slide, page, and (optionally) selected element the user is currently viewing in the open-slide dev server. Consult this whenever the user references "this page", "this slide", "this element", "the slide I'm on", "the current page", or any deictic reference to slide content without naming it. Re-read `node_modules/.open-slide/current.json` at the start of every such turn — the user navigates between turns, so a value you read earlier in the conversation is almost certainly stale.
create-theme
Use this skill when the user wants to create, draft, author, or extract a slide theme in this open-slide repo. Triggers on phrases like "create a theme", "make a theme called X", "extract a theme from <slide>", "build a theme from these images". Produces two paired files under `themes/` — `<id>.md` (palette, typography, layout, fixed Title/Footer components, motion) and `<id>.demo.tsx` (a runnable demo slide that the dev-UI Themes panel previews). Do NOT use for editing real slides — only for authoring the theme bundle.
create-slide
Use this skill when the user wants to create, draft, author, or generate new slides / a presentation in this open-slide repo. Triggers on phrases like "make slides about X", "make a deck about X", "create a presentation", "draft slides for", "new slide", "a deck with speaker notes / a script", or when the user asks to add content under `slides/`. Do NOT use for editing the framework itself — only for authoring content inside `slides/<id>/`.
apply-comments
Apply pending @slide-comment markers written by the open-slide inspector tool. Use when the user asks to "apply comments", "process slide comments", "apply the inspector comments", or references markers left inside `slides/<id>/index.tsx`.
writing-shape
Writing, exploit: shape raw material into an article, paragraph by paragraph.