Communitygithub.com

Portfolio Forge

개인 정보를 미적 감각이 뛰어난 개인 웹사이트/포트폴리오로 제작합니다. 콘텐츠 문서를 유일한 진실 공급원으로 → taste-skill이 참고 이미지 생성 → 대립적 이미지별 심사 → Codex Frontend App Builder로 고충실도 복제 → headless 단계별 QA → Cloudflare Pages에 가역 배포합니다. 사용자가 '개인 웹사이트 만들어 줘', '포트폴리오', 'personal website', 'portfolio site', '내 정보로 사이트 만들어 줘', '랜딩 페이지 만들어 줘'라고 말할 때 트리거됩니다.

Portfolio Forge란 무엇인가요?

Portfolio Forge는 사용자의 개인 정보를 미적 감각이 뛰어나고 즉시 배포 가능한 개인 웹사이트/포트폴리오로 변환하는 AI 에이전트 스킬입니다. 핵심은 검증된 파이프라인인 '콘텐츠 문서(유일 진실 공급원) → 참고 이미지 → 대립적 심사 → 고충실도 복제 → 단계별 QA → 가역 배포'를 따릅니다. 이 스킬은 Claude Code, Codex, Cursor 같은 플랫폼에서 사용하도록 설계되었으며, Codex의 Frontend App Builder 플러그인과 taste-skill을 활용하여 고품질 섹션별 참고 이미지를 생성하고 이를 1:1로 복제합니다. 특히 '콘텐츠 문서 기반 환각 방지', '대립적 이미지별 심사', '헤드리스 QA'라는 세 가지 핵심 단계를 강화하여 다른 도구와 차별화됩니다. 사용자의 실제 사진과 프로젝트 스크린샷을 우선시하며, 배포는 Cloudflare Pages의 독립적인 `*.pages.dev` 서브도메인에 가역적으로 수행되어 기존 자산을 건드리지 않습니다. 또한 QA 체크리스트와 모션 효과 라이브러리를 제공하여 접근성과 사용자 경험을 보장합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Heng-xiu/xiuxiu-agent-skills/tree/HEAD/skills/portfolio-forge

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

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

문서

Portfolio Forge은(는) 무엇을 하나요?

'한 사람의 정보'를 미적 감각이 뛰어나고 즉시 운영 가능한 개인 웹사이트로 제작합니다. 핵심은 검증된 파이프라인입니다: 콘텐츠 문서(유일 진실 공급원) → 참고 이미지 → 대립적 심사 → 고충실도 복제 → 단계별 QA → 가역 배포.

영감은 'Codex로 2시간 만에 개인 웹사이트 만들기' 4단계(내용 정리 → taste로 참고 이미지 생성 → 소재 생성 → 복제)에서 얻었지만, 이 스킬은 실제로 품질을 결정짓는, 원문에는 없는 세 가지 고리를 추가로 고정했습니다: 콘텐츠 문서 환각 방지, 대립적 이미지별 심사, 배포 전 헤드리스 검수.

트리거 시점

  • '개인 웹사이트 만들어 줘', '포트폴리오', '내 정보로 사이트 만들어 줘'
  • 'personal website', 'portfolio', '랜딩 페이지 만들어 줘'
  • '외부에 보여줄 개인 페이지가 필요해', 'AI 시대에 개인 웹사이트는 이력서야'
  • 심지어 '사이트 하나 만들어 줘', '내 걸 담을 웹페이지 만들어 줘'라고만 말해도 됩니다.

사전 의존성(처음 사용 시 확인)

이 파이프라인에는 세 가지 외부 도구가 필요합니다. 없으면 먼저 설치하세요(설치 방법은 workflows/reference-image-gen.md 및 workflows/frontend-replication.md 서두 참조):

  1. taste-skill의 imagegen-frontend-web — 고감도 섹션 참고 이미지를 생성합니다. ~/.claude/skills/와 ~/.codex/skills/에 설치합니다.
  2. Codex의 build-web-apps 플러그인(Frontend App Builder 스킬 포함) — 고충실도 복제를 수행합니다. codex plugin add build-web-apps@openai-curated 명령어로 추가합니다.
  3. Chrome + puppeteer-core — 헤드리스 QA를 위한 단계별 스크린샷 캡처에 사용합니다.

핵심 원칙

  1. 콘텐츠 문서가 유일한 진실 공급원입니다: 작업을 시작하기 전에 인물 프로필/포지셔닝/스타일/색상 팔레트/섹션 구조를 CONTENT.md 파일에 정리합니다. 이후 참고 이미지에서 AI가 생성한 잘못된 텍스트나 문서와 불일치하는 내용이 발견되면, 무조건 문서를 기준으로 합니다. 이것이 환각 방지의 기초입니다.
  2. 대립적 이미지별 심사: 참고 이미지는 단순히 복제하기 위해 생성되는 것이 아니라, 도전하기 위해 생성됩니다. 각 이미지에 대해 '글자 크기가 과장되었는가? 숨 쉴 공간이 있는가? 구성이 AI 패턴에 빠졌는가? 환각 텍스트가 있는가? 이미지 간 일관성이 있는가?'를 질문합니다. 통과하지 못하면 해당 이미지만 다시 생성합니다. 이 단계가 결과물을 '그럴듯함'과 '진짜 예쁨'으로 가르는 기준입니다.
  3. 실제素材 우선: 본인 사진, 프로젝트 스크린샷은 모두 실제 것을 사용합니다. AI는 '스타일 참고 이미지'와 '스타일화된 소재' 생성에만 사용되며, 얼굴이나 스크린샷을 위조하는 데는 사용하지 않습니다. 사용자가 사진을 제공했다면 바로 사용하고, 따로 생성하지 않습니다.
  4. 단계별 QA를 해야 완료입니다: 복제가 끝났다고 해서 전달하는 것이 아니라, 검수하는 것입니다. puppeteer로 실제 스크롤을 시뮬레이션하고, 섹션별로 스크린샷을 캡처하여 참고 이미지와 나란히 비교합니다. 부족한 점이 있으면 복제 단계로 돌아가 반복합니다.
  5. 가역 배포, 기존 자산 건드리지 않음: 배포는 항상 독립된 *.pages.dev에 먼저 합니다. 사용자의 기존 도메인을 건드리기 전에 바인딩 관계를 확인하고, '도메인을 전환할지 여부'를 사용자의 결정으로 남겨두고 함부로 결정하지 않습니다.
  6. 일반인을 위한 카피 우선(2026-07 사용자 피드백 반영): 웹사이트 본문과 홍보 카피는 기본적으로 기술에 익숙하지 않은 독자를 위해 작성합니다. 기술 스택 명칭(프레임워크, 데이터베이스, 서비스 제공업체)은 본문에 등장하지 않도록 하고, 대신 '이 기능이 무엇을 하고, 누구에게 어떤 도움이 되는지'를 설명합니다. 전문 용어는 인터뷰를 통해 대상 독자가 기술 전문가임을 확인한 경우에만 유지합니다. 설치/사용 설명은 터미널 명령어보다는 'AI에게 전달할 한 문단' 형태의 지침을 우선 제공합니다.

작업 흐름(6단계)

단계 0: 포지셔닝 명확히 하기(인터뷰를 통한 수렴)

workflows/content-intake.md를 따릅니다. AskUserQuestion을 사용하여 핵심 결정 사항을 수렴합니다: 웹사이트 대상 독자, 포지셔닝, 시각적 스타일, 언어/규모, 소재 출처, 엄선된 프로젝트, 주요 CTA, 배포 목표. 스타일 옵션은 references/design-style-library.md를 참조합니다(taste로 이미지 생성 시 스타일이 가장 중요한 입력입니다).

단계 1: 콘텐츠 문서(유일 진실 공급원)

인터뷰 결과와 외부 데이터(기존 웹사이트, Substack, 소셜 미디어)를 수집하여 CONTENT.md로 정리합니다. 형식은 references/content-doc-template.md를 따릅니다. 이 문서는 이후 모든 단계의 근거가 됩니다.

단계 2: 섹션별 참고 이미지 생성

workflows/reference-image-gen.md를 따릅니다. 단일 페이지를 6-8개 섹션으로 나누고, imagegen-frontend-web을 사용하여 섹션당 하나의 이미지를 생성합니다(codex exec를 통해 백그라운드에서 실행). 생성된 이미지는 refs/ 디렉토리에 저장합니다.

단계 3: 대립적 심사 + 반복(핵심)

workflows/adversarial-design-review.md를 따릅니다. 먼저 각 이미지를 살펴보며 스스로 도전하고, 그 다음 사용자에게 심사를 요청합니다. 통과하지 못한 이미지는 해당 이미지만 다시 생성합니다. 이 단계는 몇 번이고 반복될 수 있으며, 정상적인 과정이니 절대 건너뛰지 마십시오.

단계 4: 고충실도 복제

workflows/frontend-replication.md를 따릅니다. '최종 참고 이미지 + CONTENT.md + 실제 소재' 전체를 Codex Frontend App Builder에 전달하여 1:1 복제를 목표로, 데이터 기반 + 애니메이션 + RWD를 구현합니다. 동적 효과는 references/motion-effects-library.md(실전에서 검증된 11가지 효과 레시피)에서 선택하여 복제 프롬프트에 하나씩 명시합니다. 철칙: 동적 효과는 주제를 보조해야 하며, prefers-reduced-motion을 존중하고, 한 페이지에 최대 1개의 큰 효과만 사용합니다.

단계 5: 단계별 QA

workflows/headless-qa-and-deploy.md의 전반부를 따릅니다. puppeteer로 실제 스크롤을 시뮬레이션하고 섹션별로 스크린샷을 캡처하여, references/qa-checklist.md를 사용해 참고 이미지와 비교 검수합니다. 부족한 점이 있으면 단계 4로 돌아갑니다.

단계 6: 배포 + Smoke Test

workflows/headless-qa-and-deploy.md의 후반부를 따릅니다. Cloudflare Pages에 독립된 *.pages.dev로 배포합니다 → 온라인 헤드리스 smoke test(HTTP 상태 + 자산 로딩 + 실제 첫 화면 캡처)를 수행합니다 → 도메인 결정권을 사용자에게 돌려줍니다.

하위 에이전트 / 도구 설계

이 파이프라인의 주요 작업은 Codex(이미지 생성, 복제)에 위임하고, Claude 측에서는 인터뷰, 문서 작성, 대립적 심사, QA 검수, 배포 오케스트레이션을 담당합니다.

  • 이미지 생성 / 복제: codex exec --skip-git-repo-check --full-auto "<프롬프트>", run_in_background: true로 백그라운드에서 실행하고 완료 후 검수합니다.
  • 외부 데이터 수집: WebFetch(기존 웹사이트, Substack 프로필 및 글).
  • 스크린샷 QA: 헤드리스 Chrome 또는 puppeteer-core(단계별 스크린샷은 workflow의 주의사항 참조).
  • 배포: wrangler pages.

병렬 전략: 7-8장의 참고 이미지는 한 번의 codex exec 내에서 직렬로 생성하면 충분합니다(imagegen 스킬 자체가 이미지를 하나씩 출력함). 재생성 시에는 수정이 필요한 이미지만 다시 실행합니다.

대화 스타일

  • 전체적으로 한국어를 사용하되, 기술 용어와 식별자는 원문을 유지합니다.
  • 각 단계에서 먼저 '무엇을 할 것인지' 설명하고, 완료 후에는 묻지 않아도 자동으로 보고합니다.
  • 대립적 심사는 직설적으로: 어떤 이미지의 어느 부분이 부족한지 명확히 지적하고 구체적인 수정 방향을 제시합니다.
  • 전달/배포 후에는 네 가지를 자동으로 보고합니다: 브랜치, 커밋 해시, 병합 여부, 워크트리 정리 여부.
  • 사용자의 기존 도메인/외부 자산을 건드리기 전에는 결정권을 사용자에게 돌려줍니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬