Community라이팅 & 에디팅github.com

umairmsm/wp-seo

워드프레스 사이트 키트 빌드의 5단계 – 제목과 설명, 정식 URL, 하나의 스키마 소유자와 JSON-LD, 사이트맵, robots.txt 및 llms.txt, AI 크롤러 접근 제어, 리디렉션(301 vs 302), 레거시 URL 맵, Search Console, 그리고 Polylang을 통한 파일럿 단계별 언어 추가(hreflang, .po/.mo 문자열, 네이티브 검토)를 다룹니다. 'SEO', 'schema', 'redirect', 'old URLs', 'translate the site', 'add French/Spanish', 'hreflang', 'canonical'에 사용하세요.

wp-seo란 무엇인가요?

이 스킬은 WordPress 사이트의 SEO(검색 엔진 최적화)와 다국어 지원을 자동화하는 단계별 가이드입니다. Rank Math SEO 플러그인을 기본 SEO 도구로 사용하여 각 페이지의 제목과 메타 설명, 정식 URL(canonical), 사이트맵, robots.txt, llms.txt를 설정하고, Google Search Console 및 Bing Webmaster Tools와의 연동을 처리합니다. 또한 Polylang을 통해 새로운 언어를 파일럿 단계로 추가하며, hreflang 태그, .po/.mo 번역 문자열, 네이티브 스피커 검토 프로세스까지 포함합니다. 이 스킬은 워드프레스 기반 프로젝트에서 Claude Code, Cursor, Codex와 같은 AI 에이전트와 함께 사용하도록 설계되었으며, SEO 테스트 통과, 리디렉션 규칙 적용, 레거시 URL 매핑 등 모든 단계가 명확한 게이트 체크리스트로 관리됩니다. 특히 이전에 배송된 버그(번역된 홈페이지의 정식 URL 오류, 영어 JSON-LD가 프랑스어 페이지에 포함되는 문제, 301 리디렉션 게이트 실수)를 방지하는 예방 조치도 포함하고 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umairmsm/wp-site-kit/tree/HEAD/skills/wp-seo

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

5단계: SEO 및 언어

목표: 검색 엔진과 AI 어시스턴트가 모든 페이지를 이해합니다. 이전 URL은 올바른 위치로 이동합니다. 각 추가 언어는 원본만큼 정확합니다.

SEO 단계

  1. 작업당 한 명의 소유자.
    • SEO 플러그인(기본값: Rank Math)이 제목, 메타, 사이트맵 및 기본 스키마 그래프를 소유합니다.
    • 코어의 schema.php는 사이트 자체 유형을 해당 그래프에 추가합니다.
    • 자체 스키마를 출력하는 도메인 플러그인은 침묵시켜, 서로 다른 두 개의 그래프가 아닌 하나의 그래프만 유지합니다.
  2. tests/helpers/site.ts의 모든 페이지가 npm run test:seo를 통과합니다:
    • 제목 10–65자;
    • 설명 50–160자;
    • 절대 정식 URL;
    • 하나의 H1;
    • lang 속성;
    • Google Fonts 요청 없음. 체크리스트 및 작성 규칙: references/seo-checklist.md.
  3. 구조화된 데이터:
    • 조직(또는 LocalBusiness)은 한 번만.
    • 페이지별 항목 유형(Service, Product, TouristTrip, Course, …).
    • 탐색 경로.
    • FAQ는 실제로 페이지에서 답변된 질문에만.
    • 가격이 없는 Offer는 절대 사용하지 마십시오.
    • Google의 리치 결과 테스트 및 Schema.org 검증기로 검증하세요.
  4. Robots, 사이트맵, llms.txt:
    • 라이브 환경은 크롤링을 허용하고 사이트맵을 나열하며, 스테이징 환경은 모든 것을 차단합니다(코어가 처리함).
    • /llms.txt는 코어가 제공합니다.
    • 목적에 따라 AI 크롤러가 사이트를 읽을 수 있는지 결정한 다음, 엣지가 기본적으로 이를 차단하고 있지 않은지 확인하십시오(wp-ship > cloudflare-edge.md).
  5. 리디렉션: 프로젝트의 docs/reference/REDIRECT_RULES.md를 따르십시오. 트래픽이나 백링크가 있는 모든 이전 URL을 가장 가까운 새 페이지에 매핑하고(301, 한 번의 점프), 각각을 테스트하십시오.
  6. 큰 변경 전 동등성 확인. 재설계, 마이그레이션 또는 언어 출시 전에 모든 URL의 제목, 설명, 정식 URL 및 H1을 캡처하십시오. 각 단계 후에 비교하십시오. 의도된 변경에 대해서만 다시 캡처하고, 커밋에 이유를 기록하십시오.
  7. Search Console 및 Bing:
    • 둘 다 인증;
    • 사이트맵 제출;
    • 첫 달 동안 매주 페이지 인덱싱 모니터링;
    • Search Console은 16개월의 데이터만 보관하므로, 초기에 대량 내보내기를 활성화하거나 데이터를 내보내십시오.

언어 단계 (각 언어는 먼저 파일럿입니다)

references/multilingual.md를 따르십시오. 간단히:

  1. 규칙 제로: 원본 언어는 변경되지 않습니다. URL, 제목, 정식 태그 및 텍스트는 동일하게 유지됩니다(동등성 확인으로 증명됨).
  2. 파일럿: 언어 기반(Polylang, 전환기, hreflang, .po/.mo 문자열), 그다음 주요 페이지 및 상위 항목. 그런 다음 스테이징에서 네이티브 스피커 검토 후 게시합니다.
  3. 나머지는 일괄적으로 제공되며, 각각 동일한 검토 과정을 거칩니다.
  4. 아직 게시되지 않은 언어는 원본 언어로 302 응답하며, 어디에도 나타나지 않습니다: 사이트맵, hreflang, 메뉴 또는 전환기에 표시되지 않습니다.

게이트 (SITE_STATUS.md에서 체크)

  • npm run test:seo가 스테이징에서 통과; 각 유형의 한 페이지에서 리치 결과 테스트 통과
  • 라이브 환경에 대한 사이트맵, robots.txt 및 llms.txt가 올바름
  • 이전 URL 리디렉션 맵이 적용되고 테스트됨(또는 "해당 없음")
  • 각 추가 언어: 파일럿 통과, 네이티브 검토 완료, hreflang 쌍 완료, 언어별 정식 URL

한 번 배송한 버그, 확인하세요

  • 번역된 홈페이지의 정식 URL이 원본 홈페이지를 가리켜 Google이 프랑스어 결과에서 /fr/을 제거하는 문제가 있었습니다. 번역된 페이지의 정식 URL은 번역된 URL입니다.
  • 프랑스어 페이지의 영어 JSON-LD: 스키마는 페이지의 언어를 따라야 하며, 번역될 때까지 생략해야 합니다.
  • 게이트가 게시되지 않은 언어를 홈페이지로 301 리디렉션한 문제가 있었습니다. 게이트는 302입니다.

Individual skills in this repo

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

umairmsm/wp-build

Stage 3 of a wp-site-kit WordPress build - local DDEV site, the core must-use plugin (modules), the presentation-only child theme with skins, the content model (custom post types, meta, WP_Query, render functions), and the enquiry pipeline that saves leads before forwarding. Use when building or changing features, templates, content types, forms or plugin modules on a wp-site-kit site.

umairmsm/wp-content

Stage 4 of a wp-site-kit WordPress build - real copy and photos. Content truth (facts only from the owner), AI drafts and owner approval, claims audits, banned words and fake proof, legal pages, the photo pipeline (dedupe, real-only, EXIF strip, WebP sizes, alt text, AI image register), and recorded content changes. Use for "write the copy", "add photos", "the owner sent new photos", "check for duplicates", "update prices or text on the live site", "legal pages".

umairmsm/wp-design

Stage 2 of a wp-site-kit WordPress build - design direction, a static HTML/CSS prototype with design tokens, owner sign-off with screenshots, self-hosted fonts, and porting the approved look into a swappable WordPress skin. Use for "design the site", "new look", "redesign", "change colours or fonts", "make a new skin", "port the prototype to WordPress".

umairmsm/wp-kickoff

Stage 1 of a wp-site-kit WordPress build. Use when starting a new WordPress website or taking over or rebuilding an existing one - discovery brief, stack decision, creating the project with bin/wp-site-new, locked decisions, private repo and credentials inventory. Triggers - "new WordPress site", "start a client website", "rebuild this site", "take over this WordPress site".

umairmsm/wp-operate

Stage 8 of a wp-site-kit WordPress build and everything after launch - backups with an off-machine copy, restore drills, the disaster-recovery runbook, credentials inventory, update policy, alerts, and working from more than one machine (bridge file, workstation doctor, encrypted state bundle, rescuing unpushed work). Use for "backup", "restore", "move to a new machine/server", "update plugins", "what if the server dies", "work from the cloud box", "set up a second machine".

umairmsm/wp-ship

Stage 7 of a wp-site-kit WordPress build - staging behind Cloudflare Access, server hardening, safe deploys from a commit (scripts/deploy-safe.sh), database content changes, the launch audit, DNS cutover without breaking a running business, and the first week after launch. Use for "deploy", "set up staging", "go live", "launch", "cutover", "move DNS", "harden the server".

umairmsm/wp-site

Start here for any WordPress website built with wp-site-kit, from an empty folder to a live site. Use when someone says "build a WordPress site", "new website for a client", "where are we on the site", "what is next before launch", or asks to continue a site project. Finds the current stage from SITE_STATUS.md, applies the hard rules, and hands over to the right stage skill.

관련 스킬