Communitygithub.com

Neus UI 랜딩 레이아웃

사이드바 없이 마케팅 페이지 셸(고정 헤더, 메인 콘텐츠 영역, 푸터)을 생성합니다. 공개 페이지 및 랜딩 페이지용 .tsx 레이아웃 래퍼를 제공하며 AppTemplate을 사용하지 않습니다.

Neus UI 랜딩 레이아웃란 무엇인가요?

이 스킬은 `KazmerMaximiliano/neus-ui` 패키지를 기반으로 사이드바가 없는 마케팅/랜딩 페이지용 셸 레이아웃을 생성하는 에이전트 전용 기술입니다. 고정 헤더(sticky header), 메인 콘텐츠 영역, 푸터로 구성된 구조를 `.tsx` 파일로 만들어 주며, `AppTemplate`을 사용하지 않고 `ThemeProvider`를 통해 테마 색상을 주입합니다. 사용자는 브랜드명, 헤더 내비게이션 항목, CTA 버튼 텍스트, 푸터 구성, 테마 색상, 라이트/다크 모드 등 필요한 정보를 자유 텍스트로 입력하면, 에이전트가 이를 바탕으로 `LandingLayout.types.ts`, `LandingLayout.tsx`, `LandingLayout.styles.css` 세 가지 파일을 순서대로 생성합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 코딩 도우미와 함께 사용하도록 설계되었으며, 공유 규칙(Shared Rules)을 통해 일관된 코드 품질을 유지하고 금지된 패턴(slop)을 방지합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KazmerMaximiliano/neus-ui/tree/HEAD/.agents/skills/neus-layout-landing

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

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

문서

Neus Layout Landing

공개 페이지 셸(고정 헤더 + 메인 + 푸터)을 생성합니다. AppTemplate, 사이드바 없음.

시작하기 전에

아래 "공유 규칙" 섹션은 항상 활성화됩니다. 추가로 다음 파일을 읽으세요:

  • .agents/skills/_shared/anti-slop.md — 필수 품질 규칙
  • .agents/skills/_shared/prop-constraints.md — 금지된 props 및 존재하지 않는 컴포넌트
  • .agents/skills/_shared/component-catalog.md — Button, Link 섹션
  • .agents/skills/_shared/theme-config.md — ThemeProvider 설정
  • .agents/skills/_shared/checklist.md — P0/P1/P2 게이트
  • .agents/skills/_shared/dark-surfaces.md — 다크 모드 CSS 레시피 (Mode: dark일 때 읽기)
  • .agents/skills/_shared/light-surfaces.md — 라이트 모드 CSS 레시피 (Mode: light일 때 읽기)

Phase 0 — 데이터 수집

자유 텍스트로 다음을 질문하세요:

  1. 브랜드/제품명 (헤더 로고용)
  2. 헤더 내비게이션 항목 (정확한 링크)
  3. 헤더 CTA? (버튼 텍스트 — 예: "Get started free")
  4. 푸터: 링크 열 또는 저작권만
  5. 기본 테마 색상
  6. 테마 모드: light 또는 dark? (기본값: light)

Phase 1 — 시각적 방향 설정

코드를 작성하기 전에, 입력받은 답변에서 시각적 지시를 결정하세요.

  • Mode: dark → dark-surfaces.md 읽기; 다운 캔버스 #0a0a14, 유리 내비, 유리 표면 사용
  • Mode: light → light-surfaces.md 읽기; var(--color-white) 캔버스, 흰색 단색 내비 사용

지시를 선언하세요:

VISUAL DIRECTIVE
  Mode: dark | light
  Surface file: dark-surfaces.md | light-surfaces.md

Phase 2 — 생성

다음 순서로 세 개의 파일을 생성하세요: LandingLayout.types.ts → LandingLayout.tsx → LandingLayout.styles.css

LandingLayout.types.ts

export type NavItem = {
  label: string;
  href: string;
};

export type LandingLayoutProps = {
  children: React.ReactNode;
};

LandingLayout.tsx

import { Button, Link, ThemeProvider } from 'neus-ui';
import './LandingLayout.styles.css';
import type { LandingLayoutProps } from './LandingLayout.types';

export const LandingLayout = ({ children }: LandingLayoutProps) => (
  <ThemeProvider initialTheme={{ primaryColor: '[intake에서 받은 hex 값]' }}>
    <div className="landing-layout">
      {/* 고정 내비게이션 헤더 */}
      <header className="landing-layout__header">
        <div className="landing-layout__header-inner">
          <span className="landing-layout__brand">[BrandName]</span>
          <nav className="landing-layout__nav">
            {/* intake에서 받은 내비 항목 — 흰색 헤더 배경에 type="primary" 사용 */}
            <Link label="[NavItem1]" type="primary" href="#[section]" />
          </nav>
          <Button label="[Header CTA]" variant="solid" color="primary" onClick={() => {}} />
        </div>
      </header>

      {/* 페이지 콘텐츠 */}
      <main className="landing-layout__main">
        {children}
      </main>

      {/* 푸터 */}
      <footer className="landing-layout__footer">
        <span>[BrandName] © {new Date().getFullYear()}</span>
        <div className="landing-layout__footer-links">
          <Link label="Terms" type="secondary" href="/terms" />
          <Link label="Privacy" type="secondary" href="/privacy" />
        </div>
      </footer>
    </div>
  </ThemeProvider>
);

LandingLayout.styles.css

VISUAL DIRECTIVE의 Mode를 적용하세요. 결정된 surface 파일의 표면 레시피를 사용하세요.

라이트 모드 (Mode: light):

.landing-layout { min-height: 100vh; display: flex; flex-direction: column; background: var(--color-white); }
.landing-layout__header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: rgba(255, 255, 255, 0.85);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid var(--color-border-light);
}
.landing-layout__header-inner {
  max-width: 1200px;
  margin: 0 auto;
  padding: 1rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 2rem;
}
.landing-layout__brand {
  font-family: var(--font-display);
  font-size: 1.25rem;
  font-weight: 700;
  color: var(--color-primary);
}
.landing-layout__nav { display: flex; gap: 1.5rem; align-items: center; }
.landing-layout__main { flex: 1; }
.landing-layout__footer {
  padding: 1.5rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  border-top: 1px solid var(--color-border-light);
  font-size: 0.9rem;
  color: var(--color-gray-500);
}
.landing-layout__footer-links { display: flex; gap: 1rem; }

다크 모드 (Mode: dark) — 라이트 모드 규칙 대신 사용:

.landing-layout { min-height: 100vh; display: flex; flex-direction: column; background: #0a0a14; color: #e2e8f0; }
.landing-layout__header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: rgba(10, 10, 20, 0.8);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}
/* (header-inner, brand, nav, main — 라이트 모드와 동일) */
.landing-layout__brand { color: #818cf8; }
.landing-layout__footer {
  padding: 1.5rem 2rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
  border-top: 1px solid rgba(255, 255, 255, 0.08);
  font-size: 0.9rem;
  color: #64748b;
}

공유 규칙 (포함됨)

이 규칙은 항상 활성화됩니다. _shared/ 파일을 읽지 않아도 적용됩니다.

출력 — 항상 세 개의 파일

모든 스킬 출력: ComponentName.types.ts → ComponentName.tsx → ComponentName.styles.css 인라인 스타일(style={{}}) 없음. 컴포넌트 내 <style> 태그 없음. CSS는 오직 .styles.css 파일에만.

Imports

import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';

절대 ../../components/Button/Button 같은 내부 경로에서 import 하지 마세요.

Types

모든 type / interface 선언 → ComponentName.types.ts. .tsx 파일에 타입을 선언하지 마세요.

React 19 — FormEvent 없음

절대 import { FormEvent } from 'react' 하지 마세요. 대신 <Button type="submit" onClick={...} />를 사용하세요.

컴포넌트 Prop 제약 조건

  • Button variant: "solid" | "outlined" | "text" — "ghost"는 존재하지 않음
  • Button color: "primary" | "success" | "error" | "info" | "white" — "white"는 다크 캔버스 전용
  • Button size: "small" | "medium" | "large"
  • Card variant: "default" | "glass" — "glass"는 다크 캔버스용
  • Badge color: "primary" | "success" | "error" | "info" | "neutral"
  • Link type: "primary" (브랜드) | "secondary" (흐린 회색)
  • Select: required prop 없음 — 외부에서 유효성 검사 처리
  • FormTemplate: children, submitLabel, loading만 허용 — onSubmit/onCancel 없음

Slop 블랙리스트

  • 인라인 스타일 / style={{}} / <style> 태그 없음
  • API에서 데이터를 가져올 때 하드코딩된 데이터 배열 없음 — 타입이 지정된 props 사용
  • 지어낸 복사본 없음 (가짜 사용 후기, 플레이스홀더 이름, 가짜 지표)
  • any TypeScript 타입 없음
  • Neus UI 컴포넌트가 존재하는 경우 원시 <a>, <span>, <input>, <button> 없음
  • 하드코딩된 글꼴 스택 없음 — var(--font-display) / var(--font-mono) 사용
  • 다크 모드에서: 섹션 배경에 var(--color-primary-light) 사용 금지; 원시 div 카드 금지 — <Card variant="glass"> 사용

Individual skills in this repo

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

관련 스킬