WordPress/agent-skills

AI 코딩 어시스턴트에게 WordPress를 올바른 방식으로 구축하는 방법을 가르치세요.

Agent Skills는 AI 어시스턴트(Claude, Copilot, Codex, Cursor 등)가 WordPress 개발 패턴을 이해하고, 흔한 실수를 피하며, 베스트 프랙티스(Best Practices)를 따를 수 있도록 돕는 지침(Instructions), 체크리스트(Checklists), 스크립트(Scripts)의 휴대 가능한 번들입니다.

AI 저작권 공개: 이 스킬들은 공식 Gutenberg 및 WordPress 문서로부터 GPT-5.2 Codex (High Reasoning)를 사용하여 생성되었으며, 이후 WordPress 기여자들에 의해 검토 및 편집되었습니다. 우리는 AI 어시스턴트를 통해 스킬을 테스트하고 결과에 따라 반복 개선했습니다. 이것은 v1이며, 커뮤니티가 이를 사용하고 수정 사항을 기여함에 따라 스킬은 더욱 향상될 것입니다. 자세한 내용은 docs/ai-authorship.md를 참조하세요. (WordPress AI 가이드라인)

AI 코딩 어시스턴트는 강력하지만, 종종 다음과 같은 문제를 일으킵니다:

• 오래된 WordPress 패턴 생성 (Gutenberg 이전, 블록 테마 이전 방식)
• 플러그인 개발 시 중요한 보안 고려 사항 누락
• 적절한 블록 폐기(Block Deprecations) 과정을 생략하여 "Invalid block" 오류 발생
• 사용자의 리포지토리(Repo)에 존재하는 기존 도구들을 무시

Agent Skills는 AI 어시스턴트가 실제로 사용할 수 있는 형식으로 전문가 수준의 WordPress 지식을 제공함으로써 이 문제를 해결합니다.

기술 (Skill)	학습 내용
wordpress-router	WordPress 저장소를 분류하고 적절한 워크플로 (workflow)로 라우팅
wp-project-triage	프로젝트 유형, 도구 및 버전을 자동으로 감지
wp-block-development	Gutenberg 블록: block.json, 속성 (attributes), 렌더링 (rendering), 지원 중단 (deprecations)
wp-block-themes	블록 테마 (Block themes): theme.json, 템플릿 (templates), 패턴 (patterns), 스타일 변형 (style variations)
wp-plugin-development	플러그인 아키텍처 (Plugin architecture), 훅 (hooks), 설정 API (settings API), 보안 (security)
wp-rest-api	REST API 경로/엔드포인트 (routes/endpoints), 스키마 (schema), 인증 (auth), 응답 구성 (response shaping)
wp-interactivity-api	data-wp-* 지시어 (directives) 및 스토어 (stores)를 사용한 프론트엔드 상호작용 (interactivity)
wp-abilities-api	권한 기반 권한 (Capability-based permissions) 및 REST API 인증 (authentication)
wp-wpcli-and-ops	WP-CLI 명령, 자동화 (automation), 멀티사이트 (multisite), 검색 및 교체 (search-replace)
wp-performance	프로파일링 (Profiling), 캐싱 (caching), 데이터베이스 최적화 (database optimization), Server-Timing
wp-phpstan	WordPress 프로젝트를 위한 PHPStan 정적 분석 (PHPStan static analysis) (설정 (config), 베이스라인 (baselines), WordPress 전용 타이핑 (WP-specific typing))
wp-playground	즉각적인 로컬 환경을 위한 WordPress Playground
wpds	WordPress 디자인 시스템 (WordPress Design System)
wp-plugin-directory-guidelines	WordPress 플러그인 디렉토리 가이드라인 (WordPress Plugin Directory Guidelines)
blueprint	선언적 Playground 환경 설정을 위한 WordPress Playground 블루프린트 (Blueprints)

# agent-skills 클론
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
...

이 명령은 기술들을 ~/.claude/skills/에 설치하며,

Claude Code가 이를 자동으로 감지하게 됩니다.

# agent-skills 클론
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
...

이 명령은 기술들을 다음 위치로 복사합니다:

.codex/skills/ (OpenAI Codex용)
.github/skills/ (VS Code / GitHub Copilot용)
.claude/skills/ (Claude Code 프로젝트 레벨용)
.cursor/skills/ (Cursor 프로젝트 레벨용)

node shared/scripts/skillpack-install.mjs --targets=cursor-global

이 명령은 기술들을 ~/.cursor/skills/에 설치하며,

Cursor가 이를 감지하게 됩니다.

# 사용 가능한 기술(skills) 목록 표시
node shared/scripts/skillpack-install.mjs --list
# 드라이 런 (설치 없이 미리보기)
...

skills/ 디렉토리에 있는 기술 폴더를 복사하여

AI 어시스턴트를 위한 프로젝트의 지침(instructions) 디렉토리로 옮기세요.

각 기술은 다음을 포함합니다:

skills/wp-block-development/
├── SKILL.md # 주요 지침 (사용 시점, 절차, 검증)
├── references/ # 특정 주제에 대한 심층 문서
...

AI 어시스턴트에게 WordPress 코드를 작업하도록 요청하면, 어시스턴트는 추측하는 대신 이 기술들을 읽고 문서화된 절차를 따릅니다.

WordPress 6.9+(PHP 7.2.24+)- 프로젝트 수준의 지침(project-level instructions)을 지원하는 모든 AI 어시스턴트와 호환됩니다.

기여를 환영합니다! 이 프로젝트는 여러분의 WordPress 전문 지식을 공유할 수 있는 좋은 방법입니다. 코딩 전문가가 아니어도 괜찮습니다. 대부분의 기술은 Markdown으로 작성되며, 명확한 절차와 모범 사례(best practices)에 집중합니다.

시작하는 방법에 대한 자세한 내용은 CONTRIBUTING.md를 참조하세요.

빠른 명령어:

# 새로운 기술 스캐폴딩 (Scaffold)
node shared/scripts/scaffold-skill.mjs <skill-name> "<description>"
# 기술 유효성 검사 (Validate)
...

• Authoring Guide - 기술을 생성하고 개선하는 방법
• Principles - 설계 철학
• Packaging - 빌드 및 배포
• Compatibility Policy - 버전 타겟팅

GPL-2.0-or-later