Skill

refineui 스킬은 AI 에이전트가 RefineUI 프로젝트에서 일하는 방법을 가르칩니다. 요청을 분류하고, 라이브 문서 인덱스를 읽으며, 토큰·컴포지션 규칙을 따르고, 선택적으로 @refineui/mcp를 사용합니다.

SKILL.md

SKILL.md는 스킬 진입점입니다. 에이전트는 RefineUI 관련 작업마다 먼저 이 파일을 읽습니다. 컴포넌트나 토큰 목록을 나열하지 않으며 — 공식 문서로 어떻게 라우팅할지, 코드를 작성할 때 어떤 제약이 적용되는지를 정의합니다.

Frontmatter

---
name: refineui
description: RefineUI design-system guide for AI agents…
user-invocable: true
argument-hint: "[question or topic]"
---

Field	Purpose
name	스킬 식별자 (refineui)
description	호스트가 이 스킬을 로드해야 하는 시점
user-invocable	사용자가 직접 호출 가능 (예: /refineui)
argument-hint	호출과 함께 전달되는 선택적 주제

Sections

Section	What it tells the agent
1. Classify the request	Foundations vs components vs setup vs MCP vs health check — 그리고 프로젝트를 먼저 읽어야 하는지
2. Documentation routing	DESIGN.md / llm.txt / llms.txt에서 시작, ui.pelagornis.com의 leaf 페이지 열기; 가능하면 MCP 사용
3. Code-writing contract	@refineui/react 임포트, 컴포저블 API, 토큰만으로 스타일링, a11y
4. Monorepo contributors	이 저장소 내부 경로 (packages/tokens, packages/react, docs)
5. MCP	@refineui/mcp 도구를 언제·어떻게 사용하는지
6. Doctor	수정을 제안하기 전 읽기 전용 진단
7. Response principles	URL 인용, 가이던스와 편집 분리, 임의 API 금지

더 깊은 내용은 references/와 rules/에 있습니다 — SKILL.md는 콘텐츠를 복제하지 않고 링크합니다.

소스: skills/refineui/SKILL.md

역할

Layer	Role
Doc routing	DESIGN.md / llm.txt / llms.txt에서 시작, ui.pelagornis.com의 leaf 페이지 열기
Codegen rules	토큰만으로 스타일링, 컴포저블 API, 임의 props 금지
Monorepo hints	이 저장소에서 토큰·컴포넌트·문서가 어디에 있는지
MCP pointer	@refineui/mcp 도구를 언제 사용하는지
Doctor	읽기 전용 설정·계약 진단

스킬은 컴포넌트 목록이나 토큰 테이블을 임베드하지 않습니다 — 공식 문서에 두어 항상 최신 상태를 유지합니다.

설치

npmyarnpnpmbun

npx skills add https://github.com/pelagornis/refineui --skill refineui

파일 구조

skills/refineui/
├── SKILL.md                      # Entry — request classification & doc routing
├── references/
│   ├── design-rules.md           # Points to canonical DESIGN.md
│   ├── doctor.md                 # Doctor workflow & report schema
│   └── mcp.md                    # @refineui/mcp setup & tools
└── rules/                        # Doctor rule definitions (read-only diagnostics)
    ├── package-setup.md
    ├── stylesheet-setup.md
    ├── foundation-contract.md
    ├── composition-api.md
    └── component-imports.md

File	When the agent reads it
SKILL.md	RefineUI 관련 질문 — 문서 또는 references로 라우팅
references/design-rules.md	UI 코드 작성·리뷰 → DESIGN.md 열기
references/doctor.md	헬스 체크 / “RefineUI를 올바르게 쓰고 있나?” 요청
references/mcp.md	MCP 호스트 설정 또는 도구 선택
rules/*.md	Doctor 진단 (수동 또는 refineui-doctor CLI)

문서 라우팅

에이전트는 암기한 슬러그에 의존하지 말고 매 작업마다 인덱스를 가져와야 합니다.

1. 시각적 아이덴티티를 위해 https://ui.pelagornis.com/DESIGN.md 읽기
2. https://ui.pelagornis.com/llms.txt 또는 https://ui.pelagornis.com/llm.txt 읽기
3. Foundations, Components, Development leaf 페이지 링크를 따라가기
4. 코드 생성 시 컴포넌트 문서와 설치, 테마를 함께 사용

MCP가 설정되어 있으면 @refineui/mcp의 search_docs, get_doc_page, get_design_rules를 우선 사용하세요.

요청 분류

Request	Action
Token / color / spacing 의미	Foundations 문서만
컴포넌트 API 또는 예제	컴포넌트 문서 + 선택적 MCP get_doc_page
앱 설정 / CSS 임포트	Development 문서 + package.json 검사
“RefineUI 잘 쓰고 있나?” / 설정 감사	Doctor + references/doctor.md 또는 MCP run_doctor
“List all components”	llm.txt 또는 MCP list_components

모노레포 (이 저장소)

이 모노레포에서 소스는 packages/tokens, packages/react, docs/에 있습니다. 스킬은 소비자 프로젝트에 설치하고, 여기서는 리뷰와 skills add 배포를 위해 skills/refineui/에서 사용할 수 있습니다.