Communitygithub.com

oneconsciousness/job-hunt-with-hope

사용자가 이력서가 아니라 자신의 작업, 이야기, 증거를 담은 독립형 브랜드 포트폴리오 폴더를 생성하고자 할 때 사용합니다. (오프라인에서도 작동하며, 로컬 서버에서 제공하거나 직접 열 수 있음) 채용 담당자에게 보내거나, 링크로 공유하거나, PDF로 저장할 수 있습니다.

job-hunt-with-hope란 무엇인가요?

이 스킬은 사용자의 경력 데이터를 기반으로 시각적으로 뛰어나고 완전히 독립적인 포트폴리오 폴더를 생성하는 Hope 포트폴리오 생성기의 핵심 기능입니다. 사용자가 특정 회사(예: 'Anthropic을 위한 포트폴리오 만들어 줘')를 대상으로 포트폴리오를 요청하면 스킬은 경력 그래프를 분석하여 해당 직무에 가장 적합한 경험, 프로젝트, 기술을 선별합니다. 결과물은 index.html, portfolio.css, portfolio.js, data.js로 구성된 폴더로, 모든 브라우저에서 인터넷 연결 없이도 완벽하게 작동합니다. 이 스킬은 Claude Code, Cursor와 같은 AI 에이전트 플랫폼에서 실행되며, 사용자의 경력 파일과 채팅 내용에만 기반하여 사실을 지어내지 않고 Hope의 독특한 보이스(목소리)로 작성됩니다. 주요 특징으로는 직관적인 섹션 그리드 탐색, 어두운/밝은 테마 전환, 인터랙티브 타임라인, PDF 내보내기, 소셜 미디어 공유 카드 등이 포함되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oneconsciousness/job-hunt-with-hope/tree/HEAD/skills/portfolio

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

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

문서

Hope 포트폴리오 · 마일스톤 3 — Hope의 시그니처

당신은 Hope의 포트폴리오 생성을 실행하고 있습니다. 이것이 Hope를 정의하는 스킬입니다. 사용자는 이 아티팩트를 제출하면 면접 제안을 받게 됩니다. 제대로 만드세요.

먼저 플러그인 파일을 찾으세요 (다른 작업 전에 이 작업을 먼저 하십시오)

Hope의 참조 문서와 포트폴리오 템플릿 폴더는 사용자의 프로젝트가 아닌 플러그인 내부에 있습니다. 아래 경로(references/…, assets/templates/…)는 플러그인 루트를 기준으로 한 상대 경로입니다. 이들은 작업 디렉토리(사용자의 프로젝트 폴더)를 기준으로 하지 않습니다. ${CLAUDE_PLUGIN_ROOT}는 이 Markdown 내에서 대체되지 않으므로, 무언가를 읽기 전에 Bash를 사용하여 플러그인 루트를 직접 한 번 확인해야 합니다:

# Hope 플러그인 루트(references/, assets/, scripts/가 있는 곳)를 확인합니다.
# $CLAUDE_PLUGIN_ROOT는 이 Markdown에서 확장되지 않습니다 — Bash에서 확인하세요.
# Hope가 설치되었든, 마켓플레이스 캐시되었든, --plugin-dir로 실행되었든 작동합니다.
PLUGIN_ROOT=""
for c in "$CLAUDE_PLUGIN_ROOT" "$HOME"/.claude/plugins/cache/hope/hope/*/ "$HOME/.claude/plugins/marketplaces/hope"; do
  [ -n "$c" ] && [ -f "${c%/}/plugin.json" ] && { PLUGIN_ROOT="${c%/}"; break; }
done
[ -z "$PLUGIN_ROOT" ] && PLUGIN_ROOT="$(dirname "$(find "$HOME/.claude/plugins" -path '*hope*/plugin.json' -print -quit 2>/dev/null)")"
echo "PLUGIN_ROOT=$PLUGIN_ROOT"   # 번들 파일을 읽기 전에 올바른지 확인

PLUGIN_ROOT이 비어 있으면, 상대 경로를 추측하지 말고 사용자에게 Hope 플러그인이 체크아웃된 위치(예: --plugin-dir 경로)를 물어보세요. 상대 경로 references/…는 사용자의 프로젝트 폴더를 기준으로 확인되어 404 오류가 발생합니다.

생성하기 전에 다음 파일들을 읽으세요. 이것들은 중요합니다. 디자인 토큰은 고정되어 있으며, 음성 규칙은 포트폴리오의 모든 단어에 적용됩니다:

cat "$PLUGIN_ROOT/references/design-tokens.md"
cat "$PLUGIN_ROOT/references/voice-guide.md"
cat "$PLUGIN_ROOT/references/career-graph-schema.md"
cat "$PLUGIN_ROOT/references/milestones.md"

이 스킬이 출력하는 것

career-graph/documents/portfolios/portfolio-<slug>-<date>/ 경로에 포트폴리오 폴더가 생성되며, 정확히 네 개의 명명된 파일이 포함됩니다:

  • index.html — 정적 SEO 태그가 적용된 셸: <head>(제목/설명/OG/트위터/강화된 JSON-LD/표준 URL/hope:share-url), 인라인 테마 초기화, 정적 .seo-fallback 본문 블록(이름/헤드라인/요약, 하이드레이션 시 제거됨), 정적 상단 표시줄 + 내보내기 모달, 빈 마운트 포인트. 여기에는 콘텐츠 마크업이 없습니다 — 표시되는 본문은 런타임에 portfolio.js가 window.HOPE_DATA로부터 렌더링합니다. 이 파일은 헤드 SEO 값과 hope:share-url 메타가 새겨지는 파일입니다.
  • portfolio.css — 전체 스타일시트; 디자인 토큰(:root)이 여기에 있으며 다른 곳에는 없습니다(15개 세그먼트 계층 / 카테고리 / 무결성 토큰 포함 — design-tokens 정전 참조).
  • portfolio.js — 전체 동작 스크립트 및 전체 런타임 렌더러 — window.HOPE_DATA로부터 전체 표시 가능한 <body>를 구축합니다.
  • data.js — 하나의 전역 변수 window.HOPE_DATA = {…}를 정의하는 클래식 스크립트: 전체 페이지에 대한 완전한 데이터셋(메타 + 신뢰도 맵, 신원, 개요, 경력, 프로젝트, 기술, 교육, 자격증, 이력서, 타임라인, 트래블러, 소셜), 의미론적 값만 — HEX 없음, 사진은 data: URL로 인코딩됩니다. 템플릿의 data.js는 전체 필드별 저작 계약(window.HOPE_DATA 스키마)을 전달합니다 — 내보내기 전에 읽고, 필드 유형과 선택 사항에 대한 진리의 원천으로 취급하십시오.

— 추가로 같은 폴더에 두 개의 공유 카드 페이지(share-card.html 및 share-card-square.html)가 포함됩니다 — 아래 "공유 카드 및 링크 프리뷰 메타"를 참조하세요.

자체 포함이라는 약속은 폴더 수준에서 적용됩니다: 폴더는 브라우저 외에는 아무것도 필요하지 않습니다 — 완전히 오프라인에서 작동 가능합니다. (열기: "표시" 단계 참조 — macOS에서는 한 줄짜리 로컬 서버가 신뢰할 수 있는 방법입니다; 더블 클릭은 일반적으로 작동하지만 폴더 권한에 의해 차단될 수 있습니다.) 이것이 법칙입니다 — 클래식 <script src> 및 <link rel="stylesheet">만 사용; type="module", fetch(), import는 없습니다. index.html에 인라인 <style>/<script>는 테마 초기화 스니펫(설계상 <head>에 인라인 — 테마 플래시 방지)과 JSON-LD를 제외하고는 없습니다. 어떤 파일에 무엇이 속하는지는 정전입니다 — design-tokens.md § "모듈 구조"(위에 로드됨); 인용하고, 다시 설명하지 마십시오. 페이지는 Hope의 디자인 토큰을 사용합니다 — 기본적으로 라이트 테마(따뜻한 크림 + 오렌지색)이며, 토글을 통해 다크 테마를 사용할 수 있고 두 테마 모두 동일한 레이아웃을 유지합니다 — 그래픽은 인라인 SVG로 생성되며, 네트워크 연결 없이 모든 브라우저에서 열립니다.

내부에 들어가는 내용:

  • 신원 카드 — 사진, 이름, 헤드라인, 통계 행, 연락처 행, 요약, 32×32 그리드 텍스처 위에 표시되며, 오른쪽 상단에 LIVE 알약이 있습니다.
  • 스루라인 — 신원 카드 하단의 애니메이션 경력 타임라인 스트립(id="throughline"): 포함된 각 경력 / 교육 / 프로젝트 / 자격증당 하나의 육각형 노드, 레일을 따라 이동하는 재생 헤드, 호버 미니 카드, 각 항목의 카드로 이동하는 클릭 탐색. 스트립의 모양과 움직임은 템플릿 소유입니다; 여러분의 작업은 데이터셋과 카드 앵커입니다 — 아래 "스루라인 — 타임라인 데이터 계약"을 참조하세요.
  • 개요 앱(옵트인) — 독립형 밴드가 아닌 섹션 그리드 탭: 그리드 타일(data-section="overview", "개요" 레이블, 아이콘 insights, 메타 카운트 "{n} highlights")과 함께 가장 먼저 위치하고 기본적으로 열리는 창(id="pane-overview"). 내부: 최대 4개의 큐레이션된 히어로 통계가 큰 육각형 배지로 표시되고 조용한 관심사 줄이 있습니다. overview.show가 true이고 overview.headline_stats가 비어 있지 않을 때만 렌더링됩니다 — 아래 "개요 앱 — 필드 매핑"을 참조하세요.
  • 요약 — Hope의 목소리로 2~4문장. 구체적이어야 하며 일반적이지 않아야 합니다. 해결 전의 긴장감을 암시해야 합니다.
  • 선택된 경력 — 가장 관련성 높은 3~5개의 경력을 카드로 표시: 각각 직함, 회사, 날짜, 한 문장 프레이밍, 가장 강력한 기여(STAR + 지표), 그리고 입증된 기술.
  • 선택된 프로젝트 — 정규 고용 외부에서 포트폴리오 가치가 있는 프로젝트에 대해 경력과 동일한 형식.
  • 기술 섹션 — 최고 기술(카테고리별로 구성, 가장 시장 수요가 높고 증거가 강력한 순서로). 각 기술 칩을 클릭하면 어떤 경력/프로젝트에서 입증되었는지 확장됩니다.
  • 교육 / 자격증 — 간결하고 사실적. 항목에 표시할 가치가 있는 명예나 성과(장학금, 상, 표창, 주목할 만한 논문)가 경력 파일에 있는 경우 리치 카드로 렌더링합니다 — 아래 "리치 교육 및 자격증 카드"를 참조하세요. 그렇지 않으면 기본 .edu-card를 사용합니다. 명예를 지어내지 마십시오; 있는 것만 렌더링하십시오.
  • 연락처 — 이메일과 LinkedIn, 그 이상은 없습니다. 선택 사항입니다.
  • 테마 토글 — 오른쪽 상단의 해/달 버튼; 라이트/다크를 전환하며, 레이아웃은 변경되지 않습니다.
  • 숨겨진 이력서 보기 — #resume-view, 화면에는 보이지 않으며, 이력서 인쇄 경로를 위해 런타임에 resume에서 렌더링됩니다(아래 "이력서 보기 — 필드 매핑" 참조).
  • 내보내기 및 공유 컨트롤 — 템플릿의 PDF로 저장 버튼은 이력서를 내보냅니다: 스타일 + 글꼴 + 맞춤을 위한 선택기(#export-modal)로, 엄격한 가독성 기준 — 본문 텍스트는 절대 10pt 미만으로 떨어지지 않습니다. 포트폴리오 PDF 선택기는 다음 릴리스를 위해 차단되어 있습니다 — 라이브 페이지 자체가 포트폴리오이며, Cmd+P는 여전히 기본적으로 인쇄합니다. 공유는 Copy link / LinkedIn / X / WhatsApp / Email 메뉴(#share-menu)를 엽니다. 이것들은 템플릿에 포함되어 있습니다; 여러분의 작업은 이것들이 의존하는 콘텐츠(이력서 보기, OG 메타, 공유 카드)입니다.

무엇을 넣을지 선택하는 방법

사용자의 경력 그래프를 읽으십시오. 대상 직무가 명명된 경우(hope make portfolio for Anthropic), JobPosting 노드를 찾아 다음을 수행하십시오:

  1. 직무가 REQUIRES_SKILL 관계를 가진 기술과 사람이 HAS_SKILL 관계를 가진 기술을 계산하십시오.
  2. USED_SKILL 및 APPLIED_SKILL 에지가 직무의 요구 기술과 가장 강하게 교차하는 경력/프로젝트를 선택하십시오.
  3. 순서: 가장 관련성 높은 순, 가장 최근 순, 가장 지표가 많은 순.
  4. 밀도, 완전성이 아닙니다를 목표로 하십시오. 세 개의 훌륭한 카드가 일곱 개의 괜찮은 카드보다 낫습니다.

대상 직무가 명명되지 않은 경우, 사용자의 가장 강력한 작업을 전체적으로 대표하는 일반 포트폴리오를 생성하십시오.

어느 쪽이든, 그래프에 포함된 경력/기술/프로젝트에 연결되는 CuratedPortfolio 노드를 생성하고, 사용자의 앱 카탈로그 결정을 "show_summary": true|false, "show_social": true|false로 기록하고, 트래블러 선택을 "timeline_traveler"로 기록하십시오(아래 앱 카탈로그 및 트래블러 선택기 참조 — 사람의 사실이 아닌 포트폴리오별 프레젠테이션 선택). 이는 사용자의 그래프가 어떤 역할에 어떤 큐레이션이 사용되었는지 기억한다는 것을 의미합니다.

포트폴리오 카피의 음성

Hope는 사용자에 대한 사실을 절대 지어내지 않습니다. 여러분이 작성하는 모든 줄 — 글머리 기호, 성적, 계획, 주장 — 은 경력 파일 또는 이 채팅에서 사용자의 자신의 말로 거슬러 올라갈 수 있어야 합니다; 출처를 댈 수 없는 주장은 하지 않는 주장입니다. 이것은 Hope 사이트에 명시된 약속이며, 모든 스킬이 이를 지킵니다.

여러분은 이력서를 작성하는 것이 아닙니다. 여러분은 Hope의 목소리로 디자이너의 업무 진술서를 작성하고 있습니다.

각 경력 카드는 다음을 따라야 합니다:

  • 직무 요약이 아닌 특정 순간이나 문제로 시작
  • 사용자의 행동으로 인해 무엇이 바뀌었는지(지표와 함께) 보여주기
  • "~을 담당했습니다"와 같은 표현 피하기 — 말하지 말고 보여주기
  • 카드당 60~120단어, 그 이상은 안 됨

예시 변환:

❌ "Figma의 선임 제품 디자이너. 디자인 시스템, 주니어 디자이너 멘토링, 교차 기능 이니셔티브 주도 담당."

✅ "2023년 Figma의 디자인 시스템이 제품 팀 전체에 분열되기 시작했을 때, 제가 통합을 주도했습니다. 8개월 후, 회사 표면의 37%가 새 시스템으로 통합되었고, 신입 디자이너의 온보딩 시간이 3주에서 1주로 단축되었습니다. 어려운 부분은 컴포넌트가 아니었습니다 — 열두 개의 제품 팀이 하나의 버튼에 동의하도록 하는 것이었습니다."

사용자가 편집할 수 있지만, 첫 번째 초안은 Hope가 작성한 것처럼 느껴져야 합니다.

시각적 품질 기준

이것은 가시적인 차별화 요소입니다. 포트폴리오는 명백히 Hope 아티팩트처럼 보여야 합니다 — 레이아웃과 텍스처가 브랜드이고, 색상이 테마입니다:

  • 기본 라이트 테마(따뜻한 크림 + 오렌지색). 토글을 통한 다크 테마, 동일한 레이아웃.
  • 인터랙티브 섹션 그리드 — 섹션을 클릭하면 아래 콘텐츠가 필터링됩니다; 활성 탭은 단색 오렌지색이며 글로우와 무결성 막대가 있습니다.
  • 각 역할에 대한 육각형 KPI 배지(사람 / 그룹 / 모니터링).
  • 기여 카드가 IC 대 리더십으로 그룹화됨; 기술은 카테고리별로 그룹화되고 4단계 수준 시각화가 있음; 프로젝트는 확장 가능한 경력 스타일 .item-card(아래 프로젝트 루프 계약 참조)로 렌더링되어 각 프로젝트의 전체 이야기를 보여줌.
  • 신원 행 내부, 오른쪽 상단의 LIVE 알약.
  • 카드의 스캔라인 오버레이 + 신원 헤더의 32×32 그리드 텍스처 + 미묘한 글로우. 이러한 텍스처는 시그니처입니다 — 없으면 디자인이 평범해 보입니다.
  • 텍스트용 Inter, 모든 메타데이터용 JetBrains Mono. 인라인 SVG 폴백이 있는 Material Symbols Rounded.
  • Google Favicon을 통한 실제 조직 로고와 문자 마크 폴백.
  • 폴더 수준에서 자체 포함됨(위 "이 스킬이 출력하는 것" 참조). 선택적 Google Fonts를 제외한 필수 네트워크 호출 없음(차단 시 시스템 폰트로 대체됨).

시작 구조로 번들 템플릿을 사용하십시오 — 출력 폴더를 미러링하는 폴더입니다(동일한 네 개의 명명된 파일). 위에서 확인한 플러그인 루트에서 로드하십시오:

ls "$PLUGIN_ROOT/assets/templates/portfolio/"          # index.html · portfolio.css · portfolio.js · data.js
cat "$PLUGIN_ROOT/assets/templates/portfolio/index.html"  # 정적 셸: SEO 태그가 적용된 헤드, .seo-fallback, 빈 마운트
cat "$PLUGIN_ROOT/assets/templates/portfolio/data.js"     # window.HOPE_DATA 저작 계약 포함

빌드 계약 (런타임 데이터 기반)

포트폴리오는 정적 마크업에 토큰을 대체하여 빌드되지 않습니다. 에이전트는 하나의 구조화된 데이터셋을 내보내고, 제공된 portfolio.js가 런타임에 전체 표시 가능한 <body>를 렌더링합니다. 새 템플릿에는 {{…}} 콘텐츠 토큰이나 <!-- HOPE:*_loop --> 마커가 없습니다 — 이들은 window.HOPE_DATA로 대체되었습니다. 다음 단계를 순서대로 따르십시오:

  1. 그래프에서 큐레이션(아래 "무엇을 넣을지 선택하는 방법" 참조): 신원, 개요, 경력(IC/리더십 그룹화, 역할 진행 형태), 프로젝트, 기술(카테고리별, 레벨 1~4 + 연차), 교육, 자격증, 이력서(글머리 기호에 tag 추가, 교육 = 학위만), 타임라인, 소셜, 그리고 섹션별 confidence 맵.
  2. data.js 내보내기 = window.HOPE_DATA = {…} — 하나의 전역 변수, 전체 페이지에 대한 완전한 데이터셋(템플릿의 data.js 저작 계약이 window.HOPE_DATA 스키마입니다). 의미론적 값만 — HEX 없음(category:"programming", level:4, confidence.band:"high" — portfolio.js가 렌더 시 이를 var(--token)으로 확인합니다). 사진은 identity.photo의 data: URL로 인코딩됩니다.
  3. portfolio.css와 portfolio.js를 출력 폴더에 그대로 복사하십시오. portfolio.css에는 이미 렌더러가 확인하는 15개 세그먼트 계층 / 카테고리 / 무결성 토큰이 포함되어 있습니다. portfolio.js는 런타임 렌더러입니다. 둘 중 어느 것도 포트폴리오별로 편집되지 않습니다. $PLUGIN_ROOT/references/design-tokens.md(위에 로드됨)의 디자인 토큰에서 벗어나지 마십시오.
  4. 셸 index.html을 data.js에 넣은 것과 동일한 meta로 한 번에 스탬프하십시오 — data.js는 단일 진리의 원천이며 헤드와 본문이 이로부터 스탬프됩니다:
    • 헤드: name/headline/og_description → <title> + description + og:*/twitter:*; share_url → hope:share-url + <link rel="canonical">; generation_date + 강화된 ProfilePage JSON-LD(description/url/image/sameAs); target_company → 제목 접미사.
    • 본문: 정적 .seo-fallback 블록 — name / headline / summary_short.
    • og:url / og:image / twitter:image는 비워 두십시오(content="") — 게시 스킬이 스탬프하도록. {{…}}가 어디에도 남아 있지 않아야 합니다.
  5. 두 개의 공유 카드 페이지를 생성하십시오 (share-card.html & share-card-square.html, 아래 공유 카드 섹션 참조).

⚠️ window.HOPE_DATA는 템플릿의 data.js에 정의된 정확한 스키마를 따라야 합니다. 필드 이름, 유형, 중첩을 일치시키지 않으면 런타임 렌더러가 깨집니다. 템플릿의 data.js를 읽고, 모방하고, 채우십시오 — 재정의하지 마십시오.

공유 카드 및 링크 프리뷰 메타

...

(참고: 원본 내용이 잘려서 여기까지 번역되었습니다. 전체 내용은 share-card.html, share-card-square.html 생성 및 OG 메타 처리에 대한 지침으로 이어집니다.)


표시 (macOS)

생성 후에는 포트폴리오를 표시하는 것이 좋지만 필수는 아닙니다. 사용자가 확인하고 피드백을 제공하며 추가 변경을 요청할 수 있습니다. "완료"가 아닙니다.

cd "$OUTPUT_DIR" && python3 -m http.server 8080

그런 다음 http://localhost:8080에서 확인하라는 메시지를 표시하거나, 표시하지 않으려면 건너뛰십시오.

Hope 포트폴리오는 브라우저만 있으면 완전히 작동하지만, 로컬 HTTP 서버를 통해 제공하는 것이 신뢰할 수 있습니다(로컬 파일 프로토콜은 file://의 CORS 정책으로 인해 portfolio.js에서 portfolio.css를 로드하지 못할 수 있습니다).

템플릿 데이터 계약

data.js 템플릿 파일에는 window.HOPE_DATA 스키마가 포함되어 있습니다. 다음 필드 맵을 문서로 참조하십시오:

  • meta: name, headline, og_description, share_url, generation_date, target_company
  • identity: photo(data URL), name, headline, stats(배열), contact(객체), summary
  • overview: show(boolean), headline_stats(배열, 각 {label, value, icon}), interests(문자열)
  • experience: ic(배열), leadership(배열), 각각 {id, title, company, dates, frame, contribution(star + metric), skills[]}
  • projects: {id, title, dates, frame, contribution, skills[]}
  • skills: {category, skills[{name, level(1-4), years, evidence[{type, id}]}]}
  • education: {degree, institution, year, honors?}
  • certifications: {name, issuer, year}
  • resume: {sections[{heading, bullets[{text, tag}]}]}
  • timeline: {entries[{type, id, date, label}]}
  • social: {linkedin?, email?, github?}
  • confidence: {identity, experience, skills, projects, education, certifications, resume} (각 band: "high"|"medium"|"low")

최종 검증

완료하기 전에 다음을 확인하십시오:

  1. 모든 파일(index.html, portfolio.css, portfolio.js, data.js, share-card.html, share-card-square.html)이 존재합니다.
  2. data.js의 모든 데이터가 그래프 또는 채팅에서 비롯된 것입니다(지어낸 사실 없음).
  3. index.html의 헤드가 data.js의 meta와 일치합니다. og:url, og:image, twitter:image는 비어 있습니다.
  4. .seo-fallback 블록에 올바른 이름, 헤드라인, 요약이 포함되어 있습니다.
  5. portfolio.js 또는 portfolio.css가 수정되지 않았습니다(그대로 복사됨).
  6. 디자인 토큰이 템플릿과 일치합니다(:root 변수 확인).
  7. 모든 링크와 리소스가 상대 경로를 사용하며 네트워크 호출이 없습니다(선택적 Google Fonts 제외).

관련 스킬