VenusCN Repo Skill
Use this skill when the task involves building, editing, or reviewing interfaces in a repo that contains @contentstack/venuscn or follows the same Venus-inspired design language.
Quick Start
Read these files first:
README.mdpackages/venuscn/README.mdapps/demo/HOW_THE_DEMO_WORKS.mddocs/guides/design-system.md
If the task is still unclear after that, read references/repo-map.md.
Core Working Model
- Treat
packages/venuscnas the reusable design-system package. - Treat
apps/demoas the visual reference implementation and pattern library. - Prefer existing VenusCN components before creating new app-specific UI.
- Reach for shadcn/ui app components only when the reusable package does not cover the need.
- Match existing spacing, typography, borders, and page structure before inventing new patterns.
Build UI The VenusCN Way
For interface work, follow this order:
- Find the closest matching demo page or gallery example.
- Reuse an existing
@contentstack/venuscncomponent if one exists. - Compose with existing tokens and layout patterns.
- Add a new reusable component only if the pattern is clearly repeated or design-system-worthy.
Use references/interface-patterns.md when you need a fast pattern map.
Editing Rules
- Preserve the repo's existing visual language.
- Keep reusable logic in
packages/venuscnand app-specific behavior inapps/demo. - Prefer token-based colors and spacing over one-off values unless the repo already uses a hardcoded value for that exact pattern.
- When changing docs or repo behavior, update linked documentation in
docs/and the rootREADME.mdif needed.
Validation
Default validation command after code changes:
pnpm check
If only docs changed, validate links and docs references instead of running the full code pipeline.
When To Read More
- Read
references/repo-map.mdfor package and file ownership. - Read
references/interface-patterns.mdfor common UI composition patterns in this repo.
Source: lytics/venus — distributed by TomeVault.