https://github.com/iceflower/agent-skills
Agent Skills 오픈 표준 기반 AI 코딩 에이전트용 스킬 컬렉션 (Java, Kotlin, Spring, NestJS, K8s, Terraform, GraphQL, gRPC, OpenTelemetry, a11y, i18n 등 60개)
https://github.com/iceflower/agent-skills
agent-skills ai-coding argocd claude-code gitops helm incident-response kubernetes opencode security spring terraform
Last synced: 3 months ago
JSON representation
Agent Skills 오픈 표준 기반 AI 코딩 에이전트용 스킬 컬렉션 (Java, Kotlin, Spring, NestJS, K8s, Terraform, GraphQL, gRPC, OpenTelemetry, a11y, i18n 등 60개)
- Host: GitHub
- URL: https://github.com/iceflower/agent-skills
- Owner: iceflower
- License: mit
- Created: 2026-03-17T10:49:59.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-24T14:13:05.000Z (4 months ago)
- Last Synced: 2026-03-25T09:38:40.240Z (4 months ago)
- Topics: agent-skills, ai-coding, argocd, claude-code, gitops, helm, incident-response, kubernetes, opencode, security, spring, terraform
- Language: Python
- Size: 903 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Security: security/README.md
Awesome Lists containing this project
README
# Agent Skills
[Agent Skills 오픈 표준](https://agentskills.io) 기반의 AI 코딩 에이전트용 스킬 컬렉션입니다.
## 개요
이 저장소는 Java, Kotlin, Spring, NestJS, Kubernetes, Terraform 등 다양한 기술 스택에 대한 **61개 스킬**을 포함하고 있습니다. 관련 스킬은 `references/` 하위 디렉토리를 활용하여 하나의 스킬로 통합되어 있으며, 메타 스킬(`index`)을 통해 카테고리별 라우팅을 제공합니다.
## 호환 도구
| 도구 | 전역 경로 | 프로젝트 경로 |
| ---- | --------- | ------------- |
| **OpenCode** | `~/.agents/skills/` | `.agents/skills/` |
| **Codex** | `~/.agents/skills/` | `.agents/skills/` |
| **Claude Code** | `~/.claude/skills/` | `.claude/skills/` |
| **Antigravity** | `~/.gemini/antigravity/skills/` | `.agents/skills/` |
## 설치
### 전역 설치 (모든 프로젝트에서 사용)
```bash
# 표준 경로에 클론
git clone https://github.com/iceflower/agent-skills.git ~/.agents/skills
# Claude Code용 심볼릭 링크 (필요시)
ln -s ~/.agents/skills ~/.claude/skills
# Antigravity용 심볼릭 링크 (필요시)
mkdir -p ~/.gemini/antigravity
ln -s ~/.agents/skills ~/.gemini/antigravity/skills
```
### 프로젝트 설치 (특정 프로젝트에서만 사용)
```bash
# 프로젝트 루트에서
git clone https://github.com/iceflower/agent-skills.git .agents/skills
```
## 스킬 목록
### Spring & Spring Boot
| 스킬 | 설명 |
| ---- | ---- |
| [spring-framework](./spring-framework/) | Spring Framework 핵심 (IoC, MVC, WebFlux, JPA, Config) + Spring Boot 구현 패턴 + 버전 마이그레이션 가이드 |
| [spring-ai](./spring-ai/) | Spring AI (ChatClient, Tool Calling, Prompt Template, Vector Store, RAG, MCP 통합) |
### Java & Kotlin
| 스킬 | 설명 |
| ---- | ---- |
| [java-convention](./java-convention/) | Java 코딩 컨벤션 + 버전 마이그레이션 가이드 (8 → 25) |
| [kotlin-convention](./kotlin-convention/) | Kotlin 코딩 컨벤션 + 버전 마이그레이션 가이드 (1.4 → 2.3) |
| [java-kotlin-interop](./java-kotlin-interop/) | Java-Kotlin 상호 운용 가이드 (JSpecify, JVM 어노테이션) |
| [jvm-performance](./jvm-performance/) | JVM 성능 튜닝 (GC 알고리즘, 힙 분석, 프로파일링) |
| [concurrency](./concurrency/) | JVM 동시성 (스레드 안전, Executor, CompletableFuture, 코루틴) |
### 데이터베이스
| 스킬 | 설명 |
| ---- | ---- |
| [database](./database/) | 데이터베이스 공통 규칙 + MySQL/PostgreSQL 특화 가이드 + 동시성 제어/백업/복제/CDC |
| [data-migration](./data-migration/) | 데이터 마이그레이션 / ETL 패턴 (Zero-downtime, Dual-Write, gh-ost, CDC) |
| [exposed](./exposed/) | JetBrains Exposed ORM (DSL, DAO, 트랜잭션 관리) |
### 인프라 & 배포
| 스킬 | 설명 |
| ---- | ---- |
| [terraform-workflow](./terraform-workflow/) | Terraform 워크플로우 + AWS/Azure/GCP 프로바이더 가이드 |
| [k8s-workflow](./k8s-workflow/) | Kubernetes 매니페스트 + 관리형 K8s + 오토스케일링 + 네트워킹/스토리지/RBAC/배포 전략 |
| [karpenter-workflow](./karpenter-workflow/) | Karpenter 워크플로우 + 클라우드 프로바이더별 설정 |
| [helm-workflow](./helm-workflow/) | Helm 차트 개발 (차트 구조, 값 설계, 템플릿, 훅, 테스트) |
| [gitops-argocd](./gitops-argocd/) | GitOps 워크플로우 (Argo CD, ApplicationSet, 동기화 전략, 프로그레시브 딜리버리) |
| [dockerfile](./dockerfile/) | Dockerfile 작성 규칙 (멀티스테이지, JVM 패턴, BuildKit, 멀티아키텍처) |
| [ci-cd](./ci-cd/) | GitHub Actions 기반 CI/CD 파이프라인 패턴 |
| [devcontainer](./devcontainer/) | Dev Containers 설정 (devcontainer.json, Features, Docker Compose, Codespaces) |
| [feature-flag](./feature-flag/) | Feature Flag / Progressive Delivery (OpenFeature, Toggle 분류, Canary + Feature Flag) |
### 아키텍처 & 설계
| 스킬 | 설명 |
| ---- | ---- |
| [clean-architecture](./clean-architecture/) | 클린 아키텍처 / 헥사고날 아키텍처 (포트 & 어댑터) |
| [microservices](./microservices/) | 마이크로서비스 (서비스 분해, Saga, CQRS, API Gateway, Circuit Breaker) |
| [ddd](./ddd/) | 도메인 주도 설계 (엔티티, 애그리거트, 바운디드 컨텍스트) |
| [event-storming](./event-storming/) | 이벤트 스토밍 워크샵 (스티커 규칙, 퍼실리테이션, DDD 전환) |
| [object-oriented-design](./object-oriented-design/) | 객체지향 설계 원칙 (SOLID, 합성 우선) |
| [system-design](./system-design/) | 대규모 시스템 설계 + 분산 시스템 패턴 + 안정성 패턴 (복제, 파티셔닝, 합의, Circuit Breaker) |
| [cloud-native](./cloud-native/) | 12-Factor App / Cloud Native 패턴 (15-Factor, Well-Architected Framework) |
### TypeScript & 프론트엔드
| 스킬 | 설명 |
| ---- | ---- |
| [typescript-convention](./typescript-convention/) | TypeScript 타입 시스템 (타입 가드, 제네릭, 유틸리티 타입, 코딩 컨벤션) |
| [nestjs-convention](./nestjs-convention/) | NestJS 프레임워크 컨벤션 (모듈, DI, Guard, Interceptor, Pipe, Prisma/TypeORM) |
| [react-convention](./react-convention/) | React/Next.js 코딩 컨벤션 (컴포넌트 패턴, Hooks, 상태 관리, 성능 최적화) |
| [a11y](./a11y/) | 웹 접근성 (WCAG 2.2 AA, ARIA 패턴, 키보드 접근성, axe-core 테스트) |
| [localization](./localization/) | 다국어/i18n (ICU Message Format, react-intl/i18next, RTL 지원, Intl API) |
| [performance-optimization](./performance-optimization/) | 성능 최적화 (Core Web Vitals, 번들 최적화, DB 튜닝, 캐싱, 성능 버짓) |
### 코드 품질 & 테스트
| 스킬 | 설명 |
| ---- | ---- |
| [code-quality](./code-quality/) | 코드 품질 6대 원칙 + 리팩토링 기법 |
| [code-review](./code-review/) | 코드 리뷰 체크리스트 및 코멘트 가이드 |
| [testing](./testing/) | BDD 단위 테스트 + 통합 테스트 (Testcontainers) + 계약 테스트 + 성능 테스트 |
| [load-testing](./load-testing/) | 부하 테스트 (k6, Gatling, CI 통합, 메트릭, 임계값 가이드) |
| [error-handling](./error-handling/) | 에러 처리 패턴 (예외 계층, 에러 분류, 응답 포맷) |
### 보안
| 스킬 | 설명 |
| ---- | ---- |
| [security](./security/) | 보안 규칙 (입력 검증, OWASP Top 10, CORS) + 인증/인가 (JWT, OAuth2, MFA) + 웹 보호 (CSRF, XSS, TLS) |
| [secrets-management](./secrets-management/) | 시크릿 관리 (Vault, ESO, Sealed Secrets, 인증서, 탐지/방지) |
### 운영 & 모니터링
| 스킬 | 설명 |
| ---- | ---- |
| [logging](./logging/) | 로깅 표준 (로그 레벨, 구조화 로깅, 민감 데이터 마스킹) |
| [observability](./observability/) | 옵저버빌리티 통합 (메트릭, 트레이싱, 알림, OTel SDK, OTLP, Collector, 헬스체크) |
| [caching](./caching/) | 캐시 전략 (TTL, 무효화, Stampede 방지) |
| [messaging](./messaging/) | 비동기 메시징 (Kafka, RabbitMQ, NATS, Pulsar) |
| [troubleshooting](./troubleshooting/) | 트러블슈팅 가이드 (느린 API, 배포 롤백, 연결 문제) |
| [chaos-engineering](./chaos-engineering/) | 카오스 엔지니어링 (장애 주입, Game Day) |
| [incident-response](./incident-response/) | 인시던트 대응 (심각도 분류, 커뮤니케이션, 런북, 포스트모템) |
### 메타 스킬
| 스킬 | 설명 |
| ---- | ---- |
| [index](./index/) | 스킬 라우팅 인덱스 (카테고리별/도메인별/작업 유형별 스킬 탐색 가이드) |
### 기타
| 스킬 | 설명 |
| ---- | ---- |
| [git-workflow](./git-workflow/) | Git 커밋 컨벤션 및 브랜치 전략 |
| [gradle-convention](./gradle-convention/) | Gradle 빌드 컨벤션 (멀티모듈, 버전 카탈로그) |
| [http-client](./http-client/) | 외부 API 클라이언트 (타임아웃, 재시도, Circuit Breaker) |
| [api-design](./api-design/) | REST API 설계 원칙 (URL, 상태 코드, 버전 관리) |
| [api-versioning](./api-versioning/) | API 버전 관리 심화 (전략 선택, Deprecation RFC, Expand-and-Contract, Gateway 라우팅) |
| [graphql](./graphql/) | GraphQL API 설계 (스키마, Resolver, DataLoader, Federation, 보안) |
| [grpc](./grpc/) | gRPC 서비스 간 통신 (Proto3, Streaming, Interceptor, Service Mesh 통합) |
| [openapi-spec](./openapi-spec/) | OpenAPI 명세 작성 (스키마 설계, 코드 생성, 버전 관리) |
| [prompt-engineering](./prompt-engineering/) | LLM 프롬프트 설계 패턴 (Zero-shot, Few-shot, CoT, 안전성 가이드) |
| [resume-writing](./resume-writing/) | 개발자 이력서 작성 가이드 (STAR 메서드) |
| [pdf-handling](./pdf-handling/) | PDF 파일 읽기 및 처리 규칙 |
| [code-search](./code-search/) | 코드 탐색 전략 (ripgrep, ast-grep, git 검색, LSP, GitHub Code Search) |
| [weather](./weather/) | 기상청/AccuWeather 기반 날씨 정보 조회 |
| [technical-documentation](./technical-documentation/) | 기술 문서 작성 가이드 (품질 측정, 배포) |
## 디렉토리 구조
```text
/
├── SKILL.md # 스킬 정의 (필수)
├── references/ # 관련 참조 문서 (선택)
│ ├── migration.md
│ └── ...
├── assets/ # 템플릿, 정적 리소스 (선택)
│ ├── template.yaml
│ └── ...
└── scripts/ # 검증/린트 스크립트 (선택)
└── ...
```
각 `SKILL.md`는 YAML frontmatter(`name`, `description`, `license`, `metadata`)와 마크다운 본문으로 구성됩니다. 환경 요구사항이 있는 스킬은 `compatibility` 필드를 추가로 포함합니다. `references/` 디렉토리에는 관련된 세부 가이드가, `assets/` 디렉토리에는 템플릿 파일이 포함됩니다.
## 라이선스
MIT License