Communitygithub.com

Yukiniro/skills

이력서를 인터랙티브하고 애니메이션이 적용된 단일 페이지 HTML 이력서 웹사이트로 변환합니다. 독특한 시각적 스타일과 '보여주고, 말하지 마세요' 철학을 통해 비디자이너도 자신의 미학을 발견할 수 있도록 도와줍니다. PDF, DOCX, 마크다운, 일반 텍스트, JSON Resume, 직접 텍스트 입력 및 기존 HTML 이력서 개선을 지원합니다.

skills란 무엇인가요?

이 스킬은 사용자의 이력서(파일, 텍스트, 기존 HTML 등)를 독립적인 단일 HTML 파일로 변환하여, 브라우저에서 바로 실행되는 애니메이션 기반의 인터랙티브 이력서 웹사이트를 생성합니다. 외부 의존성 없이 모든 CSS와 JavaScript가 인라인으로 포함되며, 사용자는 시각적 탐색(스타일 미리보기)을 통해 자신에게 맞는 미학을 발견하고 선택할 수 있습니다. '보여주고, 말하지 마세요' 철학을 중심으로, 미리 정의된 10가지 프리셋(예: 미드나잇 아키텍트, 네온 터미널)을 제공하고, 분위기와 톤 질문에 따라 맞춤형 미리보기를 생성하여 사용자의 선택을 돕습니다. 최종 결과물은 스크롤 트리거 애니메이션, 부동 탐색, 프로그레스 바, 인쇄 지원, 접근성(WCAG AA) 및 반응형 디자인을 갖춘 프로덕션 품질의 이력서입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yukiniro/skills/tree/HEAD/skills/frontend-resume

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

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

문서

프론트엔드 이력서

브라우저에서 완전히 실행되는, 의존성이 없는 애니메이션 HTML 이력서 페이지를 만듭니다. 사용자가 시각적 탐색을 통해 선호하는 미학을 발견하고, 프로덕션 품질의 인터랙티브 이력서를 생성할 수 있도록 도와줍니다.

핵심 철학

  1. 의존성 제로 — CSS/JS가 인라인으로 포함된 단일 HTML 파일. npm이나 빌드 도구가 필요 없습니다.
  2. 보여주고, 말하지 마세요 — 시각적 미리보기를 생성하고, 사용자가 마음에 드는 것을 선택하게 합니다.
  3. 독특한 디자인 — 일반적인 'AI 슬롭' 미학을 피합니다. 각 이력서는 맞춤 제작된 느낌을 줍니다.
  4. 인쇄 친화적 — 모든 이력서는 깔끔한 PDF 출력을 위해 @media print 스타일을 반드시 포함해야 합니다.
  5. 접근성 — 시맨틱 HTML, 키보드 내비게이션, 축소된 동작 지원, WCAG AA 대비.

0단계: 모드 감지

사용자가 원하는 것이 무엇인지 파악합니다:

모드 A: 파일에서 — 사용자가 이력서 파일(.pdf, .docx, .md, .txt, .json)을 제공합니다 → 1단계 모드 B: 텍스트에서 — 사용자가 이력서 내용을 텍스트로 제공합니다 → 1단계 모드 C: 개선 — 사용자가 개선할 기존 HTML 이력서를 가지고 있습니다 → 파일을 읽은 후 2단계


1단계: 콘텐츠 추출 및 구조화

1.1단계: 파일 추출 (모드 A만 해당)

사용자 이력서 파일에서 scripts/extract_resume.py를 실행합니다:

python [skill-dir]/scripts/extract_resume.py <resume_file>

지원되는 형식 및 의존성:

형식확장자Python 의존성참고 사항
PDF.pdfpdfplumber(권장) 또는 PyPDF2pip install pdfplumber
Word.docxpython-docxpip install python-docx
마크다운.md없음제목, 목록, 굵게/기울임꼴 구문 분석
일반 텍스트.txt없음대문자 라인은 제목으로 추론
JSON Resume.json없음 (내장 json)jsonresume.org 스키마; 이미 구조화되어 있음 — 1.2단계를 건너뛸 수 있음

필요한 의존성이 없으면 스크립트가 설치 안내를 출력합니다.

추출된 콘텐츠를 사용자에게 확인을 위해 제시합니다. JSON Resume 파일의 경우 데이터가 이미 구조화되어 있으므로 — 매핑된 섹션을 직접 제시하고, 사용자가 조정을 원하지 않으면 1.3단계로 건너뜁니다.

1.2단계: 콘텐츠 구조화

원시 텍스트를 구조화된 섹션으로 구문 분석합니다:

  • header: 이름, 직함/태그라인, 위치, 연락처(이메일, 전화, LinkedIn, GitHub, 포트폴리오)
  • about: 전문 요약
  • experience[]: 회사, 역할, 날짜, 위치, 항목
  • education[]: 학교, 학위, 날짜, 영예/GPA
  • skills{}: 카테고리별로 그룹화되고 선택적 숙련도 수준(0-100) 포함
  • projects[]: 이름, 설명, 기술 스택, 링크
  • certifications[]: 이름, 발급 기관, 날짜(선택 사항)
  • languages[]: 언어, 숙련도(선택 사항)

구조화된 콘텐츠를 사용자에게 검토를 위해 제시합니다. "이 내용이 맞습니까? 추가, 제거 또는 수정할 섹션이 있습니까?"라고 물어봅니다.

1.3단계: 섹션 우선순위

AskUserQuestion을 통해 질문합니다:

  • 헤더: "레이아웃"
  • 질문: "어떤 섹션을 가장 눈에 띄게 할까요?"
  • 옵션:
    • "경험 중심" — 업무 경험이 핵심 (시니어 전문가)
    • "기술 중심" — 기술 역량이 전면에 (개발자/엔지니어)
    • "프로젝트 중심" — 포트폴리오/프로젝트가 주목 (디자이너/프리랜서)
    • "균형 잡힌" — 모든 섹션에 동일한 가중치

2단계: 스타일 발견

2.0단계: 스타일 경로

질문: "이력서 스타일을 어떻게 선택하시겠습니까?"

  • "옵션 보여주기" — 3개의 시각적 미리보기 생성 (권장) → 2.1단계
  • "원하는 것을 알고 있습니다" — 사전 설정 목록에서 직접 선택 → 아래 사전 설정 선택기 표시

사용 가능한 사전 설정:

사전 설정분위기가장 적합한 대상
미드나잇 아키텍트정교함, 프리미엄임원, 컨설턴트
네온 터미널해커-시크, 개발자 지향소프트웨어 엔지니어, DevOps
다크 럭스우아함, 편집 스타일크리에이티브 디렉터, 마케팅
코스믹 뎁스대담함, 미래지향적기술 창업자, AI/ML 엔지니어
클린 슬레이트미니멀, 스위스 디자인디자이너, 제품 관리자
페이퍼 크래프트따뜻함, 촉각적작가, 교육자, 학자
소프트 블루프린트기술적, 친근함엔지니어, 데이터 과학자
브루털리스트 모노투박함, 안티-디자인브랜드 전략가, 눈에 띄고 싶은 사람
세이지 가든자연에서 영감, 차분함HR, 웰니스, 교육자
레트로 잉크빈티지 편집 스타일저널리스트, 개인 브랜드

사용자가 직접 선택하면 3단계로 건너뜁니다.

2.1단계: 가이드 발견

질문 1 — 분위기 (최대 2개 다중 선택):

  • "전문적/권위적" — 확립되고 신뢰할 수 있음
  • "창의적/독특함" — 독특하고 디자인 중심
  • "모던/기술적" — 깔끔하고 개발자 지향
  • "따뜻함/친근함" — 친근하고 호감 가는

질문 2 — 톤:

  • "라이트" — 깔끔하고 인쇄 가능
  • "다크" — 대담하고 화면에 최적화
  • "어느 쪽이든" — 스타일이 결정하게 함

2.2단계: 미리보기 3개 생성

분위기 + 톤에 따라 사전 설정 3개를 선택합니다. 전체 사전 설정 정의는 references/STYLE_PRESETS.md를 참조하세요.

분위기-사전 설정 매핑:

분위기다크라이트스페셜티
전문적미드나잇 아키텍트, 다크 럭스클린 슬레이트, 소프트 블루프린트—
창의적다크 럭스, 코스믹 뎁스페이퍼 크래프트브루털리스트 모노, 레트로 잉크
모던/기술적네온 터미널, 코스믹 뎁스소프트 블루프린트브루털리스트 모노
따뜻함다크 럭스페이퍼 크래프트, 세이지 가든레트로 잉크

.claude-design/resume-previews/ 디렉토리에 미니 HTML 미리보기 3개를 생성합니다:

.claude-design/resume-previews/
├── style-a.html
├── style-b.html
└── style-c.html

각 미리보기: 자체 포함됨 (~80-120줄), 히어로 섹션 + 경험 항목 하나 + 기술 막대를 보여줍니다. 미학을 전달하기에 충분합니다.

절대 사용하지 말아야 할 일반적인 패턴:

  • Inter, Roboto, Arial을 디스플레이 폰트로 사용
  • 흰색 바탕에 보라색 그라데이션, 진부한 남색 #6366f1
  • 변형 없이 모든 것을 중앙 정렬
  • 과도한 글래스모피즘

2.3단계: 선택

미리보기를 제시하고, 사용자에게 하나를 선택하거나 요소를 혼합하도록 요청합니다.


3단계: 이력서 생성

선택한 사전 설정에 대해 다음 참조 파일을 읽습니다:

  • references/STYLE_PRESETS.md — 전체 CSS 변수, 글꼴 URL, 색상 팔레트, 애니메이션 스타일
  • references/RESUME_COMPONENTS.md — 인터랙티브 구성 요소 CSS/JS 패턴
  • references/HTML_ARCHITECTURE.md — 기본 HTML 템플릿, 필수 CSS, JS 아키텍처, 인쇄 스타일, 접근성 체크리스트

출력

자체 포함된 단일 HTML 파일을 생성합니다:

  • 모든 CSS는 <style>에 인라인
  • 모든 JS는 <script>에 인라인
  • Google Fonts / Fontshare는 <link>를 통해 (품위 있게 저하 가능)
  • 시맨틱 HTML5 구조

필수 기능

  1. 스크롤 트리거 공개 — IntersectionObserver를 통해 요소가 애니메이션으로 나타남
  2. 부동 탐색 — 활성 섹션 추적 기능이 있는 고정 탐색
  3. 애니메이션 기술 막대 — 보이는 영역으로 스크롤될 때 채워짐
  4. 스크롤 진행률 표시줄 — 상단의 얇은 막대
  5. 맨 위로 가기 버튼 — 스크롤 후 나타남
  6. 인쇄 스타일시트 — 흰색 배경, 애니메이션 없음, 표시되는 URL이 있는 @media print
  7. 축소된 동작 — @media (prefers-reduced-motion: reduce)는 애니메이션을 비활성화함
  8. 반응형 — 모든 크기가 clamp()를 사용하며, 모바일에서 데스크톱까지 작동

확인 체크리스트

전달하기 전에 다음을 확인합니다:

  • 모든 타이포그래피가 clamp(min, preferred, max)를 사용
  • 모든 간격이 clamp() 또는 뷰포트 단위를 사용
  • 시맨틱 HTML (<header>, <main>, <section>, <nav>)
  • 인쇄 스타일이 포함되고 기능함
  • 축소된 동작이 존중됨
  • 탐색, 버튼, 진행률 표시줄에 ARIA 레이블
  • 색상 대비가 WCAG AA를 충족
  • 외부 링크에 target="_blank" rel="noopener"가 있음

4단계: 전달

  1. 정리 — .claude-design/resume-previews/ 디렉토리가 있으면 삭제합니다.
  2. 열기 — 브라우저에서 실행: open [filename].html
  3. 요약:
인터랙티브 이력서가 준비되었습니다!

파일: [filename].html
스타일: [스타일 이름]
섹션: [목록]

기능:
- 스크롤 트리거 애니메이션
- 애니메이션 기술 막대
- 인터랙티브 타임라인
- 부동 탐색
- 인쇄 친화적 (Ctrl+P)
- 모든 화면 크기에서 반응형

맞춤 설정하려면:
- 색상: 상단의 :root CSS 변수 수정
- 글꼴: 글꼴 가져오기 링크 변경
- 애니메이션: .reveal 클래스 타이밍 수정
- 콘텐츠: HTML에서 직접 텍스트 편집

조정이 필요하신가요?

문제 해결

PDF 추출 시 텍스트가 거의 없음: PDF가 이미지 기반(스캔)일 수 있습니다. 사용자에게 텍스트 콘텐츠를 직접 제공하도록 요청하세요.

DOCX 추출 시 구조 누락: 일부 DOCX 파일은 표준 제목 스타일(Heading 1/2/3)을 사용하지 않습니다. 추출기는 개별 실행의 글꼴 크기로 대체합니다. 구조가 여전히 불명확하면, 사용자에게 어떤 줄이 섹션 헤더인지 확인하도록 요청하세요.

JSON Resume 필드 누락: JSON이 선택적 섹션(프로젝트, 자격증 등)을 생략할 수 있습니다. 사용 가능한 항목을 제시하고 사용자에게 누락된 섹션을 수동으로 추가할지 물어보세요.

마크다운 프론트매터 간섭: YAML 프론트매터 구분 기호(---)는 자동으로 건너뜁니다. 이력서 콘텐츠 자체가 ---를 수평선으로 사용하는 경우에도 건너뛰며, 이는 일반적으로 무해합니다.

글꼴이 로드되지 않음: 글꼴 URL을 확인하세요. font-family 선언에 시스템 글꼴 대체가 포함되어 있는지 확인하세요.

애니메이션이 트리거되지 않음: IntersectionObserver가 초기화되었는지 확인하세요. .visible 클래스가 추가되고 있는지 확인하세요.

인쇄 출력이 잘못됨: @media print 블록이 있는지 확인하세요. 애니메이션이 비활성화되고 배경이 흰색인지 확인하세요.

관련 스킬