Communitygithub.com

프론트엔드 스타일 추출기

디자인 스킬입니다. 기존 웹 앱이나 접근 가능한 웹사이트에서 프론트엔드 디자인 시스템을 추출하여 문서화합니다. UI 스타일, 디자인 토큰, 타이포그래피, 레이아웃, 컴포넌트, 인터랙션, 반응형 분석 또는 재사용 가능한 스타일 규칙 생성 요청 시 사용하세요. 소스 앱을 재설계, 수정 또는 마이그레이션하지 않습니다.

프론트엔드 스타일 추출기란 무엇인가요?

이 스킬은 프론트엔드 개발자와 AI 에이전트가 기존 웹 애플리케이션에서 프레임워크에 구애받지 않는 이식 가능한 디자인 시스템 번들을 체계적으로 추출하고 문서화할 수 있도록 설계되었습니다. 소스 코드나 접근 가능한 웹사이트를 분석하여 색상, 타이포그래피, 간격, 레이아웃 규칙, 컴포넌트 계약 및 인터랙션 패턴과 같은 디자인 토큰을 증거 기반으로 문서화합니다. 이 프로세스는 정확성을 보장하기 위해 검증 스크립트를 실행하고 사람 또는 AI가 읽을 수 있는 파일(manifest.json, tokens.json, rules.json 등)을 생성합니다. 이는 시각적 복제본이 아닌 디자인 시스템의 의도와 규칙을 캡처하는 '핸드오프 계약' 역할을 하여 `frontend-style-adapter`와 같은 다운스트림 도구가 다양한 프로젝트에서 디자인 시스템을 재사용할 수 있도록 합니다. Claude Code, Cursor, Codex 및 유사한 터미널 기반 AI 에이전트를 지원하며 소스 코드를 수정하는 것을 방지하고 모든 추출된 사실이 추적 가능한지 확인합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaduroLabs/styleport/tree/HEAD/skills/frontend-style-extractor

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

프론트엔드 스타일 추출기은(는) 무엇을 하나요?

목적

소스 프론트엔드로부터 증거 기반의 프레임워크 중립적인 이식 가능한 디자인 시스템 번들 v1.0.0을 생성합니다. 출력물은 frontend-style-adapter를 위한 핸드오프 계약이며, 복사된 소스 코드나 픽셀 단위 클론이 아닙니다.

번들을 작성하기 전에 references/CONTRACT.md를 읽으십시오. 검사 중에는 references/INSPECTION_CHECKLIST.md를 읽으십시오. 스타일 값을 임의로 발명하거나 추론된 패턴을 관찰된 사실로 표현하지 마십시오.

입력

  • 소스: 리포지토리 루트 / 워크스페이스, 선택된 디렉토리, 또는 접근 가능한 렌더링된 웹사이트.
  • 선택 사항: 특정 페이지/컴포넌트, 테마, 중단점, 디자인 충실도, 출력 경로.
  • 기본값: 소스 = 현재 리포지토리; 범위 = 리포지토리에서 발견 가능한 대표적인 공유 UI + 경로/페이지; 출력 = 소스 리포지토리 내 design-system/portable/ (사용자가 다른 위치를 요청하지 않는 한).
  • 접근 가능한 소스 CSS나 계산된 스타일이 없는 공개 URL은 시각적 전용 소스입니다. 도구를 통해 측정할 수 없는 한 정확한 픽셀/색상/간격 측정값은 추론된 것으로 표시하십시오. 환경이 웹사이트를 열 수 없는 경우, 분석을 조작하는 대신 제한 사항을 설명하십시오.

워크플로우

  1. 소스를 변경하지 않고 방향 파악. git 상태, 프로젝트 구조, 패키지 매니페스트, 프레임워크 및 스타일링 스택, 경로/페이지 구조, 전역 스타일, 테마 프로바이더, 컴포넌트 라이브러리 및 디자인 토큰을 확인하십시오. AGENTS.md 및 리포지토리 지침을 준수하십시오. .env, 비밀 정보 또는 관련 없는 데이터를 절대 읽지 마십시오.
  2. 선택적 휴리스틱 인벤토리 실행 (표준 라이브러리 전용; 권위 있는 CSS 파서가 아님): python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json 가능하면 리포지토리 외부의 임시 경로를 사용하십시오. 요약을 읽고 코드/렌더링된 UI에서 중요한 주장을 직접 검증하십시오.
  3. 대표 UI 샘플링: 전역 셸, 내비게이션, 제목/텍스트, 버튼, 필드/폼, 카드, 테이블, 모달, 알림, 로딩/빈/오류 상태; 데스크탑과 모바일, 호버/포커스/비활성화, 지원되는 경우 라이트/다크를 검사하십시오. 일반적이지 않은 경로와 일반적인 경로를 모두 샘플링하십시오. 검사된 표면과 건너뛴 표면을 기록하십시오.
  4. 규칙 계층 해결: 명시적 토큰/구성 → 공유 컴포넌트 → 반복되는 페이지 패턴 → 일회성 예외. 단일 페이지의 레이아웃을 전역 규칙으로 오해하지 마십시오. 의미 있는 경우 의미론적 토큰과 별칭(예: var(--brand-primary))을 보존하고, 검증된 경우에만 실제 확인된 값을 명시하십시오.
  5. 출처 기록: 각 토큰과 각 구조화된 규칙에는 origin, confidence 및 구체적인 evidence가 필요합니다. 파일 경로 + 라인/심볼, 계산된 스타일 관찰 또는 스크린샷/뷰포트 참조를 선호하십시오. 지원되지 않는 모든 추론은 그렇게 레이블을 지정해야 합니다. 모든 제한 사항, 검사되지 않은 페이지, 종속성/에셋 라이선스 불확실성을 명시하십시오.
  6. 번들 작성 선택한 출력 경로에. 필수 파일: manifest.json, tokens.json, rules.json, README.md, typography.md, layout-rules.md, component-rules.md, interaction-rules.md, responsive-rules.md. 선택 사항 assets.md (아이콘/이미지/폰트 고려 사항). 모양은 references/CONTRACT.md 및 assets/example-bundle/을 참조하십시오. 모든 예제 콘텐츠를 소스별 관찰로 바꾸십시오. 프레임워크별 구현만 유일한 설명으로 사용하지 말고 이식 가능한 언어(컴포넌트 계약 및 디자인 의도)를 사용하십시오.
  7. 검증: python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. 모든 오류를 수정하십시오. 알 수 없거나 신뢰도가 낮은 항목을 수동으로 검사하십시오. 브라우저/스크린샷 비교가 수행되지 않은 경우 시각적 충실도가 테스트되었다고 주장하지 마십시오.
  8. 보고: 소스 및 검사된 표면, 프레임워크/스타일링 방법, 출력 경로, 토큰/규칙 수, 적용 범위/불확실성, 검증기 결과 및 핸드오프 사용법: frontend-style-adapter를 디자인 시스템 경로와 함께 호출하십시오.

엄격한 제약 조건

  • 디자인 언어를 추출하고 비즈니스 로직, 복사본, 독점 에셋 또는 구현 내부는 추출하지 마십시오.
  • 앱 소스를 수정하거나, 패키지를 설치하거나, 구성을 다시 작성하거나, 자동으로 커밋하지 마십시오. 요청된 번들을 생성하는 것은 허용됩니다.
  • 사용자가 명시적으로 승인하고 권리가 명확하지 않은 한 로고, 폰트 바이너리, 라이선스 이미지/아이콘을 번들에 복사하지 마십시오. 대신 그 모양, 원본 참조 및 라이선스 주의 사항을 설명하십시오.
  • .env, 자격 증명, 사용자 데이터, 라이브 API 응답 또는 비밀을 전송하지 마십시오.
  • 별도의 다크/라이트 테마와 반응형 규칙이 존재하면 보존하고 단일 스타일로 평탄화하지 마십시오.
  • 정확한 구현 세부 사항은 evidence/notes에 속하며 요구 사항은 크로스 프레임워크 이식 가능해야 합니다.
  • 양보다 명확성을 선호하십시오: 가치가 높은 문서화된 패턴이 수백 개의 지원되지 않는 토큰보다 낫습니다.
  • 실행 가능한 UI/브라우저를 사용할 수 없는 경우 매니페스트에 visualVerification: "not_performed"를 보고하십시오.

완료 조건

번들이 검증되고, 내보낸 모든 사실이 추적 가능하며, 전역 규칙이 예외와 분리되고, 접근성/반응형 상태가 처리되고, 보고서에 알려진 격차가 명시됩니다.

관련 스킬