사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/c3sc0-v4113/scaffold --skill shadcn-component-boundaries시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
shadcn Component Boundaries
Activation Contract
Load this skill when creating, moving, wrapping, or reviewing UI components in a project that uses shadcn.
Hard Rules
- Resolve paths from
components.json(itsaliasesforcomponentsandui) or the installed shadcn skill's project-context command. Never assumecomponents/versussrc/components/. - Reserve the resolved
uidirectory for registry-managed primitives installed from shadcn or compatible registries. - Never place product-owned wrappers, composites, sections, domain components, or feature behavior in the
uidirectory. - Put reusable product-owned components under
common/in the resolved components directory. - Put feature-owned components in a named feature folder or colocate them with that feature.
- Compose: wrap a registry primitive from
common/or a feature folder instead of adding product behavior to the primitive. - Keep dependencies one-way: feature → common → ui. The
uidirectory never imports fromcommonor feature folders. - Use semantic tokens from the global stylesheet. Treat tokens as quarks and registry primitives as atoms; do not force molecule or organism names into paths.
- When
@shadcn/lintis configured,shadcn/no-restyleenforces theuiboundary: call sites may pass layout classes throughclassName, but look comes from variants and sizes. Add a variant to the primitive instead of restyling at the call site.
Decision Gates
| Component ownership | Destination |
|---|---|
| shadcn or compatible registry primitive | resolved ui directory |
| reusable product-owned component | <components>/common/ |
| feature-specific component | <components>/<feature>/ or feature colocation |
| route or page composition | framework route/page directory |
| theme token | global stylesheet variables |
Execution Steps
- Read
components.jsonand resolve thecomponentsanduialiases to directories. - Search installed primitives before creating custom markup.
- Classify ownership and reuse scope with the table above.
- Place the component; see references/placement-examples.md for edge cases.
- Verify no product-owned file entered
uiand no reverse import was introduced.
Output Contract
State the ownership classification and final path for every component created or moved, and confirm the dependency direction holds.
References
- references/placement-examples.md — worked placement decisions.
