feat: agent skills + migration guide improvements#725
Merged
sean-brydon merged 13 commits intomainfrom Mar 23, 2026
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
- Rename all 45 primitive dirs to match name fields (e.g. dialog/ -> coss-dialog/) - Write unique, trigger-optimized descriptions for all primitives - Replace user-invocable with compatibility field and metadata block - Add 'When NOT to use' sections to 19 confusable primitives - Convert rule files to proper skill dirs with SKILL.md frontmatter - Split base-vs-radix.md into concise skill + references/component-index.md - Add component registry index reference (references/component-registry.md) - Move cli.md to references/ directory - Update root SKILL.md with updated paths, component discovery section, metadata Co-Authored-By: pasquale <pasqualevitiello@gmail.com>
The skills already live under apps/ui/skills/coss/, so the coss- prefix on each directory/name was redundant. Reverts to simple names like dialog/, select/, styling/, migration/, etc. Co-Authored-By: pasquale <pasqualevitiello@gmail.com>
sean-brydon
approved these changes
Mar 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a comprehensive set of agent skills for coss UI following the agentskills.io specification, plus improvements to the Radix migration guide and component docs.
Changes recap:
Agent Skills (
apps/ui/skills/coss/)primitives/*/SKILL.md— each with unique trigger-optimized descriptions,compatibilityfield,metadatablock (author/version), and spec-compliantname↔directory naming.mdto proper skill directories with SKILL.md frontmatter:styling,forms,composition,migrationbase-vs-radix.md→ concisemigration/SKILL.md+references/component-index.md(30-component index loaded on demand)references/component-registry.md) for fast agent-driven primitive discoverycli.mdmoved toreferences/directoryMigration Guide & Docs
<SelectValue placeholder="..." />instead of null-value itemsDialogCreateHandleandDrawerCreateHandledocsasChild→renderpattern scopeReview & Testing Checklist for Human
p-select-1throughp-select-11— verify placeholder text renders correctly now that null-value items are removed (behavioral change). This is the highest-risk change since it modifies runtime behavior.placeholderonSelectValueandalignItemWithTriggeronSelectPopup)SKILL.mdcross-references resolve correctly (e.g. root →primitives/dialog/SKILL.md, migration →references/component-index.md)Recommended test plan: Run the dev server, navigate to the Select component particles page, and confirm all Select examples display properly with placeholder text instead of a selectable null-value option.
Notes
dialog/,select/,styling/) since they already live underapps/ui/skills/coss/Link to Devin session: https://app.devin.ai/sessions/d69512ae40264e9287a699d91a24f4ba
Requested by: @pasqualevitiello