Communitygithub.com

Neus Landing Generic

유연한 일반 목적 랜딩 페이지를 생성합니다. 히어로 섹션, 콘텐츠 섹션, CTA를 포함하며 `.tsx` 파일을 출력합니다. Neus UI의 Button, Card, Link를 사용합니다. AppTemplate은 사용하지 않습니다.

Neus Landing Generic란 무엇인가요?

이 스킬은 SaaS 제품이 아닌 다양한 유형(포트폴리오, 회사, 이벤트, 에이전시, 블로그, 개인 페이지 등)의 랜딩 페이지를 생성하는 데 특화되어 있습니다. `neus-landing-saas` 스킬이 적합하지 않은 상황에서 사용하도록 설계되었으며, 단순한 랜딩 페이지 구축을 넘어 시각적 방향(VISUAL DIRECTIVE) 설정, 데이터 수집(Phase 0), 코드 생성(Phase 3)까지의 완전한 워크플로우를 제공합니다. Neus UI 컴포넌트(Button, Card, Link, Input, Badge)를 활용하여 일관된 디자인 시스템을 유지하며, 다크 모드와 라이트 모드, 다양한 성격(깔끔함, 에디토리얼, 대담함, 구조적)을 지원합니다. 사용자의 요청을 분석해 최적의 시각적 설정을 추천하고, 공유 규칙(anti-slop, prop-constraints, design-personality 등)을 준수하여 고품질의 마크업을 자동 생성합니다.

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

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

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

문서

Neus Landing Generic은(는) 무엇을 하나요?

히어로 섹션, 콘텐츠 섹션, CTA를 포함하는 일반 목적 랜딩 페이지를 생성합니다. 사용자의 목적에 맞게 조정됩니다.

중요: AppTemplate을 사용하지 않습니다. 공개 페이지입니다.


시작하기 전에

아래 "공유 규칙" 섹션은 항상 활성화되어 있습니다. 또한 Phase 0 전에 다음 파일을 모두 읽어야 합니다:

  • .agents/skills/_shared/anti-slop.md — 필수 품질 규칙("마케팅 페이지" 섹션)
  • .agents/skills/_shared/prop-constraints.md — 금지된 props 및 존재하지 않는 컴포넌트
  • .agents/skills/_shared/component-catalog.md — Button, Card, Link, Input 섹션
  • .agents/skills/_shared/design-personality.md — 성격 축, VISUAL DIRECTIVE 형식, 섹션 9 다크 모드 표면 레시피
  • .agents/skills/_shared/dark-surfaces.md — 다크 모드 CSS 레시피 (모드: dark일 때 읽기)
  • .agents/skills/_shared/light-surfaces.md — 라이트 모드 CSS 레시피 (모드: light일 때 읽기)
  • .agents/skills/_shared/checklist.md — P0/P1/P2 게이트
  • .agents/skills/_shared/layout-patterns.md — 랜딩 패턴 (통계 행, 섹션-헤드 분할, 히어로 아이브로우 필, 모드 적응형 네비게이션)
  • .agents/skills/neus-landing-generic/references/dark-landing-patterns.md — 다크 랜딩을 위한 섹션 레이아웃 구조 및 JSX 패턴

Phase 0 — 데이터 수집

계속 진행하기 전에 사용자에게 다음 질문을 하고 완전한 답변을 받을 때까지 기다리세요:

  1. 페이지 유형은 무엇인가요? (포트폴리오, 회사, 이벤트, 에이전시, 블로그, 개인, 기타)
  2. 페이지 이름 / 브랜드
  3. 주요 헤드라인 (H1) — 그라데이션 처리를 위한 강조 단어 포함 가능
  4. 태그라인 또는 부제목
  5. 포함할 섹션 (정확히 나열 — 추가하지 마세요)
  6. 기본 CTA: 레이블 + 동작
  7. 보조 CTA (선택 사항): 레이블 + 동작
  8. 주요 테마 색상 (16진수 또는 설명)
  9. 모드: light 또는 dark?
  10. 성격: clean/airy, editorial/layered, bold/kinetic, structured? (잘 모르겠다면 분위기를 설명해주세요)
  11. 문의 양식 또는 뉴스레터가 포함되나요? (예/아니오 — 구체적으로 명시)

Phase 1 — 시각적 해결

코드를 작성하기 전에 수집한 답변에서 VISUAL DIRECTIVE를 결정하세요.

팔레트 매핑:

  • 생생함 / 에너제틱한 색상 → 생생함
  • 중립 / 차분한 / 회색 톤 → 중립
  • 기업용 파랑 / 초록 → 기업용
  • 보라 / 분홍 / 창의적인 색상 → 창의적

Q10의 성격 매핑:

  • 깔끔함 / 미니멀 / 통풍 → 통풍
  • 에디토리얼 / 레이어드 / 비대칭 → 레이어드
  • 대담함 / 강력함 / 키네틱 → 키네틱
  • 구조적 / 형식적 / 데이터 중심 → 구조적

다음 블록을 구성하여 Phase 2로 전달하세요:

VISUAL DIRECTIVE:
- Palette: [생생함 / 중립 / 기업용 / 창의적]
- Personality: [키네틱 / 통풍 / 구조적 / 레이어드]
- Mode: [light / dark]
- Animation: [.hero-copy에 neus-fade-up / 없음]
- Layout: [비대칭 2열 히어로 1.4fr/0.6fr / 중앙 정렬 히어로]
- H1: [clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- Gradient text: [예 — 강조 단어: "[단어]" / 아니오]
- Surfaces: [유리 (dark-surfaces.md) / 표준 var(--color-white)]
- Nav: [유리 고정 / 표준 고정 / 없음]

다크 모드 규칙: Mode: dark인 경우, 모든 표면은 dark-surfaces.md의 레시피를 사용합니다. 페이지나 섹션 배경에 var(--color-white)를 절대 사용하지 마세요. 콘텐츠 카드에는 <Card variant="glass">를 사용하세요. 이것이 Neus UI 유리 표면입니다. 절대 원시 <div> + 사용자 정의 CSS로 대체하지 마세요.

라이트 모드 규칙: Mode: light인 경우, 콘텐츠 카드에는 Neus UI <Card>를, 교차 섹션 배경에는 var(--color-primary-light)를, 페이지 루트에는 var(--color-white)를 사용하세요.


Phase 2 — P0 검증

  • 출력 섹션 == 입력 섹션 (Q5). 추가 없음.
  • 복사된 텍스트 없음 — 모든 텍스트는 입력에서 가져오거나 명시적으로 prop으로 전달됨
  • AppTemplate 또는 사이드바 없음
  • VISUAL DIRECTIVE가 구성되어 전달됨
  • 다크 모드: 모든 표면이 유리 레시피를 사용하며, var(--color-white) 배경 없음
  • 라이트 모드: 콘텐츠에는 Neus UI <Card>를, 교차 섹션에는 primary-light를 사용

Phase 3 — 아티팩트 생성

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


PageName.types.ts

import type { BadgeColor } from 'neus-ui';

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

// 입력에서 파생된 섹션별 타입만 추가
export type Article = {
  id: string;
  title: string;
  href?: string;
  excerpt?: string;
  author?: string;
  meta?: string;
  categories?: string[];
};

// 카테고리 → 배지 색상 매핑 (다크 모드: 시각적으로 구분되는 4가지 색상)
export const BADGE_COLOR: Record<string, BadgeColor> = {
  systems:  "primary",
  design:   "error",
  craft:    "neutral",
  tools:    "success",
  featured: "primary",
};

export type PageNameProps = {
  // 외부에서 오는 데이터에 대한 props만 (기사 목록, 양식 핸들러 등)
  // 정적 마케팅 텍스트는 컴포넌트에 하드코딩 — 절대 prop으로 사용하지 않음
};

PageName.tsx

다크 모드 구조 — 올바른 컴포넌트 사용:

import { useState } from 'react';
import { Button, Card, Link, Input, Badge } from 'neus-ui';
import './PageName.styles.css';
import type { PageNameProps, Article } from './PageName.types';
import { BADGE_COLOR } from './PageName.types';

export const PageName = ({ articles, onSubscribe }: PageNameProps) => {
  const [email, setEmail] = useState('');
  const [subscribed, setSubscribed] = useState(false);
  const [loading, setLoading] = useState(false);

  const handleSubscribe = () => {
    setLoading(true);
    onSubscribe?.(email);
    setSubscribed(true);
    setLoading(false);
  };

  return (
    <div className="page-name">
      {/* 장식용 배경 레이어 — aria-hidden, 상호작용 불가 */}
      <div className="page-name__mesh" aria-hidden="true" />
      <div className="page-name__grid" aria-hidden="true" />

      <div className="page-name__content">
        {/* 고정 유리 네비게이션 — 링크는 <Link type="secondary"> 사용 */}
        <nav className="page-name__nav">
          <div className="page-name__nav-brand">
            <div className="page-name__brand-mark" aria-hidden="true">P</div>
            <span className="page-name__brand-name">PageName</span>
          </div>
          <div className="page-name__nav-links">
            {navItems.map(item => (
              <Link key={item.href} type="secondary" href={item.href} label={item.label} />
            ))}
          </div>
          <Button label="Subscribe" variant="solid" color="primary" size="small" onClick={() => {}} />
        </nav>

        <main>
          {/* 히어로 — 비대칭 2열 */}
          <section className="page-name__hero" aria-labelledby="page-name-title">
            <div className="page-name__hero-copy">
              {/* 아이브로우 필 — 원시 div (Neus UI에 해당하는 컴포넌트 없음) */}
              <div className="page-name__eyebrow-pill">
                <span className="page-name__eyebrow-dot" aria-hidden="true" />
                PAGENAME
                <span aria-hidden="true">/</span>
                KEYWORD
              </div>
              <h1 id="page-name-title">
                Headline{" "}
                <span className="gradient-text">accent</span>
              </h1>
              <p className="page-name__hero-sub">입력에서 가져온 태그라인.</p>
              <div className="page-name__hero-cta">
                <Button label="Primary CTA" variant="solid" color="primary" onClick={() => {}} />
                <Button label="Secondary CTA" variant="outlined" color="primary" onClick={() => {}} />
              </div>
            </div>
            <div className="page-name__hero-visual">
              {/* 추천 Card 또는 아트 패널 — dark-landing-patterns.md §4 참조 */}
            </div>
          </section>

          {/* 입력에서 가져온 콘텐츠 섹션 — 카드에는 <Card variant="glass"> 사용 */}
          {/* 예시 기사 그리드 섹션: */}
          <section className="page-name__articles">
            <div className="page-name__article-grid">
              {articles?.map(article => (
                <Card variant="glass" key={article.id} onClick={() => {}}>
                  <div className="page-name__article-inner">
                    <div className="page-name__pill-row">
                      {article.categories?.map(cat => (
                        <Badge
                          key={cat}
                          variant="solid"
                          color={BADGE_COLOR[cat] ?? "neutral"}
                          label={cat}
                        />
                      ))}
                    </div>
                    <h3>{article.title}</h3>
                    {article.excerpt && <p className="page-name__article-dek">{article.excerpt}</p>}
                  </div>
                </Card>
              ))}
            </div>
          </section>

          {/* 뉴스레터 섹션 (요청된 경우) */}
          <section className="page-name__newsletter" aria-labelledby="page-name-nl-title">
            <div className="page-name__nl-card">
              <p className="page-name__sec-eyebrow">Newsletter</p>
              <h2 id="page-name-nl-title">
                Stay in the loop.{" "}
                <span className="gradient-text">No noise.</span>
              </h2>
              {subscribed ? (
                <p className="page-name__nl-success">✓ 구독해 주셔서 감사합니다!</p>
              ) : (
                <div className="page-name__nl-form">
                  <Input
                    name="newsletter-email"
                    type="email"
                    label="Email"
                    placeholder="[email protected]"
                    value={email}
                    onChange={setEmail}
                    required
                  />
                  <Button
                    label="Subscribe"
                    type="submit"
                    variant="solid"
                    color="primary"
                    loading={loading}
                    onClick={handleSubscribe}
                  />
                </div>
              )}
            </div>
          </section>
        </main>

        {/* 푸터 — 링크는 <Link type="secondary"> 사용 */}
        <footer className="page-name__footer">
          <span>© {new Date().getFullYear()} PageName.</span>
          <div className="page-name__footer-links">
            <Link type="secondary" href="/privacy" label="Privacy" />
            <Link type="secondary" href="/contact" label="Contact" />
          </div>
        </footer>
      </div>
    </div>
  );
};

라이트 모드 구조: mesh/grid divs와 콘텐츠 래퍼를 생략합니다. 콘텐츠 카드에는 <Card> (variant 없음)를 사용합니다. background: var(--color-primary-light)로 교차 섹션 배경을 설정합니다. 기본 링크에는 <Link type="primary">를, 네비게이션/푸터에는 <Link type="secondary">를 사용합니다. 카테고리 필에는 여전히 <Badge>를 사용합니다.

기능 타일 (두 모드 모두):

  • <Card variant="glass" icon={...} title="..." description="..." /> (다크)
  • <Card icon={...} title="..." description="..." /> (라이트)

문의 양식 (요청된 경우): Neus UI <Input> 필드 + <Button type="submit">을 사용합니다. 뉴스레터와 동일한 패턴이지만 글로우 카드 래퍼는 없습니다.


PageName.styles.css

다크 모드: dark-surfaces.md §1의 캔버스 + mesh + grid + 콘텐츠 레시피로 시작합니다. 그런 다음 유리 네비게이션 (§3), nl-card (§4), 아이브로우 필 (§5), 그라데이션 텍스트 (§6), 아트 패널 (§8 기능 타일인 경우), 메타 행 (§9 기사인 경우), 푸터 (§10)를 추가합니다. 사용자 정의 카드 CSS는 없습니다 — <Card variant="glass">가 처리합니다. dark-landing-patterns.md의 레이아웃을 적용합니다.

라이트 모드: background: var(--color-white); color: var(--color-gray-900)으로 시작합니다. 교차 섹션 배경에는 var(--color-primary-light)를 사용합니다. 타이포그래피와 간격은 design-personality.md 섹션 4–5를 따릅니다.

두 모드 모두:

@keyframes neus-fade-up {
  from { opacity: 0; transform: translateY(16px); }
  to   { opacity: 1; transform: translateY(0); }
}

.page-name__hero-copy {
  animation: neus-fade-up 0.5s ease both;
}

/* 그라데이션 텍스트 유틸리티 */
.gradient-text {
  background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

/* 최대 너비 컨테이너 */
.page-name__hero,
.page-name__articles,
.page-name__newsletter,
.page-name__footer {
  max-width: min(72rem, 100%);
  margin: 0 auto;
}

/* 섹션 패딩 */
.page-name__hero       { padding: 6rem 2rem; }
.page-name__articles   { padding: 6rem 2rem; }
.page-name__newsletter { padding: 5rem 2rem; }

/* 히어로 그리드 */
.page-name__hero {
  display: grid;
  grid-template-columns: 1.4fr 0.6fr;
  gap: 3rem;
  align-items: center;
}

/* H1 */
.page-name__hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2.5rem, 6vw, 4rem);
  font-weight: 800;
  letter-spacing: -0.04em;
  line-height: 0.98;
  margin: 0.5rem 0 1rem;
}

/* 뉴스레터 양식 — flex 행 */
.page-name__nl-form {
  display: flex;
  gap: 1rem;
  align-items: flex-end;
  max-width: 520px;
  margin: 0 auto;
}

/* 기사 그리드 */
.page-name__article-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 1.5rem;
}

/* 필 행 */
.page-name__pill-row {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin-bottom: 0.75rem;
}

/* 반응형 */
@media (max-width: 960px) {
  .page-name__hero { grid-template-columns: 1fr; }
  .page-name__article-grid { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
  .page-name__hero,
  .page-name__articles,
  .page-name__newsletter { padding: 5rem 1.25rem; }
}

공유 규칙 (내장)

이 규칙은 항상 활성화되어 있습니다. _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';

절대 사용하지 마세요...

Individual skills in this repo

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

관련 스킬