Communitygithub.com

포트폴리오 빌드

디자이너의 포트폴리오 웹사이트를 구축하거나 재구축하여 검토자가 30초 안에 이해할 수 있도록 해줍니다. 하나의 콘텐츠 파일과 세 가지 검증된 페이지 그리드 중 하나(고정 프로필과 전체 폭 작업, 균등 2열 그리드, 또는 프로젝트당 하나의 긴 사례 연구)를 사용합니다. 포트폴리오 사이트를 만들고 싶을 때, 디자인 작업을 위한 개인 사이트를 시작할 때, 기존 포트폴리오를 재구성하거나 재구조화할 때, 프로젝트 이미지 폴더나 Behance/Dribbble/Notion 페이지를 자신의 사이트로 전환할 때, 포트폴리오 레이아웃이나 그리드를 선택할 때, 또는 포트폴리오 감사의 수정 사항을 적용할 때 사용합니다. 디자이너, 아트 디렉터, 디자인 리드, 일러스트레이터, 모션 및 3D 아티스트, 사진가 및 영화 제작자를 위한 스킬입니다.

포트폴리오 빌드란 무엇인가요?

포트폴리오 빌드 스킬은 디자이너와 크리에이티브 전문가가 단일 JSON 파일과 Python 빌드 스크립트를 사용하여 정적 포트폴리오 웹사이트를 생성할 수 있도록 돕습니다. 이 스킬은 세 가지 검증된 그리드(인덱스, 컬럼, 케이스) 중 하나를 선택할 수 있게 하며, 빌드는 구조(그리드, 순서)와 룩(타이포그래피, 색상)을 분리하여 디자이너가 자신의 미학을 유지하도록 합니다. 빌드 스크립트는 30초 감사 목록과 누락된 사실을 위한 슬롯 목록을 출력하여 개선해야 할 부분을 명확히 보여줍니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 실행되며, 포트폴리오 사이트를 신속하게 시작하거나, 내용과 구조를 대규모로 업데이트하는 데 사용됩니다. 모든 지침은 SKILL.md에 자세히 설명되어 있으며, 콘텐츠 파일 구조, 이미지 최적화, 핸드오버 체크리스트를 포함합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/adrituyo/30s/tree/main/skills/portfolio-build

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

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

문서

포트폴리오 빌드은(는) 무엇을 하나요?

포트폴리오는 첫 방문 시 약 30초의 시간을 얻습니다. 이 스킬은 그 30초를 잘 사용하는 포트폴리오를 만듭니다: 첫 화면에 당신이 누구인지와 무엇을 하는지, 그 옆에 실제 작업물, 각 프로젝트에서 당신의 역할, 그리고 당신에게 연락할 수 있는 한 가지 명확한 방법을 제시합니다.

이는 구조를 수정하고 룩은 사용자에게 맡깁니다. 세 가지 그리드는 무엇이 어디에, 어떤 순서로 배치될지를 결정합니다. 서체, 색상, 모서리 반경, 간격은 사용자가 설정하며, 하나의 작은 블록에 정의됩니다. 이 스킬로 만든 두 포트폴리오는 같은 방식으로 읽히지만 전혀 다르게 보여야 합니다.

아래 경로는 이 스킬의 폴더를 기준으로 합니다.

작동 방식

하나의 파일인 portfolio.json에 모든 것이 담겨 있습니다: 사용자 정보, 프로젝트, 선택한 그리드, 룩. 하나의 명령어로 정적 사이트(순수 HTML과 CSS, 프레임워크 없음, 설치 필요 없음)로 변환됩니다:

python3 scripts/build.py path/to/their-site/portfolio.json

사이트는 콘텐츠 파일 옆에 생성됩니다. 그런 다음 스크립트는 두 가지 목록을 출력합니다: 30초 감사에서 여전히 지적될 사항들(각 항목은 references/rules.md의 규칙 번호와 연결됨)과 아직 채워지지 않은 모든 [슬롯]입니다. 둘 다 할 일 목록으로 처리하십시오.

단계

1. 포트폴리오의 용도 파악

다음 사항을 묻거나 주어진 정보에서 파악하십시오:

  • 대상. 타겟으로 하는 역할이나 클라이언트입니다. 헤드라인, 순서, 생략할 내용을 결정합니다.
  • 작업물. 어떤 프로젝트인지, 각 프로젝트에 대해: 무엇이었는지, 자신의 역할, 누구를 위한 것이었는지, 연도, 본인이 결정한 한 가지 사항과 그 결과.
  • 자료. 이미지와 비디오의 위치입니다.

기존 사이트가 있다면 먼저 읽고 거기에 있는 내용을 가져오십시오. portfolio-audit 스킬을 사용할 수 있고 라이브 사이트가 있다면, 먼저 실행하면 무엇을 변경해야 할지 정확히 알 수 있습니다.

찾을 수 없는 것에 대해서만 물어보십시오. 이미지 폴더와 LinkedIn 페이지를 가진 사람은 이미 대부분의 정보를 제공한 것입니다. 답변할 사람이 없다면, 가진 정보로 계속 진행하고 슬롯(3단계)을 사용하십시오.

사용자가 확신하지 못하는 자료(스케치북, 학생 프로젝트, 오래된 작업)는 제외하십시오. 그들이 의심한 데는 이유가 있으며, 포트폴리오는 가장 약한 작품으로 평가됩니다. 무엇을 제외했는지와 그 이유를 말하십시오. 세 개의 강력한 프로젝트면 완전한 포트폴리오입니다. 네 개를 채우기 위해 부풀리지 마십시오.

2. 사용자가 그리드를 선택하도록 하십시오.

references/grids.md를 읽으십시오. 세 가지 그리드와 각각이 적합한 대상을 설명합니다. 그리드는 전체 사이트가 어떻게 읽힐지를 결정하므로, 사용자의 선택이지 여러분의 선택이 아닙니다. 여러분의 역할은 그 선택을 쉽게 만드는 것입니다.

빌드하기 전에, 세 가지를 각각 한 줄로 짧게 설명하고, 작업물과 대상에 맞는 것을 추천하는 이유를 말하고, 어떤 것을 원하는지 물어보는 하나의 짧은 메시지를 보내십시오. 이를 1단계에서 물어봐야 할 다른 것들과 함께 묶어서, 질문을 두 번이 아니라 한 번만 하도록 하십시오.

  • 이미 그리드를 지정했다면, 그것을 사용하고 질문을 다시 열지 마십시오.
  • 추천과 다른 그리드를 선택했다면, 그들의 선택을 따르십시오. 문제가 된다면(예: index에는 결정과 결과를 위한 자리가 없음) 한 번만 그 비용을 언급하고, 그 후에는 넘어가십시오.
  • 확신이 없거나 답변할 사람이 없다면, 추천을 따라 진행하고 5단계에서 --compare 플래그를 사용하여 빌드하십시오. 그러면 세 가지 모두 나란히 열어볼 수 있습니다.

나중에 전환하려면 파일에서 한 단어만 바꾸면 되므로, 누구도 고정되지 않습니다. 이는 선택을 가볍게 제안할 이유이지, 건너뛸 이유가 아닙니다.

3. 콘텐츠 파일 작성

assets/example/portfolio.json을 시작점으로 복사하고, references/content.md에서 모든 필드를 읽으십시오. 사이트가 될 폴더에 이미지와 함께 넣으십시오. 예제는 case 그리드를 사용합니다. index와 columns의 경우, decision과 result는 선택 사항이며, before/after 행은 거의 필요하지 않습니다.

가장 중요한 부분을 작성하는 방법:

  • 헤드라인: 그들이 무엇을 만들고 누구를 위해 만드는지 한 문장으로, 사실을 포함하십시오. 다른 사람의 사이트에는 어울리지 않아야 합니다. "핀테크 앱을 위한 프로덕트 디자이너. 8년 경력, 최근에는 Ledger에서 저축 플로우 리드."가 아니라 "경험을 만드는 데 열정적인 멀티 디스ciplinar리 크리에이티브."가 아닙니다.
  • 증거: 헤드라인 바로 뒤에 가장 강력한 세 개 또는 네 개의 이름이나 숫자.
  • 순서: 대상에 가장 잘 맞는 프로젝트를 날짜와 관계없이 먼저 배치하십시오. 4~8개의 프로젝트. 사이드 분야(아트 디렉터의 영화, 프로덕트 디자이너의 일러스트레이션)는 섞어 넣기보다는 자체 콘텐츠 파일을 가진 별도의 사이트로 만드는 것이 좋습니다.
  • 각 프로젝트: 한 줄 요약, 역할, 그리고 클라이언트, 고용주, 또는 개인 콘셉트 중 어떤 것인지. 제품 및 리더십 대상의 경우 결정과 결과를 추가하십시오.
  • 역할: 지원하는 직함이 아닌 현재 직함 그대로.
  • 요청: 이메일 바로 위에 무엇에 대해 연락하라고 쓸지 한 문장.
  • 언어: 대상 고객의 언어로 작성하고 site.lang을 설정하십시오. 템플릿 자체 단어(Index, Facts, Next...)는 영어와 스페인어에 대해 따릅니다. 다른 언어의 경우 labels에서 설정하십시오.

사용자가 제공했거나 기존 페이지에 있는 사실만 사용하십시오. 파일 이름에서 읽은 클라이언트 이름과 같이 스스로 알아낸 사실은 사용할 수 있지만, 확인을 위해 추론했음을 사용자에게 알리십시오.

사실이 누락된 경우, 대괄호 안에 슬롯을 작성하십시오([year], [team size], [what shipped]). 슬롯은 사이트에 정확히 작성된 대로 나타나며, 빌드는 모든 슬롯을 나열합니다. 따라서:

  • 헤드라인에 슬롯이 없도록 유지하십시오: 알고 있는 내용으로 작성하십시오. 첫 문장의 슬롯은 방문자가 가장 먼저 읽게 됩니다.
  • 전체 필드를 알 수 없고 선택 사항인 경우(city, team, site.url), 필드를 생략하십시오.
  • 결과가 없는 작업의 경우, 사실을 말하십시오: "2024년 출시; 수치는 없습니다", "콘셉트, 출시되지 않음". 그것이 결과입니다. 영향력에 대한 빈 약속은 하지 마십시오.
  • 슬롯이 있는 사이트는 초안입니다. 인계 시 명확히 말하십시오.

정직한 공백이 있는 포트폴리오는 괜찮습니다. 가상의 클라이언트가 있는 포트폴리오는 면접에서 문제가 됩니다.

4. 룩 설정

theme 블록에서: 라이트 또는 다크, 하나의 강조 색상, 서체, 모서리 반경, 이미지 간격. 사용자에게 브랜드나 기존 사이트가 있다면, 거기서 가져오십시오. 아무것도 없다면, 작업에 어울리는 서체와 강조 색상을 선택하고 선택한 이유를 말하십시오. 예제나 다른 디자이너 사이트의 룩을 복사하지 마십시오.

모든 기기에 있는 서체가 아니라면 font_url로 로드해야 합니다. font에만 이름을 지정하면 대부분의 방문자는 시스템 글꼴로 대체됩니다. 둘 다 제공하거나 시스템 글꼴 스택을 선택하십시오.

5. 빌드, 확인, 수정

빌드를 실행하십시오. 사용자가 직접 그리드를 선택하지 않은 경우 --compare를 추가하십시오:

python3 scripts/build.py path/to/their-site/portfolio.json --compare

같은 콘텐츠를 세 가지 그리드 모두로 compare/ 폴더에 작성하며, 이 폴더에는 각 그리드를 연결하는 페이지가 포함됩니다. 사용자에게 해당 페이지를 보여주고 선택하게 하십시오. compare/는 선택 전용입니다: 게시하기 전에 삭제하십시오.

그런 다음 가능하다면 데스크톱과 휴대폰 너비로 브라우저에서 확인하십시오: 사이트 폴더에서 python3 -m http.server를 시작하고(case 그리드는 서버가 필요한 프로젝트 폴더로 연결됨) 첫 화면을 직접 확인하십시오: 이름, 하는 일, 증거, 연락 방법, 실제 작업물이 스크롤 없이 보이는지 확인하십시오.

브라우저를 열 수 없다면 인계 시 말하고, 적어도 헤드라인과 증거를 약 45단어로 유지하십시오. 이는 휴대폰에서 첫 번째 사진 위에 들어가는 분량입니다.

스크립트가 출력한 목록을 확인하십시오. 콘텐츠에서 수정할 수 있는 것(누락된 역할 줄, 무거운 이미지, 긴 헤드라인)을 수정하십시오. 나머지는 사용자만 제공할 수 있는 짧은 목록으로 전달하십시오.

6. 인계

다음 내용을 알리십시오: 어떤 그리드를 사용했는지와 사용자가 선택했는지 또는 여러분이 선택했는지(그리고 다른 두 가지는 한 단어만 변경하면 되거나, compare/ 폴더에 있음), 헤드라인에 무엇을 썼는지, 무엇을 제외했는지, 추론한 내용, 아직 채워야 할 슬롯, 감사 목록에 여전히 표시되는 사항, 그리고 변경 방법(portfolio.json을 편집하고 빌드를 다시 실행). 폴더는 완전한 정적 사이트입니다: 현재 상태 그대로 업로드하여 모든 정적 호스트에 게시할 수 있습니다.

사용자만 제공할 수 있는 두 가지 사항이 있으므로 여기서 요청하십시오: 사이트가 위치할 주소(site.url)와 링크 미리보기용 1200×630 사진(site.share_image). 첫 번째 프로젝트의 가장 좋은 사진을 크롭한 것으로 충분합니다.

이미지

  • 최대 2000px 너비로 내보내고, AVIF 또는 WebP 형식으로 각각 약 500KB 미만으로 유지하십시오. 빌드에서 더 무거운 이미지에 대해 경고합니다. JPEG, PNG, SVG도 작동합니다.
  • 휴대폰용 작은 복사본은 파일이 쌍으로 이름 지정될 때 자동으로 사용됩니다: 콘텐츠 파일의 shot-lg.jpg와 그 옆의 shot-sm.jpg. 같은 이름의 .avif 파일이 있으면 이를 읽을 수 있는 브라우저에 먼저 제공됩니다.
  • 각 사진에 alt 속성을 제공하여 무엇을 보여주는지 설명하십시오. 없으면 프로젝트 제목이 사용되며, 이는 검색 엔진이나 AI 어시스턴트에게 거의 정보를 제공하지 않습니다. 사진을 보지 못했다면 각각이 어떤 작품인지 말하고 사용자에게 설명을 요청하십시오.
  • 짧은 반복 비디오(.mp4, .webm)는 타일로 작동합니다. 화면에 있는 동안에만 음소거된 상태로 재생됩니다. ratio를 제공하십시오.

하지 말아야 할 것

  • 콘텐츠를 지연시키는 인트로 애니메이션, 로더, 커스텀 커서 또는 스크롤 효과를 추가하지 마십시오. 템플릿은 의도적으로 첫 화면을 즉시 표시합니다.
  • 프로젝트 제목을 호버 뒤에 숨기지 마십시오. 휴대폰에는 호버가 없습니다.
  • 연락처 블록이 스크롤되어 사라진 후 나타나는 이름과 이메일이 있는 작은 막대인 도크를 제거하지 마십시오. 검토자는 페이지 끝이 아니라 프로젝트 중간에 연락하기로 결정합니다.
  • 얇은 작업을 프로세스 사진(스티커 메모, 페르소나)으로 부풀리지 마십시오. 명확하게 말한 한 가지 결정이 더 가치 있습니다.
  • 생성된 HTML을 수동으로 편집하지 마십시오: 다음 빌드에서 덮어씁니다. 콘텐츠 파일을 변경하거나, 구조 자체를 변경해야 하는 경우 assets/template/의 템플릿을 변경하십시오.

Individual skills in this repo

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

관련 스킬