Community코딩 & 개발github.com

byteTuto/website

로컬에서 byteTuto 사이트를 푸시 전에 검증합니다 - Docker 빌드, nginx 설정, 스모크 테스트, 보안 헤더 확인. site/, nginx/ 또는 Dockerfile 변경 후 사용합니다.

website란 무엇인가요?

이 스킬은 byteTuto 웹사이트를 로컬 환경에서 사전 검증하는 자동화된 테스트 스위트입니다. Docker 이미지를 빌드하고 nginx 설정을 검증한 후, healthz 엔드포인트, 메인 페이지 콘텐츠, 404 에러 처리, Content-Security-Policy와 X-Frame-Options 같은 보안 헤더, 마크다운 콘텐츠 타입 등 일련의 스모크 테스트를 수행합니다. 또한 SEO와 AI 에이전트 친화성을 확인하는 check_seo_agents.py 스크립트와 Playwright 기반 반응형 테스트(check_responsive.py)도 포함되어 있습니다. Claude Code, Cursor, Codex 등의 AI 코딩 어시스턴트와 함께 사용하도록 설계되었으며, site/, nginx/, Dockerfile 디렉토리의 변경 사항을 푸시하기 전에 반드시 실행해야 합니다. Dev 모드에서는 `docker compose -f docker-compose.dev.yml up`을 통해 수동 검사 항목(배경 애니메이션, 콘솔 오류, 반응형 캡처)도 확인합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byteTuto/website/tree/HEAD/.claude/skills/check-site

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

로컬 검증

순서대로 실행하고, 첫 번째 오류에서 멈춰서 수정합니다:

docker build -t bytetuto-site:local .
docker run --rm bytetuto-site:local nginx -t
docker rm -f bt-check 2>/dev/null; docker run -d --name bt-check -p 8088:80 bytetuto-site:local
sleep 2
curl -fsS http://localhost:8088/healthz                       # -> ok
curl -fsS http://localhost:8088/ | grep -c byteTuto           # > 0
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8088/x   # -> 404
curl -sI http://localhost:8088/ | grep -iE 'content-security|x-frame|cache-control'
curl -sI http://localhost:8088/index.md | grep -i 'content-type: text/markdown'
curl -s -H 'Accept: text/markdown' http://localhost:8088/ | head -3   # -> front matter ---
python3 scripts/check_seo_agents.py                            # SEO + 에이전트 친화성
python3 scripts/check_responsive.py --base http://localhost:8088 --shots /tmp/rs   # 반응형 (Playwright)
docker rm -f bt-check

Playwright는 처음 실행 시: pip install playwright && python3 -m playwright install chromium.

셸 스크립트: bash -n deploy/*.sh nginx/*.sh (그리고 shellcheck가 설치되어 있다면 함께 실행).

육안 검사 항목 (dev: docker compose -f docker-compose.dev.yml up → http://localhost:8080)

  • 배경 애니메이션이 끊김 없이 부드럽게 돌아가고, 감소된 움직임 설정이 활성화되면 멈춥니다.
  • 콘솔에 오류가 없습니다(CSP가 모든 인라인 스크립트를 차단하므로 JS는 site/app.js에 있어야 함).
  • /tmp/rs/*-320x640.png 및 *-375x667.png 캡처: 잘린 부분이나 모서리에 붙은 내용이 없어야 함.
  • 브랜드 가이드라인을 준수합니다 (bytetuto-brand 스킬 참조).

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬