Communitygithub.com

umairmsm/wp-design

워드프레스 사이트 구축의 2단계 - 디자인 방향 설정, 디자인 토큰을 포함한 정적 HTML/CSS 프로토타입, 소유자 승인 및 스크린샷, 자체 호스팅 폰트, 승인된 디자인을 교체 가능한 워드프레스 스킨으로 포팅합니다. "사이트 디자인", "새로운 디자인", "리디자인", "색상 또는 폰트 변경", "새 스킨 만들기", "프로토타입을 워드프레스로 포팅" 작업에 사용합니다.

wp-design란 무엇인가요?

이 스킬은 워드프레스 사이트 구축 워크플로우의 2단계(디자인 단계)를 담당합니다. 소유자가 휴대폰과 노트북에서 확인한 디자인을 승인한 후, 해당 디자인을 디자인 토큰으로 체계화하여 나중에 쉽게 교체할 수 있는 워드프레스 스킨으로 포팅합니다. 주요 단계는 디자인 방향 문서화, 정적 HTML/CSS 프로토타입 제작, 접근성 검사, 소유자 승인 및 스크린샯 기록, 자체 호스팅 폰트 설정, 승인된 디자인을 워드프레스 스킨으로 이식하는 것을 포함합니다. 이 스킬은 `docs/DESIGN_DIRECTION.md`, `static/css/tokens.css`, 그리고 `skins/` 디렉토리 구조를 활용하며, Claude Code, Cursor, Codex 등 모든 AI 에이전트 플랫폼에서 실행 가능합니다. 핵심 철학은 모든 디자인을 처음부터 스킨으로 구축하여 향후 리디자인 시 기능 손실 없이 디자인만 교체할 수 있도록 하는 것입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umairmsm/wp-site-kit/tree/HEAD/skills/wp-design

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

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

문서

2단계: 디자인

목표: 소유자가 휴대폰과 노트북에서 확인한 디자인을 승인했습니다. 이 디자인은 토큰으로 작성되어 복사만으로 워드프레스 스킨이 될 수 있으며, 기능 손실 없이 나중에 교체할 수 있습니다.

단계

  1. 방향. 프로젝트의 docs/DESIGN_DIRECTION.md를 작성합니다: 북두칠성, 대상 고객, 피해야 할 모습(경쟁사, 템플릿), 그리고 양보할 수 없는 사항. 전체 사이트가 아닌 작은 무드 보드나 히어로 목업 형태로 최대 두세 가지 방향을 제시합니다.
  2. static/에 프로토타입 제작. 순수 HTML과 CSS. css/tokens.css는 테마의 skins/default/tokens.css와 동일한 이름을 사용합니다. 컴포넌트는 토큰만 사용합니다. 실제 구조(헤더, 히어로, 카드, 폼, 푸터), 플레이스홀더 콘텐츠, 가격이나 정책 텍스트는 없습니다.
  3. 처음부터 접근성 보장:
    • 텍스트 명암비 ≥ 4.5:1;
    • 포커스 표시;
    • H1 하나;
    • 스킵 링크;
    • 키보드 경로;
    • prefers-reduced-motion 준수. 프로토타입을 보여주기 전에 axe(브라우저 확장 프로그램)로 확인합니다.
  4. 소유자 검토. 모든 페이지를 휴대폰(375px)과 노트북(1440px) 너비로 스크린샷을 찍습니다. DESIGN_DIRECTION.md에 승인 날짜를 기록하고 스크린샷을 docs/design/에 저장합니다.
  5. 글꼴: .woff2 파일을 자체 호스팅하고, 필요한 언어로 서브셋하며, 라이선스를 확인하고, 첫 화면에 표시되는 한두 개의 서체를 미리 로드합니다(이름을 *-preload.woff2로 지정). 어디에서도 Google Fonts 요청이 없어야 합니다.
  6. 워드프레스로 포팅 (references/design-system.md):
    • 토큰을 스킨에 복사합니다;
    • 컴포넌트 CSS를 skin.css로 이동합니다;
    • 코어의 렌더 함수를 사용하여 템플릿을 배치합니다;
    • 마크업이 달라져야 하는 경우에만 스킨 부분 오버라이드를 추가합니다. 디자인이 변경됩니다. 코어의 데이터와 마크업 계약은 변경되지 않습니다.
  7. 이후 리디자인은 새 스킨입니다: skins/default를 skins/<name>으로 복사하고, 토큰을 변경하며, ?skin=<name>(관리자)으로 미리보기하고, 승인되면 <prefix>_skin 옵션으로 전환합니다.

게이트 (SITE_STATUS.md에 체크)

  • DESIGN_DIRECTION.md 작성됨; 스크린샷과 함께 소유자 승인 기록됨
  • 토큰 정의됨; 컴포넌트가 토큰만 사용
  • 글꼴 자체 호스팅됨; Google Fonts 요청 0건

교훈

  • 비즈니스 파트너가 자신의 리디자인을 보냈을 때 고정된 디자인이 변경되었습니다. 디자인이 스킨이었기 때문에 전환 시 모든 기능이 유지되었습니다. 첫 번째 디자인조차 항상 스킨으로 구축하세요.
  • 경쟁사의 팔레트, 글꼴 쌍 또는 레이아웃을 복사하지 마세요. 소유자가 알아차리고 방문자는 당신을 기억하지 못합니다.
  • 아이디어를 시험해보기 위한 테스트 전용 스킨(dev-*)은 프로덕션에 표시되지 않습니다.
  • frontend-design 또는 design-motion-principles 스킬이 설치된 경우, 방향 설정과 모션에 해당 스킬을 사용하세요.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

umairmsm/wp-build

Stage 3 of a wp-site-kit WordPress build - local DDEV site, the core must-use plugin (modules), the presentation-only child theme with skins, the content model (custom post types, meta, WP_Query, render functions), and the enquiry pipeline that saves leads before forwarding. Use when building or changing features, templates, content types, forms or plugin modules on a wp-site-kit site.

umairmsm/wp-content

Stage 4 of a wp-site-kit WordPress build - real copy and photos. Content truth (facts only from the owner), AI drafts and owner approval, claims audits, banned words and fake proof, legal pages, the photo pipeline (dedupe, real-only, EXIF strip, WebP sizes, alt text, AI image register), and recorded content changes. Use for "write the copy", "add photos", "the owner sent new photos", "check for duplicates", "update prices or text on the live site", "legal pages".

umairmsm/wp-kickoff

Stage 1 of a wp-site-kit WordPress build. Use when starting a new WordPress website or taking over or rebuilding an existing one - discovery brief, stack decision, creating the project with bin/wp-site-new, locked decisions, private repo and credentials inventory. Triggers - "new WordPress site", "start a client website", "rebuild this site", "take over this WordPress site".

umairmsm/wp-operate

Stage 8 of a wp-site-kit WordPress build and everything after launch - backups with an off-machine copy, restore drills, the disaster-recovery runbook, credentials inventory, update policy, alerts, and working from more than one machine (bridge file, workstation doctor, encrypted state bundle, rescuing unpushed work). Use for "backup", "restore", "move to a new machine/server", "update plugins", "what if the server dies", "work from the cloud box", "set up a second machine".

umairmsm/wp-seo

Stage 5 of a wp-site-kit WordPress build - titles and descriptions, canonical URLs, one schema owner and JSON-LD, sitemaps, robots.txt and llms.txt, AI crawler access, redirects (301 vs 302), legacy URL maps, Search Console, and adding languages one pilot at a time with Polylang (hreflang, .po/.mo strings, native review). Use for "SEO", "schema", "redirect", "old URLs", "translate the site", "add French/Spanish", "hreflang", "canonical".

umairmsm/wp-ship

Stage 7 of a wp-site-kit WordPress build - staging behind Cloudflare Access, server hardening, safe deploys from a commit (scripts/deploy-safe.sh), database content changes, the launch audit, DNS cutover without breaking a running business, and the first week after launch. Use for "deploy", "set up staging", "go live", "launch", "cutover", "move DNS", "harden the server".

umairmsm/wp-site

Start here for any WordPress website built with wp-site-kit, from an empty folder to a live site. Use when someone says "build a WordPress site", "new website for a client", "where are we on the site", "what is next before launch", or asks to continue a site project. Finds the current stage from SITE_STATUS.md, applies the hard rules, and hands over to the right stage skill.

관련 스킬