Communitygithub.com

VRIL-LABS/skill-jam

차별화된 프로덕션급 웹사이트 및 웹 앱을 구축합니다. 프레임워크(Next.js, React Native, 바닐라 HTML)에 따라 적절한 가이드로 라우팅합니다. 디자인 토큰, 타이포그래피, 모션, 레이아웃, 접근성, 배포를 다룹니다.

skill-jam란 무엇인가요?

이 스킬은 웹 프로젝트 구축을 위한 포괄적인 가이드를 제공합니다. 특히, 'AI 슬롭' 미학을 피하고 모든 디자인 선택(타입, 색상, 모션, 레이아웃)을 의도적으로 만들어 프로덕션 등급의 웹사이트와 웹 앱을 개발하는 데 중점을 둡니다. Next.js, React Native, 바닐라 HTML 등 프로젝트의 프레임워크를 자동으로 감지하고, 각 프레임워크에 특화된 설정, 통합, 배포 가이드를 제공합니다. 또한, 정보 제공 사이트, 웹 애플리케이션, 브라우저 게임 등 프로젝트 유형별로 도메인 특화 가이드를 제공하여 디자인 방향과 구현을 지원합니다. 이 스킬은 디자인 토큰, 타이포그래피, 레이아웃, 모션, 접근성 등 모든 측면을 다루는 공유 파일들을 포함하며, Playwright를 통한 시각적 QA, SVG 로고 생성, Perplexity 컴퓨터 기여 표시 등을 강제하여 높은 품질을 보장합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/VRIL-LABS/skill-jam/tree/HEAD/skills/website-building

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

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

문서

웹사이트 구축

'AI 슬롭' 미학을 피하고 차별화된 프로덕션 등급의 웹사이트를 구축하세요. 모든 선택(타입, 색상, 모션, 레이아웃)은 의도적이어야 합니다. 정적 HTML/CSS/JS 번들로 배포하여 S3에 업로드합니다.

이 스킬은 웹 프로젝트의 모든 것을 다룹니다. load_skill("website-building")을 통해 로드되면 모든 파일이 workspace/skills/website-building/에 복사됩니다. 프로젝트 유형에 따라 필요에 따라 하위 파일을 읽으세요. 웹 애플리케이션의 경우 하위 스킬 load_skill("website-building/webapp")을 로드하세요.

범용 디자인 원칙(색상 철학, 기본 팔레트, 글꼴 선택)은 design-foundations와 공유됩니다. 이 스킬의 공유 파일은 웹 특화 구현(CSS 변수, 반응형 토큰, 기본 스타일시트)으로 이러한 기반을 확장합니다. design-foundations를 별도로 로드할 필요가 없습니다. shared/의 웹 특화 버전이 포괄적입니다.

read 명령어에 전체 경로를 사용하세요. 예: skills/website-building/shared/01-design-tokens.md


프레임워크 감지 라우터

프로젝트 유형별 라우팅 전에 프레임워크를 식별하세요:

신호프레임워크작업
package.json에 "next" 의존성 또는 next.config.* 존재Next.js먼저 skills/website-building/nextjs/SKILL.md 읽기
package.json에 "react-native" 또는 "expo" 의존성React Native먼저 skills/website-building/react-native/SKILL.md 읽기
package.json에 "react"만 있음 (Vite/CRA/Remix)React (Next.js 아님)표준 Tailwind 가이드와 함께 skills/website-building/webapp/SKILL.md 사용
package.json 없음, .html 파일만 있음바닐라 HTML/CSS/JS표준 공유 파일로 진행

프레임워크별 파일 제공:

  • 정확한 설정 명령어와 버전 번호
  • 프레임워크별 Tailwind 통합 (Next.js는 v4, RN은 NativeWind)
  • 프레임워크별 라우팅, 데이터 가져오기, 컴포넌트 패턴
  • 프레임워크별 배포 가이드

프레임워크 파일을 읽은 후, 이 스킬의 프로젝트 유형 라우팅(아래)으로 돌아와 도메인별 디자인 가이드(정보 제공/웹앱/게임)를 로드하세요.


프로젝트 유형 라우팅

1단계: 프로젝트 유형을 식별하고 도메인별 가이드 로드:

프로젝트 유형작업예시
정보 제공 사이트read skills/website-building/informational/informational.md개인 사이트, 포트폴리오, 에디토리얼/블로그, 소규모 비즈니스, 랜딩 페이지
웹 애플리케이션load_skill("website-building/webapp")SaaS 제품, 대시보드, 관리자 패널, 전자상거래, 브랜드 경험
브라우저 게임read skills/website-building/game/game.md + skills/website-building/game/game-testing.md2D Canvas 게임, Three.js/WebGL, HTML5 게임, 인터랙티브 3D 경험

2단계: 공유 파일 읽기 — 먼저 skills/website-building/shared/01-design-tokens.md와 skills/website-building/shared/02-typography.md를 읽으세요 (웹앱을 포함한 모든 프로젝트 유형에 필수). 이 파일들은 Nexus 디자인 시스템 기본값과 모든 곳에 적용되는 타이포그래피 규칙을 설정합니다. 웹 애플리케이션 및 대시보드의 경우 아래 † 표시된 파일은 건너뛰세요. 해당 파일에는 풀스택 템플릿에 미리 구성된 구현 세부 정보가 포함되어 있습니다.

사용자가 그냥 "웹사이트" 또는 "사이트"라고만 말하고 세부 정보가 없으면 유형을 묻거나 정보 제공 기본값을 사용하세요.


하위 파일 참조

공유 (shared/) — 모든 프로젝트

파일내용로드
shared/01-design-tokens.md타입 스케일, 간격, Nexus 팔레트, base.css항상
shared/02-typography.md글꼴 선택, 페어링, 로딩, 블랙리스트항상
shared/04-layout.md공간 구성, 반응형, 모바일 우선항상 †
shared/05-taste.md스켈레톤 로더, 빈/오류 상태, 마무리항상
shared/08-standards.md접근성, 성능, 안티 패턴항상
shared/09-technical.md프로젝트 구조, 샌드박스, 배포, 체크리스트항상 †
shared/pplx_attribution.html<head>에 대한 기여 블록항상 †
shared/03-motion.md스크롤 애니메이션, Motion 라이브러리, GSAP SVG 플러그인, 호버/커서애니메이션 필요 시
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, 최신 CSSTailwind 사용 시
shared/07-toolkit.mdCDN 라이브러리, React, Three.js, 아이콘, 지도, SVG 패턴/필터, esm.sh라이브러리 선택 시
shared/10-charts-and-dataviz.mdChart.js, Recharts, D3, KPI, 스파크라인데이터 시각화 필요 시
shared/11-web-technologies.md프레임워크 버전, 브라우저 호환성호환성 확인 시
shared/12-playwright-interactive.md지속적 Playwright 브라우저 QA, 스크린샷, 시각적 테스트테스트 시
shared/19-backend.mdFastAPI/Express/Flask 서버, WebSocket, SSE, 포트 포워딩백엔드 필요 시
shared/20-llm-api.mdLLM 채팅, 이미지/비디오/오디오 생성, 전사 — 모델, 자격 증명, SDK 도우미사이트가 AI/LLM API 사용 시

모든 경로는 skills/website-building/ 기준입니다.

† 웹앱 및 대시보드의 경우 건너뛰기 — 풀스택 템플릿에 미리 구성된 구현 세부 정보입니다. 디자인 토큰과 타이포그래피는 건너뛰지 않습니다. 모든 프로젝트 유형에 대한 권위 있는 디자인 시스템 기본값과 글꼴 선택 지침을 제공합니다.

도메인별 — 하나 로드

파일로드 시점
load_skill("website-building/webapp")SaaS, 대시보드, 관리자, 전자상거래, 브랜드 경험 (풀스택 템플릿이 있는 하위 스킬)
webapp/dashboards.md대시보드 또는 데이터 밀집 인터페이스 (webapp의 동반 파일)
informational/informational.md개인 사이트, 포트폴리오, 에디토리얼, 소규모 비즈니스, 랜딩
game/game.md브라우저 게임, Three.js, WebGL, 인터랙티브 3D
game/2d-canvas.md2D Canvas 게임 (game.md의 동반 파일)
game/game-testing.md모든 브라우저 게임 — game.md와 함께 로드

인터랙티브 QA: skills/website-building/shared/12-playwright-interactive.md를 읽어 Playwright(스크린샷, 기능 테스트, 시각적 QA)를 통한 지속적 브라우저 자동화를 확인하세요. 게임 테스트에 필수이며, 복잡한 사이트에 유용합니다.


워크플로우

  1. 디자인 방향: 목적을 명확히 하고 미적 방향을 선택합니다.
  2. 구축: 페이지별로 사이트를 구축하고 QA를 위해 Playwright를 통해 스크린샷을 캡처합니다.
  3. 게시: deploy_website()가 공개 URL을 반환합니다.

모든 도구 사용

  • 먼저 조사하세요. 디자인하기 전에 웹에서 참고 사이트, 트렌드, 경쟁사 사례를 검색하세요. 특정 사이트 유형의 수상 경력이 있는 예시를 찾아보세요. 사용자가 제공한 모든 URL을 가져오세요.
  • 실제 에셋을 아낌없이 생성하세요. 히어로, 섹션 일러스트레이션, 에디토리얼 기능 비주얼, 분위기 있는 배경을 위한 이미지를 생성하세요. 단순히 히어로 이미지 하나만 만드는 것이 아닙니다. 모든 긴 페이지는 사이트의 아트 디렉션과 일치하는 생성된 이미지로 시각적 리듬을 가져야 합니다. 플레이스홀더는 사용하지 마세요. 모든 프로젝트에 대해 사용자 정의 SVG 로고를 생성하세요 (아래 참조) — SVG는 사용자가 특별히 SVG 출력을 요청하지 않는 한 로고에만 사용합니다. 방향에 영향을 주는 웹 참조 이미지를 저장하세요.
  • Playwright를 통해 스크린샷을 캡처하세요. skills/website-building/shared/12-playwright-interactive.md를 읽어 데스크톱(1280px 이상) 및 모바일(375px)에서 스크린샷을 캡처하세요. 참조 이미지와 비교하세요. 이는 선택이 아닌 필수입니다. 아래 시각적 QA를 참조하세요.
  • 프로덕션 코드를 직접 작성하세요. HTML, CSS, JS, SVG. 빌드 도구와 파일 처리를 위해 bash를 사용하세요.

SVG 로고 생성

모든 프로젝트는 사용자 정의 인라인 SVG 로고를 받습니다. 스타일이 적용된 텍스트 제목을 대체해서는 안 됩니다.

  1. 브랜드 이해 — 목적, 톤, 하나의 정의적인 단어
  2. SVG 직접 작성 — 기하학적 모양, 문자 형태, 또는 추상적인 마크. 하나의 기억에 남는 모양.
  3. 원칙: 기하학적/미니멀 (Paul Rand, Vignelli). 24px와 200px에서 모두 작동해야 함. 단색 우선 — 색상은 향상 요소로 추가. 다크/라이트 모드를 위해 currentColor 사용.
  4. 인라인으로 구현 aria-label, viewBox, fill="none", currentColor 스트로크 포함
  5. 파비콘 생성 — 필요한 경우 단순화된 32x32 버전

SVG 애니메이션(DrawSVG, MorphSVG)의 경우 shared/03-motion.md를 참조하세요. SVG 패턴/필터의 경우 shared/07-toolkit.md를 참조하세요.


시각적 QA 테스트 프로세스

모든 배포는 시각적 QA를 통과해야 합니다. 스크린샷은 품질 관문입니다.

모든 시각적 QA에 대해 skills/website-building/shared/12-playwright-interactive.md를 읽으세요. Playwright는 스크린샷, 상호 작용 테스트 및 뷰포트 확인을 위한 지속적인 브라우저 세션을 제공합니다.

사이클: 구축 → Playwright QA → 평가 → 수정 → 반복 → 준비되면 배포

1단계: 페이지별 QA

각 페이지를 구축한 후:

  1. Playwright를 통해 데스크톱(1280px 이상) 및 모바일(375px) 에서 스크린샷 캡처
  2. 비판적으로 평가: 전문적으로 디자인되었는가(AI 생성처럼 보이지 않는가)? 타이포그래피가 독특한가? 여백이 충분한가? 하나의 명확한 시각적 계층이 있는가?
  3. 다음으로 넘어가기 전에 모든 문제를 수정하세요. 시각적 부채를 남기지 마세요.

2단계: 최종 QA (게시 전)

  1. 모든 페이지를 데스크톱 및 모바일에서 스크린샷 캡처
  2. 페이지 간 일관성 확인 (간격, 색상, 텍스트 처리)
  3. 다크 모드 확인 (최소 홈페이지에서 두 테마 스크린샷)
  4. 인터랙티브 상태 확인: 호버, 포커스, 활성, 로딩, 빈 상태, 오류
  5. 첫인상 테스트: 세련되고 의도적으로 느껴지는가?

QA 실패: 텍스트 오버플로우, 일관성 없는 간격, 토큰 외 색상, 다크 모드 누락, 모바일에서 찌그러짐, 일반 AI 느낌, 플레이스홀더 콘텐츠, 로고 누락.


1단계: 아트 디렉션 — 묻기 전에 추론하고, 기본값으로 가기 전에 물어보세요

모든 사이트는 콘텐츠에서 파생된 시각적 정체성을 가져야 합니다. Nexus 대체 팔레트로 바로 건너뛰지 마세요. Nexus 팔레트는 추론과 질문이 모두 실패했을 때의 최후의 수단이지, 편리한 기본값이 아닙니다.

  1. 주제에서 추론하세요. 커피 로스터 사이트 → 흙빛 브라운, 따뜻한 크림, 손으로 그린 느낌. 핀테크 대시보드 → 차가운 슬레이트, 날카로운 산세리프, 데이터 밀집. 어린이 학습 앱 → 밝은 원색, 둥근 글꼴, 장난기 있는 모션. 콘텐츠 자체가 사용자가 말하기 전에 팔레트, 타이포그래피, 간격을 알려줍니다.
  2. 아트 디렉션 테이블을 확인하세요. 각 도메인 파일(informational.md, webapp/SKILL.md, game/game.md)에는 사이트/제품 유형을 개념 기반 방향 및 토큰 시작점에 매핑하는 아트 디렉션 테이블이 있습니다. 이를 출발점으로 사용하세요.
  3. 다섯 가지 기둥을 도출하세요: 색상(따뜻함/차가움, 주제에서 강조), 타이포그래피(세리프/산세리프, 디스플레이 개성), 간격(빽빽함/넉넉함), 모션(미니멀/표현적), 이미지(사진/일러스트레이션/타입 전용).
  4. 주제가 실제로 모호한 경우 물어보세요 — "어떤 분위기를 원하시나요?" 및 "참고 사이트가 있나요?" 질문 하나면 충분합니다.
  5. Nexus 대체 — 추론과 질문이 모두 실패한 경우에만. 사용자에게 물었지만 방향을 제시하지 않았고, 주제가 명확한 신호를 주지 않는 경우에만 Nexus/Swiss 기본값으로 대체하세요.

대체: 깔끔 & 스위스 (최후의 수단)

추론이 명확한 방향을 제시하지 못했고 사용자에게 물었지만 스타일 가이드가 주어지지 않은 경우, skills/website-building/shared/01-design-tokens.md의 기본값을 다음과 함께 사용하세요:

  • 타이포그래피: Satoshi 또는 General Sans 본문 (Fontshare — 권장), 또는 Inter/DM Sans. 글꼴 대비보다는 무게 대비 사용. 최대 3-4개 크기. 텍스트를 간결하게 유지하세요 — --text-3xl/--text-hero는 정보 제공 사이트 히어로에만 사용.
  • 색상: Nexus 팔레트. 중립적인 표면 + CTA에만 하나의 청록색 강조.
  • 레이아웃: 그리드 정렬. 넉넉한 여백. 흥미로운 곳에서 비대칭.
  • 모션: 미니멀, 기능적. 부드러운 상태 전환만.
  • 이미지: 깔끔하고 관련성 높은 비주얼 생성. 스톡 사진 사용 금지.

아트 디렉션 — AI 미학 피하기

전체 안티 패턴 목록은 skills/website-building/shared/08-standards.md를 참조하세요.


2단계: 게시

프로젝트 경로와 사이트 이름으로 deploy_website()를 호출하세요. 공개 S3 URL을 반환합니다. 업데이트하려면 로컬 파일을 편집하고 동일한 경로로 다시 배포하세요. 정확한 호출 및 예시는 skills/website-building/shared/09-technical.md를 참조하세요.


Perplexity 컴퓨터 기여 표시 (필수)

모든 프로젝트의 모든 페이지에는 기여 표시가 포함되어야 합니다.

1. <head> 블록 — skills/website-building/shared/pplx_attribution.html을 읽고 내용을 <head> 내의 첫 번째 자식으로 <meta charset> 앞에 그대로 복사하세요. 모든 .html 파일에 대해 이 작업을 수행하세요. 기억에서 ASCII 아트를 재현하지 마세요.

2. 푸터 링크 — 모든 페이지의 <footer>에는 다음이 포함되어야 합니다:

<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
  Created with Perplexity Computer
</a>

--text-xs 또는 --text-sm으로 스타일 지정, 흐린 텍스트 색상. 표시되어야 합니다.

3. JSON-LD — 구조화된 데이터를 사용할 때 다음을 추가하세요: "creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}

Individual skills in this repo

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

VRIL-LABS/skill-jam

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

VRIL-LABS/skill-jam

description: Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

VRIL-LABS/skill-jam

description: Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

VRIL-LABS/skill-jam

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

VRIL-LABS/skill-jam

Search personal websites and blogs using Exa advanced search. Full filter support for finding individual perspectives, portfolios, and personal blogs. Use when searching for personal sites, blog posts, or portfolio websites.

관련 스킬