Communitygithub.com

랜딩 페이지 팩토리 오케스트레이터

랜딩 페이지 파이프라인을 제어하는 최상위 스킬입니다. 요청을 분류하고, 단계 순서를 결정하며, 필수 조건과 중단 조건을 적용하고, 변형 페이지를 관리하며, 변경된 단계를 재실행하고, 페이지 패키지 관리를 수행합니다.

랜딩 페이지 팩토리 오케스트레이터란 무엇인가요?

이 스킬은 '랜딩 페이지 팩토리' 시스템의 제어 계층으로, 사용자가 랜딩 페이지 구축 파이프라인(전체 파이프라인, 변형 파이프라인, 단계 재실행, 관리/검사)을 요청할 때 이를 적절히 분류하고, 하위 스킬(site-extract, page-strategy, brand-profile, page-copy, page-visuals, page-build, page-qa)을 올바른 순서로 호출 및 감독합니다. 아티팩트 사전 점검(preflight checks)을 통해 브랜드 및 페이지 수준에서 필요한 파일이 누락되었는지 확인하고, 누락된 경우 가장 빠른 단계로 라우팅합니다. 또한 하드 스탑(예: strategy.json 없음, 고유 메커니즘 미식별, CTA 대상 없음) 시 진행을 중단하고 명확한 안내를 제공하며, 다운그레이드가 허용되는 경우에만 제한적인 방식으로 계속 진행합니다. 변형 페이지 작업 시에는 브랜드 정보를 공유하고 각 변형마다 별도의 페이지 패키지를 생성하며 의도적으로 오디언스, 앵글, 오퍼 프레이밍 등을 변경하여 비교 QA를 수행합니다. 클로드 코드, 커서, Codex 등 다양한 AI 에이전트 환경에서 사용할 수 있으며, Firecrawl이나 Bloom 같은 외부 서비스가 차단된 경우 운영자에게 알리고 다운그레이드 승인을 받은 후에만 대체 방식을 사용합니다. 실행 후에는 memory/YYYY-MM-DD.md에 간결한 실행 로그를 기록합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheMattBerman/landing-page-factory/tree/HEAD/skills/landing-page-factory-orchestrator

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

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

문서

랜딩 페이지 팩토리 오케스트레이터은(는) 무엇을 하나요?

이것은 제어 계층입니다.

다음과 같은 요청이 있을 때 이 스킬을 사용하세요:

  • 전체 랜딩 페이지 파이프라인 구축
  • 하나 이상의 페이지 변형 생성
  • 편집 후 선택된 단계 재실행
  • 올바른 작업 순서 파악
  • 페이지 패키지 이름 지정, 아티팩트 확인, 정리, 또는 메모리 로깅과 같은 관리 작업

단계 스킬을 대체하지 마세요. 이 스킬은 단계 스킬을 라우팅하고 감독합니다.

이 스킬이 소유하는 것

  • 요청 분류
  • 단계 순서 지정
  • 아티팩트 사전 점검
  • 하드 스탑 및 다운그레이드 강제 적용
  • 페이지 이름 지정 및 변형 이름 지정
  • 변경 후 재실행해야 할 단계 결정
  • memory/YYYY-MM-DD.md에 메모리 로깅

이 스킬이 소유하지 않는 것

  • 추출 로직
  • 전략 로직
  • 카피라이팅 로직
  • 이미지 생성 로직
  • HTML 빌드 로직
  • QA 점수 자체

이러한 것들은 다음 스킬에 속합니다:

  • site-extract
  • page-strategy
  • brand-profile
  • page-copy
  • page-visuals
  • page-build
  • page-qa

요청 분류

모든 요청을 먼저 다음 모드 중 하나로 라우팅하세요.

1. 전체 파이프라인

예시:

  • "https://example.com의 랜딩 페이지를 만들어 줘"
  • "이 브랜드에 대해 전체 프로세스를 실행해 줘"

순서대로 실행:

  1. site-extract
  2. page-strategy
  3. brand-profile
  4. page-copy
  5. page-visuals
  6. page-build
  7. page-qa

2. 변형 파이프라인

예시:

  • "기업 구매자를 위한 버전을 만들어 줘"
  • "세 가지 앵글 변형을 구축해 줘"

가능하면 기존 브랜드 아티팩트를 사용하세요. 각 변형에 대해 새 페이지 패키지를 생성하고 다음을 재실행:

  1. page-strategy
  2. page-copy
  3. page-visuals
  4. page-build
  5. page-qa

site-extract 또는 brand-profile은 소스 사실이 변경되었거나 현재 브랜드 아티팩트가 없거나 부족한 경우에만 재실행하세요.

3. 단계 재실행

예시:

  • "비주얼만 다시 빌드해 줘"
  • "QA를 다시 실행해 줘"
  • "전략 변경 후 카피를 업데이트해 줘"

최소한의 필수 다운스트림 단계만 재실행하세요.

의존성 규칙:

  • 전략 변경됨 → 카피, 비주얼, 빌드, QA 재실행
  • 브랜드 프로필 변경됨 → 카피, 비주얼, 빌드, QA 재실행
  • 카피 변경됨 → 빌드, QA 재실행
  • 비주얼 변경됨 → 빌드, QA 재실행
  • 빌드 변경됨 → QA 재실행

4. 관리 / 검사

예시:

  • "어떤 아티팩트가 누락되었나요?"
  • "이 작업을 어떤 순서로 실행해야 하나요?"
  • "새 페이지 패키지를 만들어 주세요"

검사, 보고, 준비하세요. 누락된 아티팩트를 임의로 만들지 마세요.

사전 점검

다운스트림 작업을 호출하기 전에 필수 아티팩트를 확인하세요.

브랜드 수준:

  • workspace/brand/extract.md
  • workspace/brand/extract.json
  • workspace/brand/profile.md (카피, 비주얼, 또는 빌드에서 필요할 때)
  • workspace/brand/palette.json (비주얼 또는 빌드에서 필요할 때)

페이지 수준:

  • workspace/pages/[page-name]/strategy.json
  • workspace/pages/[page-name]/copy.md
  • workspace/pages/[page-name]/visuals/
  • workspace/pages/[page-name]/index.html
  • workspace/pages/[page-name]/meta.json
  • workspace/pages/[page-name]/qa.md

요청된 단계에 필요한 아티팩트가 누락된 경우 중단하고 가장 빠른 누락 단계로 라우팅하세요.

하드 스탑

절대 다음 상황을 넘어 계속 진행하지 마세요:

  • 카피, 비주얼, 또는 빌드를 위한 strategy.json 없음
  • 고유 메커니즘 미식별
  • 리드 생성 또는 액션 중심 페이지를 위한 CTA 대상 없음
  • 제안된 확실성 수준에 비해 증거가 너무 부족함
  • 추출에 Firecrawl이 필요하지만 설정되지 않았거나 런타임에 차단됨
  • 비주얼에 Bloom이 필요하지만 설정되지 않았거나 런타임에 차단됨 (사용자가 Nano Banana 또는 수동 자산을 명시적으로 승인하지 않은 경우)

차단된 경우 다음을 명시하세요:

  1. 무엇이 누락되었는지
  2. 다음에 실행해야 할 단계
  3. 다운그레이드할 수 있는 것과 할 수 없는 것

다운그레이드

단계 스킬이 허용하는 경우에만 다운그레이드와 함께 계속 진행하세요.

일반적인 다운그레이드:

  • 약한 증거 → 부드러운 주장, 드래프트 전용 QA 목표
  • 부분적 비주얼 → 중립적 지원 레이아웃
  • 정확한 제품 이미지 실패 → 브랜드 환경 또는 운영자 자산
  • 누락된 Bloom 브랜드 → 제공자 컨텍스트를 위해 온보딩하되, 리포지토리 브랜드 아티팩트를 진실의 원천으로 유지

이름 지정 규칙

workspace/pages/ 아래에 설명적인 페이지 패키지 이름을 사용하세요.

패턴:

  • 기본 실행: [brand]-[core-angle]
  • 변형 실행: [brand]-[audience]-[angle]

좋은 예:

  • ridge-wallet-proof
  • stealads-enterprise-time
  • notion-agency-velocity

피해야 할 것:

  • test-page
  • v2
  • new-one

변형 워크플로우

여러 변형을 구축할 때:

  1. workspace/brand/에 하나의 공유 브랜드 진실의 원천 유지
  2. 각 변형에 대해 별도의 페이지 패키지 생성
  3. 의도적으로 오디언스, 앵글, 오퍼 프레이밍, 증거 강조, 또는 비주얼 처리 변경
  4. 각 변형에 대해 전체 페이지 수준 다운스트림 단계 실행
  5. 변형 간 QA 평결 및 검토 플래그 비교

변형이 서로를 조용히 덮어쓰지 않도록 하세요.

단계 순서 규칙

이 정확한 로직을 사용하세요:

  • 사용자가 URL만 제공한 경우: site-extract부터 시작

  • 브랜드 아티팩트는 존재하지만 페이지 패키지가 없는 경우: page-strategy부터 시작

  • strategy.json이 존재하고 사용자가 카피를 요청한 경우: page-copy 실행

  • copy.md와 브랜드 아티팩트가 존재하고 사용자가 비주얼을 요청한 경우: page-visuals 실행

  • 전략, 카피, 비주얼이 존재하는 경우: page-build 실행

  • 빌드 아티팩트가 존재하는 경우: page-qa 실행

빌드 및 비주얼 스크립트 진입점

Cowork 및 기타 스킬 폴더 런타임의 경우, 스킬-로컬 스크립트를 선호하세요:

  • skills/landing-page-factory-orchestrator/scripts/page-admin.py
  • skills/page-visuals/scripts/image-provider.sh
  • skills/page-build/scripts/resolve-visual-assets.py
  • skills/page-build/scripts/prepare-build-meta.py
  • skills/page-build/scripts/select-build-images.py
  • skills/page-build/scripts/html-image-context.py
  • skills/page-build/scripts/build-page.py

리포지토리 루트의 scripts/ 진입점은 로컬 래퍼일 뿐입니다.

오케스트레이션 지원을 위해 관리 도우미를 사용하세요:

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py status --page-name [page-name] 현재 아티팩트 상태와 가장 빠른 누락 단계를 반환합니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py suggest-name --brand [brand] --audience [audience] --angle [angle] 충돌하지 않는 깔끔한 페이지 패키지 이름을 반환합니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --page-name [page-a] --page-name [page-b] 아티팩트 상태, 준비 점수, 준비 노트, 헤드라인, 페이지 유형, CTA 대상, 이미지 수, 검토 플래그 및 QA 평결(있는 경우)을 포함한 나란히 JSON 요약을 반환합니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown Cowork 검토를 위해 준비도 순으로 정렬된 사람이 읽을 수 있는 마크다운 비교 테이블을 반환합니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] --format markdown --output workspace/pages/[report-name].md 비교 보고서를 디스크에 씁니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py compare-variants --prefix [brand-prefix] 접두사와 일치하는 모든 페이지 패키지를 비교합니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/page-admin.py log-memory --title "[title]" --page-name [page-name] --stages "[stages]" --verdict "[verdict]" 간단한 실행 로그를 memory/YYYY-MM-DD.md에 추가합니다.

오케스트레이터가 실제로 파이프라인의 스크립트 부분을 실행하게 하려면 러너를 사용하세요:

  • python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --page-name example-proof --format markdown 필요한 경우 추출을 실행한 다음, 정확한 핸드오프 지침과 함께 다음 스킬 작성 단계에서 중지합니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --page-name example-proof --format markdown 기존 페이지 패키지를 재개하고 필요한 아티팩트가 이미 존재할 때 빌드 체인을 통해 계속 진행합니다.

  • python3 skills/landing-page-factory-orchestrator/scripts/run-pipeline.py --url https://example.com --brand Example --audience enterprise --angle time-saving --format markdown 충돌하지 않는 변형 페이지 이름을 만들고 다음 수동 단계까지 실행합니다.

러너는 의도적으로 하이브리드입니다:

  • 스크립트된 단계를 직접 실행합니다.
  • page-strategy, brand-profile, page-copy 및 대부분의 page-visuals 작업에서 작성된 아티팩트가 여전히 누락된 경우 깔끔하게 중지합니다.
  • 이러한 아티팩트가 존재하면 자동으로 재개합니다.

추출 정책:

  • FIRECRAWL_API_KEY를 사용할 수 있으면 자동으로 Firecrawl을 선호합니다.
  • Firecrawl이 설정되지 않은 경우 기본 추출이 허용되지만 다운그레이드로 처리되어야 합니다.
  • 공개 릴리스 품질 실행의 경우, 추출 품질이 동등한 것처럼 조용히 행동하지 말고 Firecrawl을 추가할 것을 권장합니다.

제공자 강제 적용:

  • 의도된 경로가 Firecrawl일 때 site-extract가 조용히 WebFetch/수동 스크래핑으로 축소되도록 허용하지 마세요.
  • 의도된 경로가 Bloom일 때 page-visuals가 조용히 기본 내장 이미지 생성으로 축소되도록 허용하지 마세요.
  • 선호하는 제공자가 차단되었거나, 누락되었거나, 설정되지 않은 경우 일시 중지하고 운영자에게 어떤 다운그레이드가 허용 가능한지 물으세요.
  • 사용자가 명시적으로 승인한 경우에만 다운그레이드와 함께 계속 진행하세요.

Cowork 관련 동작:

  • Cowork가 api.firecrawl.dev를 차단하면 직접적으로 말하고 도메인을 허용 목록에 추가하거나 로컬 추출 사전 점검을 실행할 것을 권장하세요.
  • Cowork가 Bloom에 도달할 수 없으면 직접적으로 말하고 Bloom을 구성하거나, Nano Banana를 사용하거나, 수동 자산으로 진행할 것인지 물으세요.
  • "WebFetch/기본 이미지로 어느 정도 작동했다"는 것을 성공적인 제공자 실행으로 간주하지 마세요.

여전히 스킬 작성자의 판단에 의존하는 단계에 대해 완전 자동화를 주장하지 마세요.

메모리 로깅

의미 있는 실행 후에 memory/YYYY-MM-DD.md에 다음을 포함한 짧은 메모를 추가하세요:

  • 브랜드 또는 페이지 이름
  • 완료된 단계
  • 가능한 경우 QA 평결
  • 차단 또는 다운그레이드
  • 주목할 만한 교훈

간결하게 유지하세요. 실행당 한 개의 짧은 섹션이면 충분합니다.

출력 기대치

오케스트레이션할 때 항상 다음을 보고하세요:

  • 선택한 모드: 전체 파이프라인, 변형, 단계 재실행, 또는 관리
  • 페이지 패키지 이름
  • 실행된 단계 또는 필요한 다음 단계
  • 차단, 다운그레이드, 또는 검토 플래그

변형 실행의 경우 평평한 비교를 포함하세요:

  • 변형 이름
  • 오디언스 / 앵글
  • 현재 아티팩트 상태
  • 있는 경우 QA 평결

Individual skills in this repo

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

TheMattBerman/landing-page-factory

Build an evidence-backed brand profile from site extract and page strategy. Separates observed facts from synthesis so downstream skills preserve the brand instead of rewriting it.

TheMattBerman/landing-page-factory

Build a deployable landing page from strategy, copy, visuals, and brand profile using category-aware routing, preservation hierarchy, and explicit QA. Single-file HTML output.

TheMattBerman/landing-page-factory

Write mechanism-preserving, proof-disciplined landing page copy from strategy, brand profile, and extract language bank. Includes mandatory sharpness audit and claim control.

TheMattBerman/landing-page-factory

Final landing-page QA pass against strategy, proof provenance, mechanism clarity, trust preservation, accessibility, and anti-slop. Gates whether a page is shippable or draft-only.

TheMattBerman/landing-page-factory

Normalize raw extract or manual brief into a page strategy artifact: mechanism, offer, audience, proof provenance, CTA, preservation plan, and review flags. Mandatory before copy or build.

TheMattBerman/landing-page-factory

Plan and generate visuals by preservation class: exact product, branded environment, or concept support. Uses strategy-driven shot selection and visual QA instead of generic vibe prompting.

TheMattBerman/landing-page-factory

Extract operator-grade source facts from a website or manual brief: claims, proof, CTAs, mechanism language, trust cues, visual patterns, and page structure with provenance. First stage of Page Factory.

관련 스킬