Medusajs 스킬

medusa-agent-skills/plugins/medusa-dev/skills/building-admin-dashboard-customizations

Medusa Admin 대시보드용 맞춤 UI 확장 기능으로, Admin SDK와 Medusa UI 컴포넌트를 사용합니다. 모든 관리자 UI 작업(계획, 구현, 탐색) 시 이 스킬을 먼저 로드하세요. MCP 서버는 API 참조만 제공하며, 디자인 패턴이나 데이터 로딩 전략은 제공하지 않습니다. 중요: 모든 API 요청에는 Medusa JS SDK를 사용하고(일반 fetch 사용 금지), 표시 쿼리와 모달 쿼리를 분리하며, 변형 후에는 표시 데이터를 무효화하세요. 기존 페이지에 위젯을 구현하거나 맞춤 UI 라우트를 생성하세요.

medusa-agent-skills/plugins/medusa-dev/skills/building-storefronts

SDK 기반의 Medusa 스토어프론트 통합으로, React Query 패턴과 중요한 API 호출 규칙을 포함합니다. 모든 API 요청에는 항상 Medusa JS SDK를 사용해야 하며, 일반 fetch()는 사용하지 않습니다. fetch()는 필수 헤더(스토어 라우트의 publishable API 키, 관리자 라우트의 인증)가 누락되기 때문입니다. SDK 메서드에는 일반 JavaScript 객체를 전달하며, 본문 매개변수에 JSON.stringify()를 사용하지 않습니다. SDK가 자동으로 직렬화를 처리합니다. GET 요청에는 useQuery를, POST/DELETE 요청에는 useMutation을 사용합니다.

medusa-agent-skills/plugins/medusa-dev/skills/building-with-medusa

Medusa 백엔드 아키텍처, 워크플로우 및 중요한 구현 규칙에 대한 종합 가이드입니다. 여섯 가지 규칙 범주(아키텍처, 타입 안전성, 비즈니스 로직 배치, 임포트, 데이터 접근, 파일 구성)를 다루며, 특정 안티패턴과 적용 확인 사항을 포함합니다. 엄격한 계층 분리(모듈 → 워크플로우 → API 라우트 → 프론트엔드)를 적용하며, 모든 변경 작업에 워크플로우를 요구하고 GET/POST/DELETE HTTP 메서드만 허용합니다. 가격을 있는 그대로 저장하는 등 중요한 데이터 처리 규칙을 포함합니다...

medusa-agent-skills/skills/creating-agents-in-medusa

Medusa 프로젝트에서 내부 관리자용 AI 에이전트를 구축할 때 사용합니다. 이러한 에이전트는 고객이 아닌 판매자와 스토어 운영자가 사용합니다. 다음을 다룹니다…

medusa-agent-skills/plugins/medusa-dev/skills/db-generate

단일 명령어로 Medusa 모듈의 데이터베이스 마이그레이션을 생성합니다. npx medusa db:generate CLI 명령을 래핑하여 지정된 Medusa 모듈의 마이그레이션 파일을 생성합니다. 모듈 이름을 인수로 받아 마이그레이션 파일 위치, 오류 및 다음 단계를 보고합니다. 생성 후 마이그레이션을 적용하기 위해 npx medusa db:migrate를 실행하도록 자동으로 제안합니다.

medusa-agent-skills/plugins/medusa-dev/skills/db-migrate

보류 중인 Medusa 데이터베이스 마이그레이션을 실행하고 결과를 보고합니다. Bash를 통해 npx medusa db:migrate를 실행하여 보류 중인 모든 마이그레이션을 Medusa 데이터베이스에 적용합니다. 적용된 마이그레이션 수, 발생한 오류, 성공 확인을 포함한 마이그레이션 결과를 보고합니다. 표준 npm/npx 설정을 사용하는 Medusa 프로젝트용으로 설계되었습니다.

medusa/.claude/skills/diagnosing-dependabot-alerts

Medusa 모노레포의 GitHub Dependabot/보안 알림을 진단하고 가장 덜 침습적인 수정 방법을 찾습니다. Dependabot 알림, 보안 문제를 조사할 때 사용하세요.

medusa-agent-skills/plugins/learn-medusa/skills/learning-medusa

대화형 단계별 메두사 개발 부트캠프로, 브랜드 기능을 구축하면서 아키텍처 패턴을 학습합니다. 모듈, 워크플로우, API 라우트, 모듈 링크, 워크플로우 훅, 관리자 UI 커스터마이징을 다루는 3개의 점진적 레슨(총 2~3시간)으로 구성됩니다. 각 주요 구성 요소 이후 체크포인트 검증을 통해 개념 이해도, 코드 품질, 기능성을 확인한 후 진행합니다. 오류를 교육 기회로 활용하며, 진단 질문과 근본 원인 분석을 통해 함께 디버깅합니다...

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-deployments

mcloud deployments 명령을 실행하여 배포 목록을 조회하고, 배포 세부 정보를 검색하며, 빌드 로그를 가져옵니다. 배포 목록을 확인하거나, 배포 상태를 점검할 때 사용합니다.

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-environments

mcloud environments 명령을 실행하여 Cloud 환경을 나열, 조회, 생성, 삭제, 재배포 또는 빌드를 트리거합니다. 환경 수명 주기를 관리할 때 사용합니다.

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-local

로컬 머신에서 Cloud build를 재현하기 위해 mcloud local build를 실행합니다. 추적된 브랜치로 푸시하지 않고 빌드에 실패한 배포를 디버깅할 때 사용합니다,…

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-logs

mcloud logs를 실행하여 Cloud 환경의 런타임 로그를 가져오고 스트리밍합니다. 백엔드 또는 스토어프론트 로그를 읽을 때, 시간 범위로 필터링하거나 검색할 때 사용합니다.

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-organizations

mcloud organizations 명령을 실행하여 Cloud 조직을 나열하거나 가져옵니다. 조직을 검색하거나, 이름으로 조직 ID를 확인하거나, 검색할 때 사용합니다.

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-projects

mcloud projects 명령을 실행하여 Cloud 프로젝트를 나열, 조회 또는 삭제합니다. 프로젝트를 검색하거나 이름으로 프로젝트 핸들을 확인하거나 검색할 때 사용합니다.

medusa-agent-skills/plugins/medusa-cloud/skills/mcloud-variables

mcloud variables 명령어를 실행하여 Cloud 환경의 환경 변수를 나열하고 가져옵니다. 환경을 검사하거나 읽거나 내보낼 때 사용합니다.

medusa-agent-skills/plugins/medusa-dev/skills/new-user

Medusa에서 이메일과 비밀번호로 새 관리자 사용자를 생성합니다. 명령 인수로 이메일과 비밀번호를 받아 관리자 자격 증명을 설정합니다. Bash를 통해 -e 및 -p 플래그와 함께 npx medusa user 명령을 실행합니다. 생성 성공, 사용자 이메일, 오류 및 관리자 대시보드 로그인을 위한 다음 단계를 보고합니다.

medusa/.claude/skills/reviewing-prs

Medusa 저장소의 GitHub 풀 리퀘스트를 검토합니다. PR 템플릿 준수 여부, 기여 가이드라인, 코드 규칙, 보안, 성능 등을 확인합니다…

medusa-agent-skills/plugins/ecommerce-storefront/skills/storefront-best-practices

모던 이커머스 스토어프론트 구축을 위한 포괄적인 가이드로, 패턴, 컴포넌트 아키텍처, 백엔드 통합을 다룹니다. 모든 스토어프론트 컴포넌트(네비게이션, 상품 페이지, 장바구니, 결제, 계정 페이지)를 포함하며, 모든 프레임워크(Next.js, SvelteKit, React, Vue)에서 사용 가능합니다. 필수 접근성 패턴(장바구니 업데이트를 위한 aria-live), 모바일 최적화(safe-area-inset, 44px 터치 타겟), SEO 요구사항(Product 스키마, Core Web Vitals)을 다룹니다. 필수 백엔드 SDK를 제공합니다.

medusa/.claude/skills/triaging-issues

Medusa 저장소의 GitHub 이슈를 분류합니다. GitHub 이슈가 열리거나 새 댓글이 달릴 때 사용합니다. 이슈를 분류하고 검증한 후, 다음을 출력합니다…

medusa-agent-skills/plugins/medusa-cloud/skills/using-medusa-cloud

Medusa Cloud 리소스를 Cloud CLI(mcloud)를 통해 관리합니다. 배포, 디버깅, 환경 관리, 환경 변수 관리 등에 사용합니다.

medusa/.claude/skills/writing-docs

Medusa 문서의 book, resources, ui, user-guide, cloud 프로젝트에 대한 MDX 파일을 작성하고 업데이트합니다. 문서 변경 사항을 적용할 때 사용합니다…

medusa/.claude/skills/writing-releases

Medusa 릴리스에 대한 GitHub 릴리스 노트를 기존 스타일로 작성합니다. 커밋 및 PR 목록에서 초안 릴리스 설명을 생성할 때 사용합니다…

medusa/.claude/skills/writing-tsdocs

Medusa 코드베이스의 TypeScript 소스 파일에 TypeDoc(TSDoc) 주석을 추가하고 업데이트합니다. HTTP 유형, API 라우트, UI 컴포넌트, 데이터 모델, 서비스…를 다룹니다.