> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.
# laravel/agent-skills — Laravel 공식 AI 에이전트 스킬 모음
> Laravel 공식이 관리하는 AI 에이전트 스킬 리포지토리 'laravel/agent-skills'를 소개합니다. Claude Code · Cursor용 플러그인으로 제공되는 스킬의 개요, 설치 방법, 각 스킬의 세부 내용을 설명합니다.
`laravel/agent-skills`는 활발히 개발 중인 리포지토리입니다 (2026년 4월 시점). 현재 플러그인 버전은 `1.0.0`이지만, 앞으로 내용 변경 및 추가가 예상됩니다.
## laravel/agent-skills란
[laravel/agent-skills](https://github.com/laravel/agent-skills)는 Laravel 공식이 관리하는 AI 에이전트용 스킬 · 플러그인 컬렉션 리포지토리입니다. Taylor Otwell 본인이 작성자로 등록되어 있으며, Laravel 공식 마켓플레이스로서 정비되어 갈 예정입니다.
원래는 Claude Code용 스킬을 두는 리포지토리로 시작되었지만, 리포지토리 이름을 `agent-skills`로 리뉴얼하여 **Claude Code**와 **Cursor** 양쪽 모두에 대응하는 플러그인을 제공하게 되었습니다.
AI를 활용하여 Laravel 앱을 개발하는 상황에서, 에이전트가 Laravel의 베스트 프랙티스를 이해하고 Laravel Cloud나 Nightwatch 등의 공식 서비스도 자율적으로 조작할 수 있도록 하기 위한 스킬 세트입니다.
```mermaid theme={null}
graph TD
A["laravel/agent-skills
(공식 스킬 리포지토리)"] --> B["laravel-simplifier
Laravel 코드 개선 에이전트"]
A --> C["laravel-cloud
Laravel Cloud 배포 스킬"]
A --> D["laravel-nightwatch
Nightwatch 설정 스킬"]
B --> E["Claude Code
.claude-plugin"]
B --> F["Cursor
.cursor-plugin"]
C --> E
C --> F
D --> E
D --> F
D --> G["Nightwatch
MCP 서버"]
```
## 리포지토리 구조
리포지토리는 스킬(플러그인)별로 디렉터리가 나뉘어 있으며, 각 디렉터리에 Claude Code용 및 Cursor용 설정 파일이 포함되어 있습니다.
```
laravel/agent-skills/
├── laravel/ # Laravel 코드 개선 에이전트
│ ├── .claude-plugin/
│ │ └── plugin.json # Claude Code 플러그인 정의
│ ├── .cursor-plugin/
│ │ └── plugin.json # Cursor 플러그인 정의
│ └── agents/
│ └── laravel-simplifier.md # 에이전트의 시스템 프롬프트
├── laravel-cloud/ # Laravel Cloud 배포 스킬
│ ├── .claude-plugin/
│ │ └── plugin.json
│ ├── .cursor-plugin/
│ │ └── plugin.json
│ └── skills/
│ └── deploying-laravel-cloud/
└── laravel-nightwatch/ # Laravel Nightwatch 설정 스킬
├── .claude-plugin/
│ └── plugin.json
├── .cursor-plugin/
│ └── plugin.json
├── .mcp.json # Nightwatch MCP 서버 설정
└── skills/
└── configure-nightwatch/
```
## 제공되는 플러그인
### laravel — 코드 품질 개선 에이전트
**laravel-simplifier**는 최근 변경된 PHP/Laravel 코드를 리뷰하여, 기능을 바꾸지 않고 코드의 명료성 · 일관성 · 유지보수성을 높이는 에이전트입니다. 리포지토리 내에서는 `laravel/` 디렉터리에 저장되어 있으며, 설치 시에는 `laravel-simplifier@laravel`로 지정합니다.
주요 기능:
* Laravel의 규약과 PSR-12 표준 적용
* 불필요한 복잡성과 중첩 감소
* 변수명 · 함수명의 가독성 향상
* 관련 로직의 정리 · 통합
* `match` 식 활용을 통한 조건 분기의 명확화
에이전트는 기본적으로 "최근 변경된 코드"만을 대상으로 합니다. 코딩 세션이 끝난 후에 호출하면 자동으로 변경 부분을 특정하여 리팩토링을 제안해 줍니다.
```
> Review recent changes using the laravel-simplifier agent
```
### laravel-cloud — 배포 · 인프라 관리 스킬
**laravel-cloud**는 [Laravel Cloud](https://cloud.laravel.com)로의 배포와 리소스 관리를 지원하는 스킬입니다. `cloud` CLI의 명령 패턴에 능통하며, 배포 절차를 단계별로 안내합니다.
주요 기능:
* 첫 배포 · 기존 앱 배포 워크플로우 안내
* 데이터베이스 · 캐시 · 도메인 · 버킷 등 인프라 리소스 관리
* 다단계 작업에 대한 오퍼레이션 체크리스트
* Cloud CLI의 CRUD 명령 패턴을 준수한 조작
```
> Deploy my app to Laravel Cloud
> Set up a database and cache for the staging environment
```
### laravel-nightwatch — 모니터링 설정 스킬
**laravel-nightwatch**는 [Laravel Nightwatch](https://nightwatch.laravel.com)의 데이터 수집 · 샘플링 레이트 · 필터링 룰 · 리덕션 정책 설정을 지원하는 스킬입니다.
또한 **Nightwatch MCP 서버**를 번들하여, AI 에이전트가 Nightwatch의 문제를 직접 참조 · 조작할 수 있게 합니다.
| 기능 | 설명 |
| --------- | ------------------------------------- |
| 설정 · 구성 | 앱에 Nightwatch 설정 안내 |
| 샘플링 · 필터링 | 룰 설정을 통한 데이터 양 제어 |
| PII 리덕션 | 민감 데이터를 보호하는 리덕션 정책 |
| 이벤트 최적화 | 프로덕션 환경용 이벤트 수집 최적화 |
| MCP 연동 | 문제 열람 · 스택 트레이스 확인 · 상태 업데이트 · 코멘트 추가 |
```
> Configure Nightwatch sampling rates for production
> Set up PII redaction for Nightwatch
```
## 설치 방법
### Claude Code
Claude Code의 마켓플레이스 기능을 사용하여 설치합니다.
```bash theme={null}
# 마켓플레이스에 추가
/plugin marketplace add laravel/agent-skills
# 각 플러그인 설치
/plugin install laravel-simplifier@laravel
/plugin install laravel-cloud@laravel
/plugin install laravel-nightwatch@laravel
```
필요한 플러그인만 설치할 수도 있습니다. 모두 설치할 필요는 없습니다.
### Cursor
Cursor의 경우 플러그인 마켓플레이스 패널에서 **Laravel**을 검색하여 설치합니다.
Cursor의 사이드바 또는 설정에서 "Plugins" 패널을 엽니다.
검색창에 "**Laravel**"을 입력합니다.
`laravel` · `laravel-cloud` · `laravel-nightwatch` 중 필요한 것을 설치합니다.
## 사용 예시
### laravel-simplifier로 코드 리뷰 자동화하기
코딩 세션 마지막에 호출하여, 작성한 코드를 자동으로 Laravel의 베스트 프랙티스에 따라 세련되게 다듬을 수 있습니다.
```
> Review recent changes using the laravel-simplifier agent
```
에이전트는 자율적으로 동작하여 변경된 파일을 특정하고 개선안을 제시합니다. 명시적으로 지시하지 않는 한, 최근에 변경한 코드만이 대상이 됩니다.
### Laravel Cloud로 배포
자연어로 배포 작업을 지시할 수 있습니다. 에이전트가 `cloud` CLI의 명령을 적절히 조합하여 실행합니다.
```
> Deploy my app to Laravel Cloud
> Set up a database and cache for the staging environment
> Add a custom domain to my production environment
```
### Nightwatch에서 문제 조사하기
Nightwatch의 MCP 서버가 통합되어 있어, AI에게 직접 문제 조사를 의뢰할 수 있습니다.
```
> Show me the latest errors in Nightwatch
> What's the stack trace for issue #42?
> Mark issue #42 as resolved
```
## 플러그인의 구조
각 플러그인은 `.claude-plugin/plugin.json` 또는 `.cursor-plugin/plugin.json`에서 정의됩니다. 에이전트 정의(`.md` 파일)에는 시스템 프롬프트가 기술되어 있으며, AI가 어떻게 동작해야 하는지 상세히 규정되어 있습니다.
laravel-simplifier의 프롬프트 일부:
```
You are an expert PHP/Laravel code simplification specialist focused on
enhancing code clarity, consistency, and maintainability while preserving
exact functionality...
```
스킬은 컨텍스트 파일(Markdown 문서) 형태로 AI에 추가 지식을 제공합니다. 예를 들어 laravel-cloud 스킬에는 Cloud CLI의 조작 절차나 주의점이 상세히 기술되어 있어, AI가 배포를 잘못 실행하지 않도록 안내합니다.
## 향후 전망
`laravel/agent-skills` 리포지토리는 **Laravel 에코시스템 전체를 커버하는 AI 스킬의 공식 마켓플레이스**로 정비되어 갈 예정입니다.
현재는 Laravel · Laravel Cloud · Laravel Nightwatch의 세 가지 플러그인이 제공되고 있지만, 앞으로 다음과 같은 확장이 기대됩니다:
* 다른 Laravel 공식 패키지(Forge · Vapour · Cashier · Sanctum 등) 대응
* GitHub Copilot 등 Claude Code · Cursor 이외의 AI 도구 대응
* 커뮤니티에 의한 서드파티 스킬 추가 (마켓플레이스화)
AI 개발이 표준 워크플로우가 되어 가는 지금, Laravel 팀이 공식으로 AI 스킬을 제공 · 관리하는 것은 에코시스템 전체의 품질 향상에 크게 기여할 것입니다.
스킬의 세부 내용이나 설치 절차는 공식 리포지토리의 README를 참고하세요.
laravel-cloud 스킬과 연동하는 Laravel 공식 호스팅 서비스입니다.
laravel-nightwatch 스킬과 연동하는 Laravel 공식 에러 모니터링 서비스입니다.
## Related topics
- [Laravel Agent Detector — AI 에이전트 감지 패키지](/ko/blog/agent-detector-introduction.md)
- [Laravel PAO — AI 에이전트용 출력 최적화 도구](/ko/blog/pao-introduction.md)
- [Skills](/ko/packages/laravel-copilot-sdk/skills.md)
- [Boost의 커스텀 에이전트 만들기](/ko/advanced/boost-custom-agent.md)
- [Laravel과 AI 개발](/ko/ai.md)