Communitygithub.com

IdkwhatImD0ing/hackathonstarterkit

해커톤 프로젝트를 위한 채용 담당자용 포트폴리오 웹사이트를 생성합니다. 웹 앱이 아닌 프로젝트(하드웨어, ML 모델, CLI, 연구)도 멋지게 보여줄 수 있습니다.

hackathonstarterkit란 무엇인가요?

이 스킬은 해커톤 프로젝트를 채용 담당자에게 어필할 수 있는 원페이지 케이스 스터디 웹사이트로 변환합니다. 웹 앱뿐만 아니라 하드웨어, ML 모델, CLI 도구, 연구 프로젝트 등 어떤 유형의 프로젝트든 비디오, 다이어그램, 사진, 인터랙티브 복제본을 통해 효과적으로 시연할 수 있습니다. Anthropic의 frontend-design 스킬을 활용하여 각 프로젝트마다 고유하고 템플릿화되지 않은 디자인을 생성하므로, 모든 사이트가 서로 다른 독창적인 외관을 갖습니다. 히어로, 문제 정의, 아키텍처, 데모, 결과, 팀, 그리고 솔직한 한계점을 포함한 완전한 원페이지 케이스 스터디를 구축하며, 실제 데이터와 증거만을 사용하고 허위 사실을 절대 만들어내지 않습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IdkwhatImD0ing/hackathonstarterkit/tree/HEAD/skills/portfolio-builder

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

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

문서

포트폴리오 빌더

해커톤 프로젝트를 위한 채용 담당자용 원페이지 쇼케이스 사이트를 구축하세요. 프로젝트 자체가 웹 앱이 아닌 경우(하드웨어 빌드, ML 모델, CLI, 연구 프로젝트)에도 사이트가 결과물이며, 비디오, 다이어그램, 사진, 인터랙티브 복제본을 통해 작업을 보여줍니다. 목표는 다음 케이스 스터디 사이트들이 설정한 기준입니다: dispatchai.art3m1s.me, talktuah.art3m1s.me, slugloop.com, adapted.art3m1s.me. 각 사이트는 서로 전혀 다르게 보입니다. 각 디자인이 프로젝트 자체의 세계에서 끌어왔기 때문입니다. 그 독창성이 핵심이며, 이것이 이 스킬이 고정 템플릿 대신 frontend-design 스킬에 의존하는 이유입니다.

1단계: 디자인 엔진 사용 가능하도록 만들기

디자인은 Anthropic의 frontend-design 스킬에서 비롯되며, 이 스킬이 결과물이 일반적인 AI 페이지처럼 읽히지 않도록 방지합니다. 디자인을 시작하기 전에 이 스킬을 사용할 수 있어야 합니다.

이는 사용자 사전 조건이며, 에이전트가 대신 수행할 수 없습니다(에이전트는 슬래시 명령어를 실행할 수 없기 때문). frontend-design이 이미 사용 가능한 스킬에 나타나면 준비가 된 것입니다. 그렇지 않다면, 사용자에게 Claude Code에서 플러그인을 설치하기 위해 다음 두 명령어를 실행하도록 요청하세요:

/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official

첫 번째 줄은 해당 마켓플레이스가 아직 추가되지 않은 경우에만 필요합니다. Claude는 프론트엔드 작업을 위해 frontend-design을 자동으로 적용하기도 하므로 그 원칙이 이미 적용되고 있을 수 있지만, 플러그인이 있다고 가정하지 말고 사용자에게 확인을 요청하세요. 3단계의 모든 디자인 결정은 이 스킬을 통해 실행됩니다.

2단계: 사실 수집

먼저 감지하고, 그 다음에 물어보세요. AGENTS.md, PRD.md, README, package.json, 그리고 리포지토리에 이미 있는 사진, 스크린샷, 다이어그램을 읽으세요. 그런 다음 누락된 것만 물어보세요:

  • 프로젝트 이름과 기술이 아닌 이해관계를 나타내는 태그라인.
  • 프로젝트 유형: 웹 앱, 하드웨어 또는 IoT, ML 모델, CLI 또는 개발 도구, 모바일 앱, 또는 연구 및 데이터. 이에 따라 4단계에서 표시 방법이 결정됩니다.
  • 문제점: 하나의 실제 통계와 출처 포함.
  • 기능: 3~5개의 핵심 기능.
  • 작동 방식: 아키텍처 다이어그램을 그릴 수 있을 정도의 시스템 설명.
  • 증거: 데모 비디오(YouTube), 라이브 URL, Devpost, GitHub, 언론 보도, 그리고 모든 오픈소스 아티팩트(모델, 데이터셋, Figma).
  • 이벤트 미디어: 해커톤 현장의 솔직한 사진과 클립으로, 리포지토리에 거의 포함되지 않습니다. 팀 및 빌드 진행 중 사진, 데모 데이 또는 무대 및 수상 사진, 화이트보드나 종이 스케치, 장소, 그리고 이 미디어가 어디에 있는지(휴대폰, 공유 드라이브, Devpost 갤러리)을 명시적으로 요청하세요. 이 미디어가 사이트를 실제처럼 느껴지게 하므로, 리포지토리에 있다고 가정하지 말고 요청하세요. 아무것도 없으면 스크린샷, 다이어그램, 데모 비디오로 대체하세요.
  • 결과: 수상 및 순위, 이벤트 이름, 날짜, 규모, 순위, 빌드 시간, 팀 규모, 그리고 모든 지표(커밋 수, 지연 시간, 사용자 수).
  • 팀: 이름, 역할, GitHub 핸들, LinkedIn URL, 헤드샷.

수상, 통계, 상금, 순위, 인용구를 절대 지어내지 마세요. 질문 후에도 사실을 알 수 없으면 해당 섹션을 추측하지 말고 생략하세요.

3단계: frontend-design을 통해 디자인하기

2단계에서 수집한 정보로 frontend-design에 브리핑을 전달하고 전체 루프(브레인스토밍, 탐색, 계획, 비평, 빌드, 다시 비평)를 실행하세요. 핵심 규칙이 여기에 적용됩니다: 기본값이 아닌 주제에서 외관을 도출하세요. 이 프로젝트에 특화된 간결한 토큰 시스템을 생성하세요:

  • 팔레트: 프로젝트 세계에서 가져온 4~6개의 명명된 16진수 값. 911 디스패처는 거의 검은색 바탕에 위험을 나타내는 빨강과 호박색으로 읽힙니다; 음성 은행은 신뢰를 주는 파란색으로 읽힙니다; UCSC 자전거 메쉬 빌드는 낡은 "야장" 아카이브 팔레트로 읽힙니다.
  • 타이포그래피: 절제되게 사용되는 개성 있는 디스플레이 서체, 보완적인 본문 서체, 그리고 데이터를 위한 유틸리티 또는 모노 서체. 매 프로젝트마다 같은 패밀리가 아닌 의도적으로 짝지어집니다.
  • 레이아웃: 5단계의 뼈대를 따르는 스크롤텔링 원페이지.
  • 모션: 주제에 기여하는 하나의 조율된 모션 순간(예: 스크롤 트리거 아키텍처 공개, 원격 측정 재생). 흩어진 효과는 AI 생성으로 읽히므로 모션을 한 곳에 집중하세요. 이는 6단계의 축소 모션 접근성 기준과 별개입니다.
  • 시그니처: 이 사이트가 기억되는 단일 요소로, 이 프로젝트를 구현합니다. Dispatch는 시드 데이터에서 실행되는 내장 인터랙티브 운영자 콘솔을 가지고 있습니다; Slugloop는 "수신기가 더 이상 핑을 보내지 않는다"는 아카이브 프레이밍을 가지고 있습니다; AdaptEd는 번호가 매겨진 학습 루프를 가지고 있습니다.

frontend-design에서 가져온 두 가지 가드:

  • 기본 AI 스타일 피하기: 프로젝트 세계가 진정으로 요구하지 않는 한 (1) 크림색 배경에 고대비 세리프와 테라코타 악센트, (2) 거의 검은색 배경에 단일 산성 녹색 또는 주홍색 악센트, (3) 신문 헤어라인 규칙에 제로 border-radius와 빽빽한 컬럼. 팔레트와 타이포그래피 계획이 반사적으로 이 중 하나에 도달하면 수정하고 이유를 설명하세요.
  • 구조는 정보입니다. 번호가 매겨진 마커, 부제목, 구분선은 AdaptEd의 루프와 같은 실제 시퀀스를 인코딩할 때만 사용하고 장식으로 절대 사용하지 마세요. 5단계의 뼈대 번호는 작성 체크리스트이지 필수 시각적 처리가 아닙니다.

섹션 레이블도 디자인 표면입니다. 뼈대는 기본 구조입니다. 해당 섹션의 제목을 프로젝트의 목소리로 바꾸세요("쇼케이스" 대신 "야장", "솔직한 한계" 대신 세계관에 맞는 문구, 주제에 맞는 경우 01부터 0N까지 번호 매기기). 빌드 전에 계획-비평 게이트를 실행하세요. 어떤 선택이 다른 유사한 프로젝트에 대해서도 만들 페이지로 읽힌다면 수정하세요. 계획이 이 브리핑에 진정으로 특화된 후에만 빌드하세요.

4단계: 작업 표시 방법 선택

사이트는 프로젝트가 무엇이든 관계없이 쇼케이스를 제공합니다. 보편적인 기준은 데모 비디오와 프로젝트의 주요 아티팩트입니다(영상, 사진, 원격 측정 재생, 평가 결과, 터미널 재생). 그런 다음 프로젝트 유형별로 주요 쇼케이스 장치를 선택하세요:

  • 웹 앱: 시드 데이터에서 실행되는 내장 인터랙티브 위젯 또는 콘솔(Dispatch의 운영자 콘솔). 상호작용이 불가능한 경우에만 읽기 전용 보기로 대체하세요.
  • 하드웨어 또는 IoT: 빌드 사진, 배선 또는 시스템 다이어그램, 현장 영상, 지도 또는 원격 측정 재생(Slugloop).
  • ML 모델: 인터랙티브 추론 위젯 또는 전후 비교, 평가 수치, Hugging Face 링크.
  • CLI 또는 개발 도구: 터미널 재생(asciinema 스타일) 또는 애니메이션 명령 시퀀스.
  • 모바일: 기기 프레임 비디오 또는 클릭 가능한 화면 흐름.
  • 연구 또는 데이터: 주요 도표, 차트, 방법론 다이어그램.

데모는 여러 개일 수 있습니다. 도움이 되는 경우 두 가지 데모 모드를 제공하거나(수동 둘러보기 + 인터랙티브 모드, TalkTuah처럼), 초기 프로토타입 클립과 최종 현장 클립을 짝지어 반복 과정을 보여주세요(Slugloop). 실제 백엔드가 정적 사이트에서 실행될 수 없을 때만 복제본을 모의로 만들고, 그럴 때는 현실적인 데이터로 시드하고 명확히 복제본이라고 표시하세요. 실제 현장 영상으로 만든 하드웨어 사이트는 모의나 그러한 레이블이 필요하지 않습니다.

프로젝트가 실제 언론 보도를 받았다면 신뢰성 장치로 취급하세요. 클리핑을 인용구와 출처가 있는 카드 또는 매체 로고로 렌더링하고(Slugloop), 링크만 나열하지 마세요.

5단계: 케이스 스터디 뼈대

원페이지 스크롤, 채용 담당자 우선. 메뉴로 취급하세요: 사실이 존재하는 경우에만 섹션을 포함하고, 제목을 프로젝트 목소리로 바꾸세요(3단계 참조). 여기의 번호는 작성 체크리스트이지 필수 시각적 스타일이 아닙니다.

  1. 히어로(테제): 프로젝트의 가장 특징적인 점, 태그라인, 주요 CTA(데모, Devpost, GitHub)로 시작하세요. 최고 수상 또는 자격 증명을 보이게 유지하세요.
  2. 신뢰성 스트립: 순위, 상금, 순위, 현장 규모.
  3. 문제: 이해관계와 출처가 있는 하나의 통계.
  4. 기능: 핵심 기능. 기능 카드는 아키텍처 섹션의 해당 부분으로 딥링크 또는 스크롤 앵커되어 '무엇'과 '어떻게'를 연결할 수 있습니다(TalkTuah).
  5. 작동 방식: 아키텍처 또는 시스템 다이어그램, 엔지니어링 깊이가 드러나는 부분.
  6. 쇼케이스: 4단계에서 선택한 장치(인터랙티브 위젯, 비디오, 사진, 원격 측정 재생). 해당되는 경우 이중 또는 반복 비디오 블록을 허용하세요.
  7. 숫자로 보기: 큰 숫자와 짧은 레이블로 구성된 대담한 통계 그리드. 팀 규모, 빌드 시간, 커밋 수, 순위를 하나의 시그니처 블록으로 통합할 수 있습니다(Slugloop: 학생 4명, 36시간, 500개 이상의 커밋, Top 10). 순위는 신뢰성 스트립에도 나타날 수 있습니다.
  8. 언론(선택 사항): 인용구와 출처가 있는 클리핑 카드 또는 매체 로고 형태의 실제 보도.
  9. 팀: 역할, GitHub, LinkedIn이 포함된 약력.
  10. 솔직한 한계: 주말 빌드가 무엇이고 무엇이 아닌지. 트레이드오프를 명명하는 것은 약점이 아니라 성숙함으로 읽힙니다.
  11. 링크 및 출처: GitHub, Devpost, YouTube, 모델 또는 데이터셋, 언론.
  12. 푸터: 이벤트에서 N시간 동안 구축, 리포지토리 및 라이브 링크 포함.

6단계: 빌드하기

  • 정적으로 내보낼 수 있고 Vercel에 배포할 수 있는 독립형 원페이지 사이트를 빌드하세요. 기본값은 Next.js(App Router)입니다. 프로젝트에 기존 스택이 있으면 일치시키세요. 제품 코드와 엉키지 않도록 자체 폴더(site/ 또는 portfolio/) 또는 별도 리포지토리에 넣으세요.
  • 전체에 실제 콘텐츠를 사용하세요. 로렘 입숨 금지. frontend-design의 작성 지침을 따르세요: 평이하고, 구체적이며, 화면 반대편의 독자 입장에서 작성하세요.
  • 발표하지 않고 품질 기준을 유지하세요: 모바일까지 반응형, 키보드 포커스 가시성, 축소 모션 존중.
  • SEO 기본 사항 포함: 키워드 인식 제목 및 설명, 표준 URL, Open Graph 이미지, 정확히 하나의 h1, 의미 섹션.
  • 실제 스크린샷, 사진, 다이어그램을 사용하세요. 2단계에서 수집한 이벤트 미디어를 쇼케이스, 팀, 숫자로 보기 섹션에 배치하세요. 모의 복제본을 제공하는 경우 레이블을 붙이세요. 데모에는 YouTube 포스터를 사용하세요.
  • 렌더링 후 다시 비평하세요. frontend-design 지침에 따라 페이지 스크린샷을 찍고 "이와 같은 모습을 관련 없는 프로젝트에 대해서도 만들었을까?"라고 다시 질문하고, 브리핑에 기여하지 않는 장식을 하나 제거하여 액세서리를 줄이세요.

확인

  • frontend-design이 실제로 사용되었고, 결과가 일반적인 AI 기본값으로 읽히거나 세 가지 기본 스타일 중 하나에 해당하지 않는지 확인합니다. 빌드 후 자체 비평을 적용하세요: 이와 같은 모습을 관련 없는 프로젝트에 대해서도 만들었을까?
  • 하나의 h1, 의미 있는 제목, 모바일 반응형, 포커스 상태 가시성, 축소 모션 준수.
  • 모든 수상 및 통계는 실제이며, 모의 복제본은 레이블이 지정되고, 모든 링크가 확인되며, 데모 비디오가 포함됩니다.
  • 로컬에서 빌드하고 미리보기. 실용적인 경우 Core Web Vitals 또는 Lighthouse 통과를 확인하세요.

최종 출력

  1. 사이트: 경로 또는 라우트, 실행 방법.
  2. 디자인 시스템: 팔레트, 타이포그래피 페어링, 모션 순간, 시그니처 요소, 각각이 이 프로젝트에 적합한 이유를 한 줄로 설명.
  3. 쇼케이스 장치: 어떤 것을 사용했고 왜 프로젝트 유형에 적합한지.
  4. 사용된 사실과 생략된 사실: 포함된 것과 실제 사실 부족으로 건너뛴 섹션.
  5. 배포: Vercel에 배포하는 단계.
  6. 다음 단계: 예: 사용자 정의 도메인, README 및 LinkedIn 게시물에서 사이트 링크.

경계

  • 먼저 frontend-design을 사용할 수 있게 만들고, 템플릿화된 기본값을 절대 배포하지 마세요. 디자인은 이 프로젝트에 특화되어야 합니다.
  • 수상, 통계, 언론 보도를 절대 지어내지 말고, 모의 복제본은 항상 레이블을 붙이세요.
  • 하나의 집중된 페이지로 유지하세요. 전체 제품을 다시 구축하지 마세요.
  • 실제로 존재하는 것을 설명하세요. 사이트는 이상적인 버전이 아닌 실제 프로젝트를 반영합니다.

관련 스킬