WordPress Agent Skills – AI 코딩 어시스턴트를 위한 WordPress 전문 지식 스킬셋

왜 필요한가?
제공 스킬 목록
스킬 구조
설치
Claude Code 전역 설치
프로젝트 단위 설치
특정 스킬만 설치
누구에게 유용한가?
호환성
라이선스
관련 도구
관련 자료

WordPress Agent Skills는 AI 코딩 어시스턴트(Claude Code, Copilot, Codex, Cursor 등)가 WordPress 개발 패턴을 올바르게 이해하고, 흔한 실수를 피하며, 공식 모범 사례를 따를 수 있도록 지식을 번들로 제공하는 오픈소스 스킬 컬렉션이다. WordPress 공식 기여자들이 검토·편집해 출시했으며 GitHub 스타 1.2k, 포크 174개(2026-04-17 기준)를 기록한다.

왜 필요한가?

AI 코딩 어시스턴트는 강력하지만 WordPress 개발에서 자주 실수한다:

Gutenberg 이전의 낡은 패턴 생성 (고전적 테마, 클래식 위젯 등)
플러그인 개발 시 보안 고려 사항 누락
블록 deprecation 미적용 → “Invalid block” 오류 유발
프로젝트 내 기존 툴링 무시

WordPress Agent Skills는 이 문제를 AI 어시스턴트가 실제로 활용할 수 있는 형식의 전문 지식으로 해결한다.

제공 스킬 목록

스킬	다루는 내용
wordpress-router	저장소 유형 분류 및 적합한 워크플로우 라우팅
wp-project-triage	프로젝트 유형·툴링·버전 자동 감지
wp-block-development	Gutenberg 블록: block.json, 속성, 렌더링, deprecation
wp-block-themes	블록 테마: theme.json, 템플릿, 패턴, 스타일 변형
wp-plugin-development	플러그인 아키텍처, 훅, 설정 API, 보안
wp-rest-api	REST API 라우트·엔드포인트, 스키마, 인증, 응답 형성
wp-interactivity-api	`data-wp-*` 지시문과 스토어를 활용한 프론트엔드 인터랙티비티
wp-abilities-api	역량(capability) 기반 권한 및 REST API 인증
wp-wpcli-and-ops	WP-CLI 명령어, 자동화, 멀티사이트, 검색·치환
wp-performance	프로파일링, 캐싱, DB 최적화, Server-Timing
wp-phpstan	WordPress 프로젝트를 위한 PHPStan 정적 분석
wp-playground	WordPress Playground로 즉시 로컬 환경 구성
wpds	WordPress 디자인 시스템
blueprint	선언형 Playground 환경 설정을 위한 Blueprints

스킬 구조

각 스킬은 다음 폴더 구조를 따른다:

skills/wp-block-development/
├── SKILL.md          # 주 지침 (사용 시점, 절차, 검증)
├── references/       # 주제별 심층 문서
│   ├── block-json.md
│   ├── deprecations.md
│   └── ...
└── scripts/          # 감지·검증용 결정론적 헬퍼
    └── list_blocks.mjs

설치

Claude Code 전역 설치

git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
node shared/scripts/skillpack-build.mjs --clean
node shared/scripts/skillpack-install.mjs --global

~/.claude/skills/에 설치되어 Claude Code가 자동으로 검색한다.

프로젝트 단위 설치

node shared/scripts/skillpack-install.mjs \
  --dest=../your-wp-project \
  --targets=codex,vscode,claude,cursor

대상별 설치 경로:

도구	경로
Claude Code	`.claude/skills/`
GitHub Copilot / VS Code	`.github/skills/`
Cursor	`.cursor/skills/`
OpenAI Codex	`.codex/skills/`

특정 스킬만 설치

node shared/scripts/skillpack-install.mjs \
  --global --skills=wp-playground,wp-block-development

누구에게 유용한가?

WordPress 플러그인·블록 개발자: AI 어시스턴트에게 최신 WordPress 표준을 가르쳐 코드 품질을 높이고 싶을 때
대행사·에이전시: 팀 내 WordPress 표준을 AI에 내재화해 일관된 코드 품질을 유지하고 싶을 때
Claude Code / Cursor 사용자: WordPress 작업 시 낡은 코드 생성을 방지하고 Gutenberg 패턴을 정확히 따르고 싶을 때

호환성

WordPress 6.9+ (PHP 7.2.24+)
Claude Code, Copilot, Codex, Cursor, Kiro 등 프로젝트 레벨 지침을 지원하는 모든 AI 어시스턴트

라이선스

GPL-2.0-or-later

AI Sparkup