Communitygithub.com

markitui-build-pages

디자인 스킬입니다. 마크잇UI 피그마 파일에서 라이브러리 블록을 활용하여 웹사이트 또는 온라인 스토어 페이지를 제작합니다: 승인을 위한 페이지 계획, 프로젝트 블록, xl 및 base 페이지 프레임(선택적으로 md 태블릿 프레임 포함), 개발자 전달 노트를 제공합니다. 누군가가 마크잇UI에서 페이지, 사이트맵, 랜딩 페이지 또는 스토어를 디자인, 구성, 계획 또는 제작하려 할 때 사용합니다.

markitui-build-pages란 무엇인가요?

이 스킬은 마크잇UI(MarkitUI) 피그마 파일에서 웹사이트나 온라인 스토어 페이지를 제작하는 과정을 안내합니다. 사용자의 요청(브리프, 사이트맵, 기존 웹사이트 등)을 바탕으로 4단계 워크플로우를 통해 페이지를 완성합니다: 1) 페이지 계획 수립 후 승인 대기, 2) 프로젝트 블록 생성 및 커스터마이징, 3) Breakpoint 컴포넌트를 활용한 페이지 구성 및 프레임 분리, 4) 개발자 전달 노트 추가. xl(데스크탑)과 base(모바일) 프레임을 기본으로 제공하며, 사용자가 원할 경우 md(태블릿) 변형도 추가할 수 있습니다. 모든 작업은 피그마 MCP 서버의 쓰기 권한을 통해 이루어지며, 라이브러리 블록과 기본 컴포넌트는 절대 수정하지 않고 프로젝트 블록을 통해 커스터마이징합니다. 주요 사용처는 마크잇UI 템플릿을 활용한 웹사이트 디자인, 랜딩 페이지 제작, 온라인 스토어 구축 등이며, 사용자 승인 후에만 실제 페이지를 빌드합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/studio-coal/markitui/tree/HEAD/skills/markitui-build-pages

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

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

문서

MarkitUI: 페이지 제작

브리프, 사이트맵, 페이지 목록, 참조 웹사이트 또는 기존 웹사이트를 사용자의 마크잇UI 피그마 파일에 완성된 페이지로 전환합니다. 워크플로우는 항상 다음과 같습니다:

라이브러리 블록 → 프로젝트 블록 → Breakpoint 컴포넌트로 구성된 페이지 → 분리된 {Page} / xl 및 {Page} / base 프레임 (사용자가 태블릿을 원하는 경우 {Page} / md 포함), 페이지당 하나의 Section으로 구성 → 전달 노트.

파일 자체의 문서가 진리(source of truth)입니다. 실행을 시작할 때마다 Composing pages, Layout 및 Breakpoints 문서 프레임(Documentation 페이지)과 Navigation 문서 프레임(블록 카테고리 목록)을 읽으십시오. 사이트에 블로그, 체인지로그, 고객 사례 또는 이벤트가 있는 경우 Archive Components 페이지의 Archive pages 문서 프레임과 Blog (Archive / Post) 페이지의 Assembling archive and detail pages 문서 프레임도 읽으십시오. 이 스킬의 내용이 파일 문서와 일치하지 않으면 파일 문서를 따르십시오.

시작하기 전에

  • 사용자 소유의 마크잇UI 사본에서만 작업하십시오. 링크가 없으면 피그마 링크를 요청하십시오.
  • 피그마에 쓰려면 쓰기 접근 권한이 있는 Figma MCP 서버가 필요합니다. 첫 번째 수정 전에 Figma MCP의 파일 쓰기 지침(figma-use 스킬)을 로드하고, 서버가 세션을 요청하면 먼저 세션을 생성하십시오.
  • 피그마 페이지는 스크립트당 최대 한 번만 전환하십시오. 페이지, 컴포넌트 및 변수 컬렉션은 ID가 아닌 이름으로 찾으십시오.
  • 라이브러리 블록과 기본 컴포넌트는 최종본입니다. 페이지가 작동하도록 절대 수정하지 마십시오. 블록으로 해결할 수 없는 문제가 있으면 사용자에게 알리고 문의하십시오.

시작 질문

계획을 세우기 전에 사용자의 프롬프트가 명확히 알려주지 않는 사항을 하나의 메시지로 물어보십시오(인터페이스가 지원하는 경우 객관식 질문 사용). 프롬프트가 명확하게 답변한 질문은 건너뛰십시오.

  1. 페이지를 무엇으로부터 만들까요?

    • 비즈니스 브리프 또는 설명
    • 사이트맵 또는 페이지 목록
    • 참조할 웹사이트(구조만 참조, 새 콘텐츠)
    • 리빌드할 기존 웹사이트(기존 콘텐츠 유지)
    • 기타 자료: 스크린샷, 문서, 경쟁사 사이트, 와이어프레임
  2. 반응형 변형: 각 블록과 페이지에 몇 개의 중단점 변형을 만들까요?

    • xl + base (데스크탑 및 모바일; 기본값, 라이브러리 블록이 준비됨)
    • xl + md + base (태블릿 추가: 모든 프로젝트 블록에 md 변형, 모든 페이지에 md 프레임)
    • 일부 페이지만 md (사용자가 페이지 이름 지정)

    references/responsive.md의 한 줄 트레이드오프를 제공하십시오. 승인 없이 md를 추가하지 마십시오.

  3. 프로젝트 이름, 모든 컴포넌트 이름에 사용됨 (예: Acme).

  4. 사이트 유형: 마케팅 웹사이트, 온라인 스토어 또는 둘 다.

  5. 빌드 위치: 사용자가 지정하지 않는 경우 파일의 새 피그마 페이지 (예: ↳ Acme Pages).

  6. 콘텐츠: 사용자의 실제 콘텐츠, 참조 사이트 스타일로 작성된 콘텐츠, 또는 그럴듯한 플레이스홀더 콘텐츠.

  7. 스토어의 경우: 국가, 통화 및 숫자 형식, VAT 또는 판매세율.

그런 다음 선택한 출처(브리프, 사이트맵 또는 웹사이트 URL)에 필요한 정보를 수집하십시오(참조 또는 기존 사이트의 경우 references/existing-site.md 읽기).

기본적으로 프로젝트 블록을 사용하십시오. 사용자가 빠른 프로토타입이나 단일 랜딩 페이지를 요청하는 경우에만 라이브러리 블록을 직접 사용하십시오.

워크플로우

1단계: 페이지 계획 (승인을 위해 중단). references/page-planning.md를 읽으십시오. 계획에는 사용자가 선택한 중단점이 명시됩니다. 라이브러리를 인벤토리하고 각 페이지에 대한 블록을 선택한 후 계획 테이블을 제시하십시오. 블로그, 체인지로그, 고객 사례 또는 이벤트 및 웨비나 페이지의 경우 references/content-types.md를 읽고 각각에 대한 아카이브 페이지와 상세 템플릿을 계획하십시오. 입력이 리빌드할 기존 웹사이트인 경우 먼저 references/existing-site.md를 읽으십시오. 동일한 계획을 생성합니다. 중단하고 승인 또는 변경 요청을 기다리십시오.

2단계: 프로젝트 블록. references/project-blocks.md를 읽으십시오. 선택한 각 라이브러리 블록을 프로젝트 블록으로 복제하고, 이름을 변경한 후 마스터에서 조정하십시오. 내비게이션 바, 메뉴 및 푸터도 프로젝트 블록으로 구축하십시오. 아카이브 블록의 경우 references/content-types.md에 설명된 대로 프로젝트 블록 마스터에 아카이브 컴포넌트(헤더, 사이드바, 페이지네이션)를 설정하십시오. 사용자가 md를 선택한 경우 references/responsive.md를 읽고 md 페이지에서 사용하는 모든 프로젝트 블록에 md 변형을 추가하십시오.

3단계: 페이지 구성. references/composing.md 및 references/content.md를 읽으십시오. Breakpoint 컴포넌트에서 xl로 각 페이지를 구축하고, base(및 md, references/responsive.md에 따라)로 복제한 후 분리하고, 이름을 지정하고, Section으로 감싸고 캔버스에 배치하십시오.

4단계: 전달 노트. references/handoff.md를 읽으십시오. 모든 xl 프레임에 라우트 주석을 추가하고, 정적 프레임이 동작을 표시할 수 없는 경우 동작 및 콘텐츠 주석을 추가하십시오.

확인 및 보고. references/checks.md를 읽으십시오. 스크립트 검사를 실행하고, 각 중단점에서 모든 페이지를 스크린샷으로 찍고, 발견된 문제를 수정한 후 보고하십시오.

참조 파일: 해당 단계에서 각 파일 읽기

  • references/page-planning.md: 페이지 구성, 블록 선택, 계획 테이블. 1단계.
  • references/existing-site.md: 기존 웹사이트 리빌드. 1단계, 입력이 라이브 사이트인 경우.
  • references/content-types.md: 블로그, 체인지로그, 고객 사례 및 이벤트 & 웨비나의 아카이브 및 상세 페이지; ArchiveHeader, ArchiveSidebar 및 ArchivePagination. 1-3단계, 사이트에 해당 유형이 있는 경우.
  • references/project-blocks.md: 복제, 이름 변경, 마스터에서 변경할 사항, 디자인 규칙. 2단계.
  • references/responsive.md: md 옵션, 프로젝트 블록에 md 변형 추가, Breakpoint 컴포넌트로 md 페이지 조립. 시작 질문, 2단계 및 3단계, md가 선택된 경우.
  • references/composing.md: Breakpoint 컴포넌트, xl 및 base, 분리, 이름 지정, 캔버스 레이아웃. 3단계.
  • references/content.md: 콘텐츠, 스토어 데이터, 날짜, 이미지. 3단계.
  • references/handoff.md: 개발자와 generate-code 스킬이 의존하는 주석 형식. 4단계.
  • references/checks.md: 감사, 스크린샷 및 보고서. 마지막.

비협상 사항

  • 프롬프트가 답변하지 않은 시작 질문(반응형 변형 포함)을 계획 전에 반드시 물어보십시오.
  • 계획 후 중단하고 승인을 기다리십시오. 승인되지 않은 계획으로 페이지를 절대 만들지 마십시오.
  • 라이브러리 블록, 기본 컴포넌트 또는 아카이브 컴포넌트를 절대 수정하지 마십시오. 모든 변경은 프로젝트 블록이나 인스턴스 오버라이드에 적용됩니다.
  • 모든 페이지에는 동일한 블록으로 구축된 xl 및 base 프레임(선택한 경우 md 프레임)이 있으며, 각 블록의 Breakpoint는 해당 프레임과 일치해야 합니다.
  • 모든 것은 마크잇UI 변수와 텍스트 스타일로 유지됩니다. 원시 색상, 간격, 반경 또는 글꼴 설정은 사용하지 마십시오.
  • 실제 또는 그럴듯한 콘텐츠만 사용하고, Lorem ipsum은 사용하지 마십시오. 사용자의 것이 아닌 실제 브랜드 이름이나 로고는 사용하지 마십시오.
  • 모든 xl 프레임에는 references/handoff.md에 명시된 정확한 형식의 라우트 주석이 있어야 합니다.

관련 스킬