Communitygithub.com

수상급 포트폴리오 3단계: SEO와 소셜 카드 다듬기

정적 개인 사이트나 포트폴리오/이력서 사이트를 다듬습니다. 소셜 미리보기 카드, SEO 메타데이터, JSON-LD 구조화 데이터, robots·sitemap·llms.txt 파일, 다국어 페이지, 시각 효과 접근성.

수상급 포트폴리오 3단계: SEO와 소셜 카드 다듬기란 무엇인가요?

수상급 포트폴리오 레시피 3단계(출시 전 마무리). 실제 개인 사이트에서 추출한 이 Codex 스킬은 포트폴리오가 검색되고 공유되도록 하는 세부 체크리스트를 에이전트에게 줍니다. Open Graph 카드, 인물과 프로젝트 구조화 데이터, sitemap, robots, AI 검색용 llms.txt, 다국어 정적 페이지, 접근성 있는 모션.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chicoxyzzy/chicoxyzzy.github.io/tree/HEAD/.codex/skills/personal-site-craft

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

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

문서

개인 사이트 크래프트

이 스킬을 사용하여 개인 웹사이트를 깔끔하게 유지하고, 발견 가능하게 하며, 접근성을 보장하고, 인간용 페이지, 소셜 미리보기, 검색 메타데이터, 에이전트가 읽을 수 있는 요약, CV 출력에서 일관성을 유지하세요.

워크플로우

  1. 편집 전에 진실 공급원(source of truth)을 식별하세요.

    • 생성된 HTML보다는 소스 템플릿/스크립트를 선호하세요.
    • 지역화된 정적 페이지의 경우, 생성기나 로케일 테이블을 편집한 후 다시 생성하세요.
    • 소셜 미리보기 이미지의 경우, 벡터/소스 자산을 편집하고 래스터 출력을 다시 생성하세요.
  2. 콘텐츠 레이어의 일관성을 유지하세요.

    • 메인 페이지, 지역화된 페이지, CV, llms.txt, JSON-LD, 터미널 복사본, 레트로/이스터에그 복사본은 동일한 인물과 프로젝트를 설명해야 합니다.
    • 재미있는 표면은 재미있게 두되, 전문적인 메타데이터와 CV 복사본은 직접적으로 유지하세요.
    • 프로젝트/프로필 문구를 변경한 후에는 모든 생성된 파일과 소스 파일에서 이전 문구를 검색하세요.
  3. 코드와 브라우저에서 검증하세요.

    • 로컬 메타데이터/스키마 검사가 있을 경우 실행하세요.
    • 프론트엔드 변경 후, 특히 모바일, 언어 변형, 소셜 미리보기 자산, 고모션/시각 효과 표면에 대해 브라우저 스크린샷이나 DOM 검사를 사용하세요.
    • 모바일에서의 수평 오버플로우와 버튼, 프로젝트 행, 터미널 UI, CV에서 텍스트 잘림을 확인하세요.

참고 자료

태스크에 필요한 것만 읽으세요:

  • references/wording.md: 프로필, 프로젝트, 터미널, 레트로, CV 문구 스타일.
  • references/seo-social-preview.md: SEO, Open Graph, Twitter 카드, JSON-LD, 사이트맵, 로봇, llms.txt, 메타데이터 검증.
  • references/i18n.md: 정적 지역화, hreflang, 언어 감지, 기계 번역 회피.
  • references/a11y.md: 시각, 터미널, WebGL/캔버스, 테마, 레트로 UI를 위한 접근성 관행.
  • references/cv-html-pdf.md: HTML CV 진실 공급원 및 PDF 생성 워크플로우.

운영 규칙

  • 사용자가 작성한 변경 사항을 보존하세요. 광범위한 편집 전에 git status와 diff를 검사하세요.
  • SEO 장식을 추가하지 마세요. 키워드 채우기보다는 정확한 구조화 데이터와 가시 콘텐츠를 선호하세요.
  • 중요한 프로필 데이터를 JSON-LD에만 숨기지 마세요. 구조화 데이터는 페이지 가시 콘텐츠를 반영해야 합니다.
  • 생성기가 소유한 파일을 변경할 경우, 생성된 파일을 변경의 유일한 장소로 만들지 마세요.
  • 스킬 기반 편집을 범위 내로 유지하세요. 태스크가 요청하지 않는 한 관련 없는 리디자인, 팔레트 변경, 리팩터링을 피하세요.

관련 스킬