AI 코딩 에이전트(Claude Code, Cursor, Codex, OpenCode)를 위한 10개 전문 개발 스킬 컬렉션 — 프론트엔드, 풀스택, 모바일(Android/iOS), 셰이더, 문서 생성(PDF/DOCX/XLSX/PPTX), GIF 스티커 제작까지 아우르는 에이전트 스킬 마켓플레이스입니다.
일반 AI 에이전트는 모든 것을 조금씩 알지만 깊이가 얕습니다. MiniMax-AI/skills는 각 도메인(Android, GLSL 셰이더, PDF 생성 등)의 수백 줄짜리 전문 가이드를 SKILL.md로 패키징해 에이전트에게 주입합니다.
핵심은 한 번 작성한 스킬이 4개 플랫폼에 동시 배포된다는 점입니다. Claude Code를 쓰든 Cursor를 쓰든 같은 전문 지식이 작동합니다.
Claude Code용 SKILL.md를 만들어도 Cursor에서는 따로 설정해야 합니다. 스킬 내용이 바뀌면 4개 플랫폼 설정 파일을 모두 수동으로 업데이트해야 하는 번거로움이 있습니다.
skills/*/SKILL.md에 핵심 콘텐츠를 한 번만 작성하면, 각 플랫폼 어댑터(.claude-plugin/, .cursor-plugin/ 등)가 자동으로 해당 플랫폼 규격으로 스킬을 등록합니다. 새 플랫폼이 생겨도 어댑터만 추가하면 됩니다.
| 비교 대상 | MiniMax-AI/skills 장점 |
|---|---|
| mattpocock/skills | 10개 도메인 커버 vs 소수 스킬 — 모바일·셰이더까지 포함 |
| obra/superpowers | MiniMax API 기반 멀티미디어 생성 기능 내장 |
| awesome-claude-code 큐레이션 | 큐레이션이 아닌 실제 실행 가능한 스킬 패키지 |
| 개별 SKILL.md 작성 | 4개 플랫폼 동시 배포 구조로 재사용성 극대화 |
| 영역 | 기술 | 용도 |
|---|---|---|
| PDF 생성 | Python + reportlab + pypdf | 본문 렌더링 + 병합 |
| 커버 렌더링 | Node.js 18+ + Playwright | Chromium 기반 HTML→PDF 변환 |
| DOCX 생성 | C# + OpenXML SDK 3.2+ | .NET 기반 Word 문서 조작 |
| XLSX 처리 | Python (pandas + XML 직접 조작) | 스프레드시트 읽기/분석(pandas), 생성/수정(XML unpack-pack 스크립트) ※ openpyxl round-trip 비권장 |
| PPTX 생성 | JavaScript + PptxGenJS | 프레젠테이션 생성/편집 |
| 이미지/비디오 | MiniMax API | AI 기반 이미지→비디오 변환 |
| GIF 변환 | Python + ffmpeg | MP4→GIF 변환 |
| 기술 | 역할 |
|---|---|
| React / Next.js | UI 프레임워크 |
| Tailwind CSS | 유틸리티 스타일링 |
| Framer Motion | 선언적 애니메이션 |
| GSAP | 고성능 시네마틱 애니메이션 |
| p5.js (Generative Art) | 절차적 아트 생성 |
| 기술 | 용도 |
|---|---|
| GLSL | 셰이더 언어 (36개 기법) |
| WebGL2 | 브라우저 렌더링 |
| Ray Marching + SDF | 3D 렌더링 기법 (GPU 성능 제약 준수) |
skills/frontend-dev/SKILL.md ──→ .claude-plugin/ (Claude Code)
──→ .cursor-plugin/ (Cursor)
──→ .codex/ (Codex)
──→ .opencode/ (OpenCode)스킬 파일은 계층적으로 구성됩니다. 에이전트가 필요한 깊이만큼만 읽어 토큰 비용을 절약합니다.
모든 문서 생성 스킬은 출력 전 검증 게이트를 통과해야 합니다. minimax-docx는 XSD 스키마 검증, minimax-pdf는 페이지 수·이미지 해상도·폰트 임베딩을 확인합니다.
SKILL.md 파일의 구조 설계와 프로그레시브 디스클로저로 토큰을 절약하는 전략을 배웁니다. 하나의 스킬을 여러 플랫폼에 배포하는 어댑터 패턴이 핵심 학습 포인트입니다.
3계층 아키텍처(Controller → Service → Repository), Feature-First 구조, 의존성 주입, 에러 계층 구조, JWT 인증 흐름, 실시간 통신(SSE vs WebSocket)을 배웁니다.
// 타입 안전한 에러 계층 구조 예시
class AppError extends Error {
constructor(
message: string,
public readonly code: string,
public readonly statusCode: number,
public readonly isOperational: boolean = true,
) { super(message); }
}reportlab으로 Python에서 PDF를 생성하고, Playwright로 HTML 커버 페이지를 Chromium에서 렌더링해 PDF로 변환하는 기법을 배웁니다. OpenXML SDK로 Word 문서 내부 XML 구조를 직접 조작하는 법도 익힙니다.
Ray Marching(SDF 값만큼 광선 전진), SDF(수학 함수로 3D 형체 정의), 절차적 생성(노이즈 함수, 프랙탈), WebGL2 이식 규칙을 배웁니다. GPU 성능 제약(Ray March 128스텝 이하, FBM 6옥타브 이하)을 준수하는 방법도 포함됩니다.
Jetpack Compose의 선언적 UI와 Kotlin 코루틴, SwiftUI + UIKit 혼용, 접근성(4.5:1 대비율, 48dp 터치 타겟)을 배웁니다.
MiniMax API로 텍스트→이미지, 이미지→비디오 생성, ffmpeg로 MP4→GIF 변환, 4개 비디오 변환의 병렬 처리, 다국어 캡션 자동화를 배웁니다.
| 스킬 | 추가 의존성 |
|---|---|
| gif-sticker-maker | Python 3.x, ffmpeg, MINIMAX_API_KEY |
| minimax-pdf | Python 3.9+, Node.js 18+, reportlab, pypdf, Playwright |
| minimax-docx | .NET SDK + OpenXML SDK 3.2+ |
| pptx-generator | Node.js + PptxGenJS |
| minimax-xlsx | Python + pandas (읽기), 내장 XML 조작 스크립트 (생성/편집) ※ openpyxl round-trip 비권장 |
| shader-dev | WebGL2 지원 브라우저 |
| 기본 스킬 사용 | AI 코딩 에이전트(Claude Code 등) + Git |
MiniMax-AI/skills의 스킬 구조를 참고해 자신만의 도메인 스킬을 작성합니다. 트리거 조건 정의, 5단계 워크플로우 설계, 코드 예시 3개 이상 포함, 안티패턴 목록 작성이 목표입니다. skills/fullstack-dev/SKILL.md를 템플릿으로 활용하세요.
fullstack-dev 스킬의 가이드를 따라 간단한 Todo API + React 프론트엔드를 구축합니다. Feature-First 구조, 3계층 아키텍처, JWT 인증 + 자동 토큰 갱신, React Query API 클라이언트, /health·/ready 엔드포인트, Graceful Shutdown 구현이 체크리스트입니다.
직접 작성한 SKILL.md를 Claude Code 플러그인으로 패키징합니다. .claude-plugin/plugin.json과 marketplace.json을 작성하고, GitHub에 푸시한 후 claude plugin marketplace add로 설치 테스트를 완료합니다.
shader-dev 스킬의 WebGL2 이식 가이드를 따라 ShaderToy에서 셰이더를 독립 HTML 파일로 변환합니다. 인터랙티브 파라미터 컨트롤을 추가하고 128스텝 이하 성능 제약을 준수합니다.
gif-sticker-maker의 4단계 워크플로우를 MiniMax API 대신 오픈소스 모델로 구현합니다. Stable Diffusion → AnimateDiff(병렬 처리) → ffmpeg MP4→GIF → 로컬라이즈드 캡션 오버레이 순서로 진행합니다.
| 주차 | 학습 내용 |
|---|---|
| 1주차 | MiniMax-AI/skills 전체 구조 파악 · Claude Code 플러그인 시스템 문서 정독(plugin.json 규격) · 자신만의 SKILL.md 초안 작성 · 설치 테스트 + 피드백 반영 |
| 2주차 | fullstack-dev 스킬 전체 정독(13개 섹션) · 3계층 아키텍처 + DI 패턴(TypeScript) · JWT 인증 흐름 + 자동 갱신 · SSE 실시간 알림 시스템 구축 |
| 3주차 | reportlab 기초(Python PDF 생성) · Playwright HTML→PDF 렌더링 · OpenXML SDK로 Word 문서 구조 이해 · PptxGenJS로 프레젠테이션 생성 |
| 4주차 | GLSL 기초(Fragment Shader, Uniform) · SDF 기본(원, 박스, 부울 연산) · Ray Marching 구현 · ShaderToy→HTML 이식 실습 |
| 키워드 | 설명 |
|---|---|
| AI Agent Skill | AI 코딩 에이전트에게 특정 도메인 전문성을 부여하는 프롬프트+가이드+코드 패키지. SKILL.md 형식으로 정의 |
| Plugin Manifest | 에이전트 플랫폼이 스킬을 발견하고 로드하기 위한 설정 파일(plugin.json) |
| Progressive Disclosure | 정보를 계층적으로 구성해 필요한 만큼만 로드하는 패턴. 토큰 비용 절감에 핵심 |
| Feature-First Structure | 코드를 기술 레이어(controllers/, models/)가 아닌 기능 단위(orders/, users/)로 조직하는 구조 |
| 3-Layer Architecture | Controller(HTTP) → Service(비즈니스 로직) → Repository(데이터 접근)의 관심사 분리 패턴 |
| Gate-Check Pattern | 출력물 배포 전 품질 검증을 강제하는 패턴. XSD 스키마, 빌드 체크 등 |
| SDF | Signed Distance Function. 공간의 각 점에서 가장 가까운 표면까지의 부호 있는 거리. 셰이더에서 3D 형체 정의에 사용 |
| Ray Marching | 광선을 SDF 값만큼 전진시키며 장면과 교차점을 찾는 3D 렌더링 기법 |
| reportlab | Python에서 PDF를 프로그래밍 방식으로 생성하는 라이브러리 |
| OpenXML SDK | Microsoft Office 문서(DOCX, XLSX, PPTX)의 XML 구조를 직접 조작하는 .NET 라이브러리 |
| PptxGenJS | JavaScript로 PowerPoint 파일을 생성하는 라이브러리 |
| MiniMax API | MiniMax에서 제공하는 AI 모델 API. 텍스트→이미지, 이미지→비디오 생성 기능 포함 |
| tRPC | TypeScript 프로젝트에서 백엔드↔프론트엔드 간 자동 타입 안전성을 제공하는 RPC 프레임워크 |
| SSE | Server-Sent Events. 서버→클라이언트 단방향 실시간 데이터 스트리밍. AI 응답 스트리밍에 적합 |
| Jetpack Compose | Android의 선언적 UI 프레임워크. React와 유사한 컴포넌트 기반 패러다임 |