2026년, AI 코딩 어시스턴트는 '채팅 자동완성'에서 오케스트레이션 가능한 Agent 워크플로로 진화했습니다. Claude Code Skills(Anthropic 터미널 Agent)와 Cursor Agent Skills(IDE 내장 Agent)는 동일한 SKILL.md 사양을 공유합니다 — Markdown 파일로 AI에게 '특정 시나리오에서 어떻게 동작할지'를 가르칩니다.
매번 대화에서 '팀 PR 리뷰 기준으로 코드를 확인해 주세요'를 붙여넣고 있다면, 그 지시를 Skill에 한 번 작성해 영구적으로 재사용하세요. 본 글은 120개 이상의 즉시 사용 가능한 Skill 이름과 트리거 시나리오, 그리고 8개의 복사-붙여넣기 템플릿을 제공하여 코드 리뷰부터 DevOps까지 전체 개발 파이프라인을 다룹니다.
120+
카테고리별 Skill 예시
8
복사 가능한 SKILL.md 골격
12
코드 리뷰 · 테스트 · DevOps · 보안…
Skills란? Rules / MCP와 어떻게 역할을 나누나?
메커니즘
저장 위치
트리거
적합한 시나리오
Rules
.cursor/rules/ 또는 프로젝트 루트 AGENTS.md
항상 컨텍스트에 포함
코딩 스타일, 명명 규칙, 금지 사항
Skills
~/.cursor/skills/ 또는 .cursor/skills/
Agent가 description 의미 매칭 후 로드
다단계 워크플로, 도메인 전문 지식
MCP
외부 서비스 연결
Agent가 도구 API 호출
DB 쿼리, 브라우저, CI 시스템
한 줄 요약: Rules는 기준을, Skills는 방법을, MCP는 도구를 연결합니다.
Claude Code Skills는 보통 ~/.claude/skills/(개인) 또는 프로젝트 내 .claude/skills/에 둡니다. Cursor는 ~/.cursor/skills/와 .cursor/skills/를 사용합니다. 형식은 호환되며 본 글의 템플릿을 그대로 재사용할 수 있습니다.
2026년 주요 변화
Cursor는 2026년 초 Agent Skills를 실험 기능에서 정식 기능으로 승격했으며, 프로젝트·개인 Skills 병행을 지원합니다. Claude Code도 동일한 YAML frontmatter 사양을 채택했습니다. 두 도구가 같은 Skill 저장소를 공유할 수 있습니다.
---
name: my-skill-name
description: 3인칭으로 WHAT과 WHEN을 명확히 기술. Agent 발견용 키워드 포함.
---
# My Skill Name
## 단계
1. 첫 번째 구체적 작업
2. 두 번째 구체적 작업
## 출력 형식
기대하는 출력 구조를 설명.
frontmatter 필수 필드
필드
요구사항
설명
name
≤64자, 소문자/숫자/하이픈
고유 식별자
description
≤1024자, 3인칭
Agent가 이 Skill 로드 여부를 판단
모범 사례 (2026)
간결하게: Agent는 이미 똑똑하므로 모르는 정보만 작성
description이 핵심: WHAT + WHEN과 트리거 키워드 명시
본문 ≤500줄: 상세 내용은 reference.md로 분리
실행 가능한 단계: 번호 목록 사용, 모호한 표현 지양
~/.cursor/skills-cursor/에 생성 금지: Cursor 내장 Skill 예약 디렉터리
120+ Skill 빠른 참조
12개 카테고리로 정리한 120개 즉시 사용 Skill 이름, 트리거 시나리오, 권장 description 키워드입니다. 이름을 복사해 디렉터리를 만들고 맞춤 설정하세요.
1. 코드 리뷰 및 품질(10)
#
Skill 이름
트리거 시나리오
description 키워드
1
code-review
PR / diff 리뷰
pull request, code review, diff
2
security-review
보안 취약점 스캔
security, vulnerability, OWASP
3
performance-review
성능 핫스팟 분석
performance, bottleneck, profiling
4
refactor-suggest
리팩터링 제안
refactor, clean code, smell
5
api-design-review
API 설계 리뷰
REST, API design, endpoint
6
typescript-strict
TS 타입 안전 리뷰
TypeScript, type safety, strict
7
react-patterns
React 컴포넌트 리뷰
React, hooks, component
8
go-idioms
Go 관용구 검사
Go, idioms, error handling
9
python-pep8
Python 스타일 리뷰
Python, PEP8, lint
10
accessibility-audit
a11y 접근성 감사
accessibility, WCAG, a11y
2. Git 및 버전 관리(10)
#
Skill 이름
트리거 시나리오
description 키워드
11
commit-message
규약적 commit 생성
commit message, conventional commits
12
changelog-writer
CHANGELOG 작성
changelog, release notes
13
branch-naming
브랜치 명명 제안
branch, git flow
14
merge-conflict
머지 충돌 해결
merge conflict, rebase
15
git-blame-analysis
코드 변경 이력 추적
git blame, history
16
pr-description
PR 설명 작성
pull request description
17
squash-commits
커밋 히스토리 정리
squash, interactive rebase
18
git-hooks-setup
pre-commit 설정
git hooks, pre-commit, husky
19
monorepo-workflow
Monorepo 브랜치 전략
monorepo, turborepo, nx
20
release-tagging
시맨틱 버전 태깅
semver, release, tagging
3. 테스트(10)
#
Skill 이름
트리거 시나리오
description 키워드
21
unit-test-writer
단위 테스트 생성
unit test, jest, pytest
22
integration-test
통합 테스트 골격
integration test, e2e setup
23
test-coverage
커버리지 분석 및 보완
coverage, untested paths
24
mock-factory
mock 데이터 생성
mock, fixture, factory
25
snapshot-test
스냅샷 테스트 유지
snapshot, visual regression
26
playwright-e2e
Playwright E2E 스크립트
Playwright, browser test
27
api-contract-test
API 계약 테스트
contract test, OpenAPI
28
load-test-k6
k6 부하 테스트 스크립트
load test, k6, performance
29
mutation-test
뮤테이션 테스트 분석
mutation testing, stryker
30
test-flaky-debug
불안정 테스트 디버깅
flaky test, intermittent failure
4. DevOps 및 CI/CD(10)
#
Skill 이름
트리거 시나리오
description 키워드
31
dockerfile-optimize
Dockerfile 최적화
Dockerfile, multi-stage, image size
32
github-actions
GitHub Actions workflow 작성
GitHub Actions, CI pipeline
33
gitlab-ci
GitLab CI 설정
GitLab CI, .gitlab-ci.yml
34
kubernetes-manifest
K8s YAML 생성
Kubernetes, deployment, helm
35
terraform-module
Terraform 모듈 작성
Terraform, IaC, HCL
36
ansible-playbook
Ansible playbook
Ansible, provisioning
37
nginx-config
Nginx 리버스 프록시 설정
nginx, reverse proxy, SSL
38
monitoring-setup
Prometheus/Grafana 설정
monitoring, Prometheus, alerting
39
log-analysis
로그 패턴 분석
logs, ELK, structured logging
40
rollback-runbook
롤백 운영 매뉴얼
rollback, incident, runbook
5. 보안(10)
#
Skill 이름
트리거 시나리오
description 키워드
41
owasp-top10
OWASP Top 10 점검
OWASP, injection, XSS
42
secrets-scan
시크릿 유출 스캔
secrets, API key, credential
43
dependency-audit
의존성 취약점 감사
npm audit, CVE, Snyk
44
auth-review
인증·인가 리뷰
OAuth, JWT, RBAC
45
sql-injection
SQL 인젝션 탐지
SQL injection, parameterized query
46
cors-csp-config
CORS/CSP 헤더 설정
CORS, CSP, security headers
47
pen-test-report
침투 테스트 보고서
penetration test, finding
48
gdpr-compliance
GDPR 컴플라이언스 점검
GDPR, privacy, PII
49
ssl-tls-config
TLS 설정 리뷰
TLS, certificate, HTTPS
50
sbom-generator
SBOM 생성
SBOM, supply chain
6. 문서 및 기술 글쓰기(10)
#
Skill 이름
트리거 시나리오
description 키워드
51
readme-writer
README 생성
README, project documentation
52
api-docs-openapi
OpenAPI 문서 생성
OpenAPI, Swagger, API docs
53
adr-writer
아키텍처 결정 기록
ADR, architecture decision
54
inline-comments
코드 주석 추가
code comments, docstring
55
migration-guide
버전 마이그레이션 가이드
migration, upgrade guide
56
onboarding-doc
온보딩 문서
onboarding, getting started
57
runbook-writer
운영 매뉴얼 작성
runbook, SOP, operations
58
tech-blog-post
기술 블로그 작성
blog post, technical writing
59
mermaid-diagram
Mermaid 아키텍처 다이어그램
Mermaid, diagram, flowchart
60
javadoc-jsdoc
API 주석 생성
JSDoc, JavaDoc, Sphinx
7. 데이터베이스(10)
#
Skill 이름
트리거 시나리오
description 키워드
61
sql-optimize
SQL 쿼리 최적화
SQL, query plan, index
62
migration-sql
DB 마이그레이션 스크립트
migration, ALTER TABLE, Flyway
63
schema-design
테이블 스키마 설계
schema, normalization, ER diagram
64
postgres-tuning
PostgreSQL 튜닝
PostgreSQL, vacuum, EXPLAIN
65
redis-patterns
Redis 사용 패턴
Redis, cache, pub/sub
66
mongodb-schema
MongoDB 문서 설계
MongoDB, document model
67
prisma-schema
Prisma schema 작성
Prisma, ORM, schema.prisma
68
data-seed
시드 데이터 생성
seed data, fixture, faker
69
backup-restore
백업·복원 스크립트
backup, restore, pg_dump
70
etl-pipeline
ETL 파이프라인 설계
ETL, data pipeline, dbt
8. 프론트엔드 개발(10)
#
Skill 이름
트리거 시나리오
description 키워드
71
react-component
React 컴포넌트 스캐폴딩
React component, JSX
72
vue-composable
Vue Composable 작성
Vue 3, composable, Pinia
73
tailwind-styling
Tailwind CSS 스타일링
Tailwind, utility CSS
74
css-responsive
반응형 레이아웃
responsive, mobile-first, media query
75
state-management
상태 관리 방안 선정
Redux, Zustand, state
76
nextjs-app-router
Next.js App Router
Next.js, RSC, app router
77
i18n-setup
국제화 설정
i18n, localization, react-intl
78
storybook-story
Storybook 스토리 작성
Storybook, component story
79
bundle-optimize
번들 크기 최적화
bundle size, tree shaking, code split
80
form-validation
폼 검증 로직
form, validation, zod, yup
9. 백엔드 및 API(10)
#
Skill 이름
트리거 시나리오
description 키워드
81
rest-api-design
RESTful API 설계
REST, endpoint, HTTP methods
82
graphql-schema
GraphQL schema 정의
GraphQL, resolver, schema
83
grpc-protobuf
gRPC / Protobuf
gRPC, protobuf, service definition
84
express-middleware
Express 미들웨어
Express, middleware, Node.js
85
fastapi-endpoint
FastAPI 라우트
FastAPI, Python, Pydantic
86
error-handling
통합 오류 처리
error handling, exception, status code
87
rate-limiting
속도 제한 구현
rate limit, throttle, token bucket
88
webhook-handler
Webhook 수신 처리
webhook, event, signature verify
89
background-job
백그라운드 작업 큐
queue, Celery, BullMQ, Sidekiq
90
microservice-split
마이크로서비스 분리 제안
microservice, bounded context, DDD
10. AI / LLM 통합(10)
#
Skill 이름
트리거 시나리오
description 키워드
91
prompt-engineering
Prompt 최적화
prompt, LLM, few-shot
92
rag-pipeline
RAG 파이프라인 구축
RAG, embedding, vector store
93
agent-orchestration
멀티 Agent 오케스트레이션
agent, orchestration, tool use
94
mcp-server
MCP Server 개발
MCP, model context protocol
95
llm-eval
LLM 출력 평가
evaluation, benchmark, LLM judge
96
token-optimize
Token 사용량 최적화
token, context window, cost
97
fine-tune-guide
파인튜닝 가이드
fine-tune, LoRA, training data
98
embedding-search
시맨틱 검색 구현
embedding, semantic search, FAISS
99
guardrails
AI 출력 가드레일
guardrails, content filter, safety
100
function-calling
Function Calling 구현
function calling, tool use, OpenAI
11. 모바일 및 크로스플랫폼(10)
#
Skill 이름
트리거 시나리오
description 키워드
101
swiftui-view
SwiftUI 뷰 작성
SwiftUI, iOS, view
102
kotlin-compose
Jetpack Compose UI
Compose, Android, Kotlin
103
react-native-screen
RN 화면 개발
React Native, mobile screen
104
flutter-widget
Flutter Widget
Flutter, Dart, widget
105
app-store-submit
App Store 제출 절차
App Store, TestFlight, submission
106
push-notification
푸시 알림 통합
push notification, APNs, FCM
107
deep-linking
Deep Link 설정
deep link, universal link
108
offline-first
오프라인 우선 아키텍처
offline, sync, local storage
109
app-perf-profile
모바일 성능 프로파일링
Instruments, Android Profiler
110
ci-mobile-build
모바일 CI 빌드
Fastlane, Xcode Cloud, mobile CI
12. 프로젝트 관리 및 협업(10)
#
Skill 이름
트리거 시나리오
description 키워드
111
sprint-planning
스프린트 계획 지원
sprint, planning, estimation
112
ticket-breakdown
요구사항 ticket 분해
ticket, user story, breakdown
113
retro-facilitator
회고 미팅 진행
retrospective, retro, team
114
incident-postmortem
사고 포스트모템
postmortem, incident, RCA
115
tech-debt-audit
기술 부채 감사
tech debt, prioritization
116
rfc-review
RFC 설계 리뷰
RFC, design proposal, review
117
estimation-poker
스토리 포인트 추정
estimation, story points, planning poker
118
standup-summary
스탠드업 요약 생성
standup, daily sync, summary
119
okr-alignment
OKR 정렬 점검
OKR, goal alignment
120
handoff-checklist
프로젝트 인수인계 체크리스트
handoff, knowledge transfer
8개 복사 가능한 SKILL.md 템플릿
아래를 .cursor/skills/<name>/SKILL.md 또는 ~/.claude/skills/<name>/SKILL.md에 복사해 맞춤 설정하세요.
템플릿 1: 코드 리뷰
---
name: code-review
description: Review code changes for quality, security, and best practices. Use when reviewing pull requests, diffs, or when the user asks for a code review.
---
# Code Review
## Checklist
1. Read the full diff before commenting
2. Check for security issues (injection, XSS, secrets)
3. Verify error handling on all external calls
4. Confirm tests cover new logic
5. Flag breaking API changes
## Output Format
- **Critical**: must fix before merge
- **Suggestion**: optional improvement
- **Praise**: well-done patterns worth keeping
템플릿 2: Commit Message
---
name: commit-message
description: Generate descriptive commit messages following Conventional Commits. Use when the user asks to write commit messages or review staged changes.
---
# Commit Message Generator
## Format
`<type>(<scope>): <subject>`
Types: feat, fix, docs, style, refactor, test, chore
## Rules
- Subject ≤ 72 characters, imperative mood
- Body explains WHY, not WHAT
- Reference issue numbers when applicable
템플릿 3: 단위 테스트
---
name: unit-test-writer
description: Write unit tests for given code using the project's existing test framework. Use when the user asks to add tests, improve coverage, or test a function.
---
# Unit Test Writer
## Steps
1. Identify the project's test framework (Jest, pytest, Go test, etc.)
2. Read existing test files for patterns and conventions
3. Cover: happy path, edge cases, error paths
4. Use descriptive test names: `should_<expected>_when_<condition>`
5. Mock external dependencies, not the unit under test
템플릿 4: Dockerfile 최적화
---
name: dockerfile-optimize
description: Optimize Dockerfiles for smaller image size, faster builds, and security. Use when working with Docker, containerization, or image optimization.
---
# Dockerfile Optimizer
## Checklist
- Use multi-stage builds
- Pin base image versions (no `latest`)
- Run as non-root user
- Combine RUN layers, clean package caches
- Use .dockerignore
- Scan for known CVEs in base image
템플릿 5: 보안 리뷰
---
name: security-review
description: Review code for security vulnerabilities following OWASP guidelines. Use when the user asks for security review, vulnerability scan, or before deploying to production.
---
# Security Review
## OWASP Top 10 Check
1. Injection (SQL, command, LDAP)
2. Broken authentication
3. Sensitive data exposure
4. XXE / deserialization
5. Broken access control
6. Security misconfiguration
7. XSS
8. Insecure deserialization
9. Known vulnerable components
10. Insufficient logging
## Output
Severity: Critical / High / Medium / Low / Info
Include: location, impact, remediation
템플릿 6: API 문서
---
name: api-docs-openapi
description: Generate or update OpenAPI/Swagger documentation from code. Use when documenting REST APIs, generating API specs, or working with OpenAPI files.
---
# API Documentation
## Steps
1. Scan route handlers for endpoints, methods, params
2. Generate OpenAPI 3.1 YAML with request/response schemas
3. Add examples for each endpoint
4. Document error responses (4xx, 5xx)
5. Include authentication requirements
템플릿 7: 데이터베이스 마이그레이션
---
name: migration-sql
description: Write database migration scripts with rollback support. Use when altering database schema, adding tables, or writing Flyway/Liquibase migrations.
---
# Database Migration
## Rules
- Every UP migration must have a DOWN (rollback)
- Never drop columns in production without deprecation period
- Add indexes CONCURRENTLY on PostgreSQL
- Test migration on a copy of production data
- Name: `V{version}__{description}.sql`
템플릿 8: MCP Server 개발
---
name: mcp-server
description: Build MCP (Model Context Protocol) servers for tool integration. Use when creating MCP servers, connecting external tools to AI agents, or working with the MCP SDK.
---
# MCP Server Builder
## Structure
- Define tools with JSON Schema input/output
- Implement handlers with proper error responses
- Add authentication if connecting to external APIs
- Test with `npx @modelcontextprotocol/inspector`
- Document each tool's purpose and parameters
설치 및 사용
Cursor
생성: .cursor/skills/my-skill/SKILL.md(프로젝트) 또는 ~/.cursor/skills/my-skill/SKILL.md(개인)
Agent 채팅에서 시나리오 언급 — Agent가 description을 매칭해 Skill 로드
명시적 호출: /my-skill-name 또는 프롬프트에서 @my-skill
Claude Code
생성: ~/.claude/skills/my-skill/SKILL.md
터미널에서 작업 설명 — Agent 자동 매칭
프로젝트 Skill은 .claude/skills/에 두고 Git 커밋 가능
팀 공유 모범 사례
.cursor/skills/를 버전 관리에 포함
README.md에 사용 가능한 Skills와 트리거 나열
Skill마다 examples.md로 기대 입출력 추가
신규 팀원 합류 시 description 표현 검토
고급 팁
여러 Skill을 연결: 먼저 security-review로 스캔하고, unit-test-writer로 테스트를 보완한 뒤, commit-message로 커밋을 생성합니다. Skill 체이닝은 2026년 본격 Agent 워크플로의 핵심 패턴입니다.
개발 환경 기반도 중요합니다
Skill이 아무리 강력해도 적절한 하드웨어와 OS에서 실행되어야 합니다. iOS 관련 Skill(swiftui-view, app-store-submit)은 macOS + Xcode가 필수이며, 대규모 monorepo code-review Skill에는 충분한 메모리와 디스크 I/O가 필요합니다.
Claude Code나 Cursor Agent와 함께 쓸 완전한 클라우드 macOS 개발 환경이 필요하다면, Kvmzen Mac 클라우드 렌탈에서 전용 Mac mini M4를 월 단위로 이용할 수 있으며, 본 글의 모든 Skill 템플릿과 원활히 연동됩니다.