Communitygithub.com

zijieguo2003/blog-builder-skill

개인 블로그를 처음부터 빠르게 구축할 수 있도록 안내합니다. 프레임워크 선택(Hugo, Hexo, Astro, Next.js), 테마 설정, 프론트매터가 포함된 포스트 템플릿 생성, GitHub Pages / Vercel / Cloudflare Pages 배포, 전체 SEO 설정(사이트맵, robots.txt, 오픈 그래프, 표준 URL)을 다룹니다.

blog-builder-skill란 무엇인가요?

이 스킬은 사용자가 개인 블로그를 처음부터 구축하는 과정을 체계적으로 안내합니다. 사용자의 기술적 배경(비기술자, JS 개발자, Python 개발자 등)과 선호도를 파악하여 Hugo, Hexo, Astro, Next.js 중 최적의 프레임워크를 추천하고, 선택된 프레임워크에 맞는 참조 파일을 바탕으로 설치와 테마 설정을 도와줍니다. 또한 프론트매터가 포함된 포스트 템플릿을 생성하고, GitHub Actions 기반의 CI/CD 워크플로우를 제공하여 GitHub Pages, Vercel, Cloudflare Pages에 쉽게 배포할 수 있도록 지원합니다. SEO 구성 요소로는 사이트맵, robots.txt, 오픈 그래프 태그, 표준 URL을 실제 파일 콘텐츠와 함께 제공하여 검색 엔진 최적화를 완성합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 블로그 관련 요청 시 자동으로 트리거되도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

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

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

문서

블로그 빌더

사용자가 개인 블로그를 시작하는 것을 돕습니다. 프레임워크 선택부터 올바른 SEO 설정을 포함한 실시간 배포까지 전 과정을 안내합니다. 전체 범위: 프레임워크 선택 -> 테마 -> 포스트 템플릿 -> 배포 -> SEO.

워크플로우

1단계 -- 사용자 상황 파악

다음 사항을 질문하거나 컨텍스트에서 유추하세요:

  • 기술적 배경? (비기술자 / JS 개발자 / Python 개발자 등)
  • 새로 시작하는지, 기존 사이트가 있는지?
  • 선호하는 배포 대상: GitHub Pages, Vercel, Cloudflare Pages?
  • 콘텐츠 초점: 글쓰기, 포트폴리오, 튜토리얼 블로그, 문서?

2단계 -- 프레임워크 추천

상황추천
비기술자, 그냥 글만 쓰고 싶음Hugo -- JS 불필요, 빠름, 방대한 테마 라이브러리
이미 JS/TS 사용, 컴포넌트 제어 원함Astro -- 섬 아키텍처, 뛰어난 DX
테마 에코시스템 선호, Node에 익숙함Hexo -- 성숙한 플러그인 생태계
React 개발자, 완전한 제어 원함Next.js -- App Router + MDX

짧은 설명과 함께 추천을 제시하세요. 진행 전 확인을 받으세요.

3단계 -- 프레임워크 설정

해당 참조 파일을 읽고 사용자에게 설치 및 시작 테마 과정을 안내하세요:

프레임워크참조 파일
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

4단계 -- 포스트 템플릿 생성

완전한 프론트매터가 포함된 바로 사용 가능한 포스트 템플릿 파일을 생성하세요. assets/post-templates/ 디렉토리의 템플릿은 시작점입니다. 사용자의 선택한 테마와 선호도에 맞게 복사 및 수정하세요.

5단계 -- 배포

적절한 CI/CD 워크플로우를 위해 references/deployment.md를 읽으세요. 커밋할 준비가 된 완전한 GitHub Actions YAML을 제공하세요.

주요 참고 사항:

  • GitHub Pages: .github/workflows/deploy.yml에 푸시; 저장소 설정에서 Pages 활성화
  • Vercel: 대시보드에서 저장소 연결; 프레임워크 프리셋과 출력 디렉토리 설정
  • Cloudflare Pages: 빌드 명령어 = npm run build, 출력 디렉토리 = dist (Astro/Hexo/Next.js) 또는 public (Hugo)

6단계 -- SEO 설정

모든 블로그에 필요한 항목:

  1. sitemap.xml -- 프레임워크별 참조; references/<framework>.md 참고
  2. robots.txt -- 설명이 아닌 실제 파일 내용 제공
  3. 오픈 그래프 태그 -- og:title, og:description, og:image, og:url을 실제 마크업으로 제공
  4. 표준 URL -- sitemap과 OG 태그가 올바르게 작동하도록 config에 baseURL / site 설정

항상 주의: 사이트맵이 올바른 절대 URL을 생성하려면 사이트 URL이 프레임워크 설정에 반드시 설정되어 있어야 합니다.

가이드 원칙

  • 설명이 아닌 실제 파일 콘텐츠(코드, YAML, TOML)를 제공하세요.
  • 중요한 필드만 포함하고 불필요한 보일러플레이트는 피하세요.
  • 사람들이 자주 실수하는 한두 가지 함정(예: Hugo baseURL, Astro site 필드)을 지적하세요.
  • 복사-붙여넣기 가능한 예제를 선호하세요.

관련 스킬