메인 콘텐츠로 건너뛰기
laravel/agent-skills는 활발히 개발 중인 리포지토리입니다 (2026년 4월 시점). 현재 플러그인 버전은 1.0.0이지만, 앞으로 내용 변경 및 추가가 예상됩니다.

laravel/agent-skills란

laravel/agent-skills는 Laravel 공식이 관리하는 AI 에이전트용 스킬 · 플러그인 컬렉션 리포지토리입니다. Taylor Otwell 본인이 작성자로 등록되어 있으며, Laravel 공식 마켓플레이스로서 정비되어 갈 예정입니다. 원래는 Claude Code용 스킬을 두는 리포지토리로 시작되었지만, 리포지토리 이름을 agent-skills로 리뉴얼하여 Claude CodeCursor 양쪽 모두에 대응하는 플러그인을 제공하게 되었습니다. AI를 활용하여 Laravel 앱을 개발하는 상황에서, 에이전트가 Laravel의 베스트 프랙티스를 이해하고 Laravel Cloud나 Nightwatch 등의 공식 서비스도 자율적으로 조작할 수 있도록 하기 위한 스킬 세트입니다.

리포지토리 구조

리포지토리는 스킬(플러그인)별로 디렉터리가 나뉘어 있으며, 각 디렉터리에 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-cloudLaravel Cloud로의 배포와 리소스 관리를 지원하는 스킬입니다. cloud CLI의 명령 패턴에 능통하며, 배포 절차를 단계별로 안내합니다. 주요 기능:
  • 첫 배포 · 기존 앱 배포 워크플로우 안내
  • 데이터베이스 · 캐시 · 도메인 · 버킷 등 인프라 리소스 관리
  • 다단계 작업에 대한 오퍼레이션 체크리스트
  • Cloud CLI의 CRUD 명령 패턴을 준수한 조작
> Deploy my app to Laravel Cloud
> Set up a database and cache for the staging environment

laravel-nightwatch — 모니터링 설정 스킬

laravel-nightwatchLaravel Nightwatch의 데이터 수집 · 샘플링 레이트 · 필터링 룰 · 리덕션 정책 설정을 지원하는 스킬입니다. 또한 Nightwatch MCP 서버를 번들하여, AI 에이전트가 Nightwatch의 문제를 직접 참조 · 조작할 수 있게 합니다.
기능설명
설정 · 구성앱에 Nightwatch 설정 안내
샘플링 · 필터링룰 설정을 통한 데이터 양 제어
PII 리덕션민감 데이터를 보호하는 리덕션 정책
이벤트 최적화프로덕션 환경용 이벤트 수집 최적화
MCP 연동문제 열람 · 스택 트레이스 확인 · 상태 업데이트 · 코멘트 추가
> Configure Nightwatch sampling rates for production
> Set up PII redaction for Nightwatch

설치 방법

Claude Code

Claude Code의 마켓플레이스 기능을 사용하여 설치합니다.
# 마켓플레이스에 추가
/plugin marketplace add laravel/agent-skills

# 각 플러그인 설치
/plugin install laravel-simplifier@laravel
/plugin install laravel-cloud@laravel
/plugin install laravel-nightwatch@laravel
필요한 플러그인만 설치할 수도 있습니다. 모두 설치할 필요는 없습니다.

Cursor

Cursor의 경우 플러그인 마켓플레이스 패널에서 Laravel을 검색하여 설치합니다.
1

Cursor 열기

Cursor의 사이드바 또는 설정에서 “Plugins” 패널을 엽니다.
2

Laravel 검색

검색창에 “Laravel”을 입력합니다.
3

필요한 플러그인 설치

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 스킬을 제공 · 관리하는 것은 에코시스템 전체의 품질 향상에 크게 기여할 것입니다.

laravel/agent-skills 리포지토리

스킬의 세부 내용이나 설치 절차는 공식 리포지토리의 README를 참고하세요.

Laravel Cloud

laravel-cloud 스킬과 연동하는 Laravel 공식 호스팅 서비스입니다.

Laravel Nightwatch

laravel-nightwatch 스킬과 연동하는 Laravel 공식 에러 모니터링 서비스입니다.
마지막 수정일 2026년 7월 13일