Communitygithub.com

donotdonuts/claude-workflow-skills

donotdonuts.github.io 템플릿을 기반으로 개인 포트폴리오 웹사이트를 생성합니다. 사용자의 이름, 사진, 이력서, 소셜 URL 및 시각적 스타일 선호도를 수집하여 타임라인/프로젝트 카드/챗봇 지식을 생성하고 일치하는 색상 팔레트를 적용합니다. Cloudflare Worker 뒤에서 작동하는 선택적 DeepSeek 챗봇을 제공합니다. 사용자가 봇 이름을 정하면 에이전트가 어울리는 이모지 아바타를 제안합니다. GitHub Pages에 정적으로 배포됩니다. 사용자가 이 아키텍처에서 자신만의 포트폴리오를 구축하려 할 때 사용하세요.

claude-workflow-skills란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 사용자를 위해 개인 포트폴리오 웹사이트를 처음부터 끝까지 완전히 설정하도록 안내합니다. `donotdonuts.github.io` 템플릿을 기반으로 하며, 정적 사이트 생성기나 번들러 없이 단일 페이지로 구성됩니다. GitHub Pages를 통해 `https://<사용자이름>.github.io` 주소로 배포됩니다. 에이전트는 사용자로부터 GitHub 사용자 이름, 표시 이름, 위치, 태그라인, 이력서, 사진, 소셜 URL 및 시각적 스타일(참조 URL 또는 설명)을 수집합니다. 수집된 정보를 바탕으로 타임라인과 프로젝트 카드를 이력서에서 자동 생성하고, 사용자가 선택한 색상 팔레트와 폰트를 적용합니다. 선택적으로 Cloudflare Worker와 DeepSeek API를 기반으로 한 챗봇을 추가할 수 있으며, 사용자가 봇 이름과 이모지 아바타를 선택하면 에이전트가 코드에 이를 반영합니다. 스킬은 SKILL.md 문서에 명시된 단계별 지침을 따르며, 터미널 명령어, 파일 편집, 색상 추출 및 적용, 이력서 파싱 등의 작업을 자동화합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/donotdonuts/claude-workflow-skills/tree/HEAD/skills/random-skills/personal-site-setup

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

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

문서

개인 사이트 설정

새 사용자가 https://<사용자이름>.github.io에 자신의 포트폴리오를 배포하는 과정을 안내합니다. 아키텍처는 고정되어 있지만, 외관, 텍스트, 챗봇 페르소나는 모두 특정 사용자에 맞게 커스터마이징됩니다.

제공되는 기능

  • 단일 페이지 정적 사이트, 번들러 없음. GitHub Pages가 main 브랜치를 리포지토리 루트에서 제공합니다.
  • 히어로 섹션 — 초상화 + 이름 + 한 줄 위치 + 한 줄 태그라인.
  • 프로젝트 섹션 — 섹션 헤드에 흐릿한 세로 타임라인(작업 항목에는 렌치 아이콘, 교육 항목에는 책 아이콘, 사이드 프로젝트에는 반짝이 아이콘; 각 항목은 회사, 직위, 날짜, 위치를 표시)과 본문에 프로젝트 카드 그리드가 있습니다. 둘 다 사용자 이력서에서 생성됩니다.
  • 타임라인 ↔ 카드 필터 — 타임라인 항목에 마우스를 올리거나 키보드 포커스를 주면 관련 없는 프로젝트 카드가 숨겨집니다. 클릭하면 필터가 고정되고(다시 클릭하면 해제)됩니다. 최소 하나의 카드와 연결된 항목만 상호작용 가능하며, 나머지는 비활성 상태로 유지됩니다.
  • 접힌 카드 — 각 프로젝트 카드는 기본적으로 카테고리 + 제목 + 도구 태그만 표시합니다. 마우스를 올리거나 포커스하면 요약 단락과 지표 행이 나타나 그리드의 스캔 가능성을 유지합니다.
  • 챗봇 (선택 사항) — Cloudflare Worker 뒤에서 DeepSeek의 OpenAI 호환 API를 사용하는 오른쪽 하단 플로팅 런처 + 팝아웃 패널(인라인 페이지 섹션이 아님)입니다. Worker가 API 키를 보관합니다. 사용자가 봇 이름을 정하면 에이전트가 어울리는 이모지 아바타를 제안합니다. 봇 응답은 마크다운을 렌더링합니다. 2계층 속도 제한이 있습니다.
  • 연락처 섹션 — 이메일 + 사용자의 소셜 URL.

전제 조건

필요한 항목도구설치 방법
모든 것git일반적으로 이미 설치되어 있음
모든 것GitHub 계정 + gh CLIbrew install gh 후 gh auth login
모든 것python3 (로컬 미리보기)일반적으로 이미 설치되어 있음
챗봇Cloudflare 계정 (무료 티어)https://dash.cloudflare.com
챗봇wrangler CLInpm install -g wrangler 후 wrangler login
챗봇DeepSeek API 키https://platform.deepseek.com/ → API keys
초상화 조정Node.jsbrew install node

단계별 가이드

1. 사용자로부터 입력 수집

파일을 건드리기 전에 수행하십시오. 모든 것을 한 번에 수집하여 이후 단계에서 자동 편집이 가능하도록 합니다. 객관식 질문에는 AskUserQuestion을, 자유 텍스트에는 직접 프롬프트를 사용합니다.

사용자로부터 다음 항목을 수집합니다:

입력 항목질문 방법예시
GitHub 사용자 이름직접 질문jane (리포지토리는 jane.github.io가 됩니다)
표시 이름직접 질문Jane Doe 또는 Jane "JD" Doe
위치 문구직접 질문, 짧게NYC metropolitan, Remote, Tokyo
태그라인직접 질문, 한 문장I build ML systems and love shipping.
이력서텍스트 붙여넣기 또는 파일 경로전체 이력서 — 타임라인, 프로젝트 카드, 챗봇 지식을 채우는 데 사용됨
사진디스크의 정사각형 이미지 경로/Users/jane/Desktop/headshot.jpg. 사용자는 클론 후 리포지토리 루트에 raw.jpg로 복사할 수 있음
소셜 URL직접 질문, 각각 선택 사항LinkedIn / GitHub 프로필 / Medium / 개인 이메일
챗봇 여부?AskUserQuestion예 / 아니요
챗봇 이름 (예인 경우)직접 질문Pot, Nova, Echo 등
시각적 스타일AskUserQuestion"마음에 드는 URL을 붙여넣기" 또는 "글로 설명하기"

챗봇 이름을 수집한 후, 주제와 일치하는 2~3개의 이모지 아바타를 제안하고 사용자가 선택하도록 합니다. 예시:

이름제안 아바타
Pot🫖 (찻주전자) · 🍲 · 🎨
Nova🌟 · 💫 · 🌠
Echo📣 · 🔊 · 🌀
Ember🔥 · 🪵 · ✨
Atlas🗺️ · 🧭 · 🌍
Bit💾 · 🔢 · 🤖
Sage🌿 · 📖 · 🦉

명확하게 맞는 것이 없으면 중립적인 것(🤖, 💬, 🪄)을 제안합니다. 선택한 이모지와 이름을 저장합니다. 나중에 코드에 작성할 것입니다.

2. GitHub 리포지토리 생성

gh repo create <사용자이름>.github.io --public --description "Personal website"

GitHub Pages 사용자 사이트는 반드시 <사용자이름>.github.io여야 합니다.

3. 템플릿 클론

git clone https://github.com/donotdonuts/donotdonuts.github.io my-site
cd my-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<사용자이름>/<사용자이름>.github.io.git

4. 시각적 스타일 선택

템플릿은 기본적으로 크림색 + IBM Plex Mono 미학을 사용합니다. 1단계에서 사용자의 답변을 기반으로 덮어씁니다.

4a. 사용자가 URL을 제공한 경우

페이지의 CSS를 가져와 토큰을 추출합니다:

curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<css-경로>" -o /tmp/ref-1.css

# body에 실제로 적용된 글꼴
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# 모든 CSS 사용자 정의 속성 정의
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60

찾을 항목: 배경 hex, 전경/잉크 hex, 테두리 hex, 강조 색상 hex, body에 적용된 font-family, @font-face URL.

4b. 사용자가 설명을 제공한 경우

설명을 구체적인 토큰으로 변환합니다. 휴리스틱:

단어함축 의미
"minimal", "editorial", "paper"크림/오프화이트 배경, 진한 잉크, 얇은 구분선
"dark", "terminal", "IDE"거의 검은색 배경 (#0f1115), 밝은 잉크, 미묘한 회색 테두리
"warm", "analog"약간 노란 크림색 (#faf5e8), 갈색-검은색 잉크
"brutalist"순수 흰색 또는 순수 검은색, 2px 이상의 실선 테두리
"techy", "data"고정폭(IBM Plex Mono, JetBrains Mono), 차가운 회색
"magazine", "editorial"세리프(EB Garamond, Fraunces), 넉넉한 행간
"playful"하나의 채도 높은 강조색, 나머지는 차분하게

4c. 제안 및 적용

13개의 토큰 + 글꼴 스택을 컴파일합니다. 파일을 편집하기 전에 제안된 팔레트를 코드 블록으로 보여주고 승인을 받으십시오.

:root {
  --bg:             <hex>;   /* 페이지 배경 */
  --bg-soft:        <hex>;   /* 서브 패널 — 일반적으로 --bg를 --ink 쪽으로 ~3% 혼합 */
  --bg-hover:       <hex>;   /* 태그/칩 호버 */
  --card-bg:        <hex>;   /* 불투명 카드 채우기 (라이트 테마의 경우 흰색) */
  --ink:            <hex>;   /* 기본 텍스트 */
  --ink-soft:       <hex>;   /* --ink의 ~80% */
  --ink-mute:       <hex>;   /* ~60% */
  --ink-faint:      <hex>;   /* ~40% */
  --border:         <hex>;   /* 미묘한 구분선 */
  --border-strong:  <hex>;   /* 주요 구분선 */
  --up:             <hex>;   /* 긍정적 지표 (기본적으로 녹색 계열) */
  --down:           <hex>;   /* 부정적 지표 (기본적으로 빨간색 계열) */
  --accent-ink:     <hex>;   /* 링크 */
  --font-mono:      "<Family>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

그런 다음:

  1. css/styles.css를 열고 :root 블록을 찾아 값을 바꿉니다.
  2. index.html을 열고 <head>의 Google Fonts <link>를 새 글꼴 패밀리 + 두께로 업데이트합니다.

5. 이력서 및 입력에서 콘텐츠 생성

1단계의 이력서 및 기타 입력을 사용하여 index.html을 채웁니다:

  1. <head> — <title> = <표시 이름> — <이력서의 첫 번째 직위>; <meta name="description">은 태그라인에서 가져옵니다.

  2. 히어로 섹션:

    • <h1 class="hero-title"> ← 표시 이름
    • <p class="hero-location"> ← 위치 문구
    • <p class="hero-tagline"> ← 태그라인
  3. 타임라인 — 이력서를 분석하여 항목으로 만듭니다. 각 직위, 학위, 그리고 사용자가 표시하려는 진행 중인 개인 사이드 프로젝트 카테고리당 하나의 <li class="tl-stop">을 만듭니다. 순서는 현재 → 과거 (DOM에서 위에서 아래로). 각 항목에 짧은 data-experience 슬러그를 선택합니다(예: mars, vibe, coach, gatech) — 필터가 항목을 카드에 연결하는 데 사용됩니다. 최소 하나의 연결된 프로젝트 카드가 있는 항목에만 tabindex="0"을 추가합니다(나머지는 비활성 상태로 유지).

    <li class="tl-stop tl-stop-work" data-experience="<슬러그>" tabindex="0">
      <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe (하나 선택) -->
      <svg class="tl-icon tl-icon-work" aria-hidden="true">
        <use href="#icon-wrench"/>       <!-- #icon-wrench | #icon-book | #icon-sparkle -->
      </svg>
      <div class="tl-info">
        <strong>회사 / 학교</strong>
        <span>직위 / 학위</span>
        <em>시작 — 종료</em>
        <i class="tl-loc">도시, 주</i>
      </div>
    </li>
    

    프로젝트 카드와 연결되지 않은 교육/과거 직위 항목에서는 tabindex="0"을 제거합니다. js/main.js가 로드 시 이를 자동 감지하여 비활성 상태로 둡니다.

  4. 프로젝트 — 이력서의 주목할 만한 프로젝트/성과에서 생성된 약 6개의 <article class="project-card"> 블록. 각 카드는 연결된 항목과 일치하는 data-experience 슬러그를 반드시 가져야 합니다. 그렇지 않으면 필터에 참여하지 않습니다:

    <article class="project-card" data-experience="<슬러그>">
      <header class="project-head">
        <span class="project-tag">카테고리</span>
        <h3>프로젝트 제목</h3>
      </header>
      <p>이력서 항목에서 가져온 1-2 문장 요약.</p>
      <dl class="project-metrics">
        <div><dt>지표</dt><dd class="up">+값</dd></div>
        <div><dt>지표</dt><dd>값</dd></div>
      </dl>
      <ul class="tag-list small"><li>도구</li><li>도구</li></ul>
    </article>
    

    지표에 색상을 지정하려면 <dd class="up"> / <dd class="down">을 사용합니다. 카드는 기본적으로 접힌 상태로 렌더링됩니다. 마우스를 올리거나 포커스될 때까지 태그, 제목, 도구 태그만 보이고 요약과 지표가 나타납니다. 요약을 간결하게 유지하세요. 호버에 대한 보상으로만 존재합니다.

  5. 채팅 인사말 — 봇의 첫 메시지는 index.html의 #chat-panel 내부에 인라인 HTML로 포함됩니다(패널의 <div class="chat-log"> 내부). 따라서 사용자가 팝아웃을 처음 열 때 즉시 렌더링됩니다. 선택한 봇 이름 + 아바타 이모지를 사용하여 다시 작성합니다. 형식:

    <div class="chat-msg chat-msg-bot">
      <span class="chat-avatar" aria-label="<봇 이름>">EMOJI</span>
      <div class="chat-bubble">
        <p>안녕하세요, 저는 <strong><봇 이름></strong>입니다 — <표시 이름>의 AI 어시스턴트로, <그/그녀>의 이력서에서 <동사>되었습니다.</p>
        <p>저에게 물어보세요:</p>
        <ul>
          <li>회사 / 직위</li>
          <li>방법론 / 접근 방식</li>
          <li>프로젝트 / 기술 / 학력</li>
        </ul>
        <p>무엇을 알고 싶으신가요?</p>
      </div>
    </div>
    
  6. 연락처 — 이메일 + 제공된 각 소셜 URL을 .connect-list의 <li>로 추가합니다. 제공되지 않은 플랫폼의 행은 삭제합니다.

6. 초상화 추가

사진 위치를 묻습니다. 리포지토리 루트에 raw.jpg로 복사한 후 크기를 조정합니다:

cp <사용자-사진-경로> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg

사진 배경이 새 --bg와 일치하지 않으면 번들 스크립트로 조정합니다:

cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <이-스킬-디렉토리>/scripts/shift-portrait.js \
  /path/to/my-site/raw.jpg \
  /path/to/my-site/assets/portrait.jpg \
  "#<your-bg-hex>"

세 번째 인수를 생략하면 기본값은 #fbf7eb입니다. raw.jpg는 gitignored됩니다.

7. 챗봇 구성 (사용자가 '아니요'라고 하면 건너뜁니다)

7a. Worker

cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY

worker/wrangler.toml:

ALLOWED_ORIGIN = "https://<사용자이름>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL          = "deepseek-chat"

worker/worker.js → SYSTEM_PROMPT — 사용자 이력서에서 다시 작성합니다. 섹션 구조(소개 / 현재 역할 / 이전 역할 / 학력 / 도구 상자)를 유지합니다. 또한 봇 이름 + 아바타를 사용하여 여는 페르소나 문장을 다시 작성합니다:

const SYSTEM_PROMPT = `당신은 "<봇 이름>" <EMOJI>입니다 — <표시 이름>의 개인 웹사이트에 포함된 친절하고 간결한 AI 어시스턴트입니다. …`;

배포:

wrangler deploy

7b. 클라이언트

js/config.js:

window.SITE_CONFIG = {
  chatWorkerUrl: "https://<worker>.workers.dev",
};

js/chatbot.js — 상단의 상수를 업데이트합니다:

const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<봇 이름>";

8. 미리보기 + 푸시

python3 -m http.server 8000       # http://localhost:8000

모든 섹션을 클릭하여 확인합니다. 채팅을 테스트합니다. 모바일 너비로 크기를 조정합니다. 그런 다음:

git add .
git commit -m "initial: personal site"
git push -u origin main

약 60초 내에 https://<사용자이름>.github.io/에서 라이브로 확인됩니다.

템플릿 아키텍처 (변경하지 마십시오)

섹션 레이아웃

모든 섹션은 .section-grid: 280px 1fr을 사용합니다. 280px 열은 가장 긴 타임라인 레이블에 맞습니다. 모든 레이블이 짧으면 240px로 좁히고, 길면 320px로 넓힙니다.

타임라인

  • Projects section-head 내부, 제목 바로 아래에 위치하며 opacity: 0.45로 설정됩니다. 호버, 포커스 또는 활성 필터가 0.95로 높입니다.
  • DOM 순서 = 시각적 위에서 아래로 순서. 현재 → 과거. 시간에 비례하지 않으며 flex gap을 통해 균등하게 분포됩니다.
  • 기본적으로 세 가지 아이콘 종류가 있습니다: #icon-wrench (직장, .tl-stop-work), #icon-book (교육, .tl-stop-edu), #icon-sparkle (분위기/사이드 프로젝트, .tl-stop-vibe). 세 <symbol> 정의 모두 <header> 바로 뒤의 SVG 스프라이트에 있습니다. 새 아이콘 카테고리를 추가하려면:
    1. SVG 경로와 함께 <symbol id="icon-foo">를 추가합니다.
    2. .tl-icon-foo { color: var(--ink-mute); }를 추가합니다.
    3. <svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>로 참조합니다.
  • 각 항목은 data-experience="<슬러그>"를 전달합니다. 슬러그가 최소 하나의 프로젝트 카드와 일치하는 항목은 tabindex="0"도 가져서 js/main.js가 필터 상호작용을 가능하게 합니다.

프로젝트 필터 (클릭 + 호버)

전적으로 js/main.js에 의해 구동되며, 구성이 필요 없습니다. DOM을 로드 시 스캔하고 적용되는 곳에만 핸들러를 연결합니다.

  • 로드 시, data-experience 슬러그가 최소 하나의 .project-card에 있는 모든 항목은 .tl-stop-has-projects + role="button" + aria-pressed="false"를 얻습니다. 연결된 카드가 없는 항목은 비활성 상태로 유지됩니다.
  • 호버 / 포커스 상호작용 가능한 항목 → 임시 필터: 일치하지 않는 카드는 .is-dim이 됩니다(그리드에 .is-filtering이 추가되며, CSS는 이를 dim 처리된 카드에 display: none으로 변환합니다. 레이아웃에서 제거되고 단순히 희미해지지 않습니다).
  • 클릭 (또는 Enter / Space) → 잠금: 항목은 .is-locked, 완전 불투명도, 잉크 색상 아이콘, 밑줄 친 회사 이름을 얻습니다. 동일한 항목을 다시 클릭하면 해제되고, 다른 항목을 클릭하면 전환됩니다.
  • 잠겨 있는 동안 다른 항목을 호버하면 해당 카드를 미리보고, 레일에서 mouseleave(또는 레일에서 focusout)하면 잠긴 필터로 돌아갑니다.

프로젝트 카드

  • 각 카드에는 data-experience 속성이 필요합니다. 필터가 작동하려면 이 속성이 있어야 합니다.
  • 기본적으로 접혀 있습니다: CSS는 .project-card p, .project-card .project-metrics에 display: none을 적용하고, 카드 호버/포커스 시 표시합니다.
  • 지표는 선택 사항이지만 유용합니다. 2~3개의 지표를 목표로 하세요.
  • 도구 태그는 항상 표시됩니다.

챗봇 패널

  • index.html에서 #chat-panel은 display: none으로 시작합니다. #chat-launcher를 클릭하면 is-open 클래스가 전환됩니다.
  • 채팅 기록은 #chat-log <div>입니다. 새 메시지는 js/chatbot.js에 의해 추가됩니다.
  • Worker URL은 js/config.js에 있습니다. 빌드 단계가 없습니다.

반응형

  • 최대 48rem: 스택 레이아웃. 프로젝트 카드는 단일 열. 히어로는 세로로 쌓입니다.
  • 48rem 이상: 두 열 그리드. 히어로는 텍스트 + 사진 가로 배치.
  • 타임라인은 모든 뷰포트에서 가로로 유지되지만, 모바일에서는 더 작은 글꼴로 표시됩니다.

관련 스킬