AI 코딩 에이전트에 꼭 달아줄 오픈소스 스킬 6종 — 실사용 후기

# AI 코딩 에이전트에 꼭 달아줄 오픈소스 스킬 6종 — 실사용 후기

> Claude Code, Cursor, ZCode 같은 AI 코딩 에이전트의 품질은 "어떤 모델"보다 "어떤 규칙을

> 달아줬는지"가 크게 좌우한다. 스킬(Skill)은 에이전트가 필요할 때 스스로 읽어 들이는 규칙

> 문서인데, 잘 고른 스킬 몇 개만 설치해도 diff가 깨끗해지고, 계획 허점이 구현 전에 드러나고,

> 세션이 끊겨도 작업이 이어진다. 실제로 설치해 써본 스킬 여섯 종을 소개한다 — 대부분

> MIT 라이선스 오픈소스다.

## 한눈에 보기

| 스킬 | 출처 | 한 줄 요약 | 발동 방식 |

|---|---|---|---|

| [karpathy-guidelines](#1-karpathy-guidelines--코딩-습관-교정기) | [multica-ai](https://github.com/multica-ai/andrej-karpathy-skills) | Karpathy 4원칙으로 코딩 실수 차단 | 자동 (코딩 시) |

| [frontend-design](#2-frontend-design--뻔한-ai-디자인-탈피기) | [anthropics](https://github.com/anthropics/skills) | "생성된 페이지 냄새" 나는 UI를 주제 맞춤형으로 | 자동 (UI 작업 시) |

| [grill-me / grilling](#3-grill-me--grilling--계획-면접관) | [mattpocock](https://github.com/mattpocock/skills) | 구현 전에 계획을 끝까지 추궁하는 면접 | 이름 호출 |

| [handoff](#4-handoff--세션-인계서-작성기) | mattpocock | 대화를 다음 세션용 인계 문서로 압축 | 이름 호출 |

| [wait-what](#5-wait-what--재설명-요청버튼) | mattpocock | 이해 안 되는 답변을 쉬운 말로 다시 | 이름 호출 |

| [claude-seo](#6-claude-seo--seo-전문-장비) | [AgriciDaniel](https://github.com/AgriciDaniel/claude-seo) | SEO 감사·AI 검색 대비 툴박스 26종 | 이름 호출 |

---

## 1. karpathy-guidelines — 코딩 습관 교정기

**출처**: [multica-ai/andrej-karpathy-skills](https://github.com/multica-ai/andrej-karpathy-skills) (MIT) · 단일 SKILL.md 67줄

전 테슬라 AI 디렉터 Andrej Karpathy가 지적한 LLM 코딩 함정 —

["모델은 대신 가정을 세우고 확인 없이 달려간다"](https://x.com/karpathy/status/2015883857489522876) —

를 4원칙으로 압축한 스킬. 설치해두면 코딩 작업 시 자동으로 참조된다.

| 원칙 | 요지 | 막는 실수 |

|---|---|---|

| Think Before Coding | 가정을 말로 하고, 불확실하면 묻고, 해석이 갈리면 제시 | 잘못된 가정으로 엉뚱한 구현 |

| Simplicity First | 요청받은 것의 최소 코드만. 추측성 기능·추상화 금지 | 50줄일 일을 300줄로 |

| Surgical Changes | 건드려야 할 곳만 수정. 옆 코드 "개선" 금지 | 무관한 코드 훼손 |

| Goal-Driven Execution | "버그 고쳐줘" → "재현 테스트 짜고 통과하게" 식으로 성공 기준 변환 | 검증 없는 완료 보고 |

이 스킬의 진짜 효용은 4원칙 자체보다 **지시문을 바꾸게 만드는 힘**에 있다. Karpathy의

원문처럼 — "LLM은 명확한 목표를 만족할 때까지 반복하는 데 탁월하다. 뭘 할지 말하지 말고

성공 기준을 주면 굴러간다."

작성자도 인정하는 트레이드오프는 **신중함 > 속도**라는 점. 오타 고치기 같은 사소한

작업까지 무겁게 가진 않도록 "사소한 작업은 재량" 단서가 들어 있다.

## 2. frontend-design — 뻔한 AI 디자인 탈피기

**출처**: [anthropics/skills](https://github.com/anthropics/skills)의 `skills/frontend-design` (Anthropic 공식 제공)

AI에게 랜딩 페이지를 만들라고 하면 왜 다 비슷하게 생겼을까. 크림 배경+세리프+테라코타

팔레트, 만능 SaaS 카드 그리드, 의미 없는 01/02/03 번호 — 스킬이 부르는 "생성된 페이지

냄새"다. 이 스킬은 UI·디자인 작업이 시작되면 자동으로 읽혀 다른 선택을 강제한다.

- 업계·소재·언어 같은 **주제 자체에서 디자인 선택을 끌어낸다** — 남들과 같은 기본값을 쓰지 않는다

- 작업 순서를 강제한다: 색상 4~6개·서체 역할·레이아웃·원칙으로 **토큰 시스템 먼저 설계**

  → "이거 뻔한 기본값 아닌가" 자체 검토 → 구현

- 굵은 표현(파격적 요소)은 한 곳에만 쓰고 나머지는 절제

- 모바일 대응·키보드 포커스·`prefers-reduced-motion` 같은 품질 하한도 요구 — 겉모습만

  그럴싸한 페이지가 안 나온다

기존 사이트 스타일이 있는 곳엔 기존 스타일이 우선이어야 하고, 이 스킬은 **신규 페이지·

독립 랜딩**에서 빛난다.

## 3. grill-me / grilling — 계획 면접관

**출처**: [mattpocock/skills](https://github.com/mattpocock/skills) (MIT) · `skills/productivity/` 하위 — grill-me는 껍데기, 실제 로직은 grilling

TypeScript 교육자 Matt Pocock이 만든 스킬군. 구현에 들어가기 전에 "이 계획, 괜찮은가?"

를 에이전트가 면접하듯 끝까지 추궁한다. 동작 방식이 영리하다:

1. 내 계획의 결정사항을 **설계 트리**로 매핑

2. 지금 답할 수 있는 질문 전체(**프론티어**)를 한 라운드에 번호 붙여 던지고, 각각 권장 답까지 제시

3. 답을 받으면 프론티어를 다시 계산해 다음 라운드

4. 프론티어가 비면 — 즉 남은 가정이 없으면 — 면접 종료

핵심 규칙: 조사할 **사실**은 에이전트가 스스로 찾고, **결정**만 사용자에게 물은다. 그리고

면접이 끝나도 사용자가 공유 이해를 확인하기 전에는 절대 구현에 들어가지 않는다.

- 쓰는 법: "리모트 예약 시스템 만들 계획인데 grill-me 돌려줘"

- 한 번 돌려보면 "당연하다고 여겼던 선택 10개"가 질문으로 돌아온다. 그 질문들에 답하는

  것만으로 계획 품질이 달라진다.

## 4. handoff — 세션 인계서 작성기

**출처**: mattpocock/skills (MIT)

에이전트 세션은 컨텍스트 한도에 닿거나 창을 닫으면 끊긴다. handoff는 지금까지의 대화를

**다음 세션이 바로 이어받을 수 있는 인계 문서**로 압축한다.

- 스펙·플랜·커밋처럼 다른 아티팩트에 이미 있는 내용은 복제하지 않고 **경로·URL로 참조**만 — 인계서가 또 하나의 방치 문서가 되는 걸 막는다

- API 키·비밀번호·개인정보는 마스킹

- 인수로 다음 세션의 용도를 주면 맞춤으로 써준다: "handoff — 다음 세션은 결제 모듈 리팩토링"

긴 작업 마무리나 "이 작업 동료(혹은 다른 에이전트)에게 넘겨야겠다" 할 때 호출한다.

다음 세션에선 "인계 문서 읽어서 이어가자" 한 줄이면 된다.

## 5. wait-what — 재설명 요청버튼

**출처**: mattpocock/skills (MIT)

가장 짧다. 답변이 복잡하게 꼬여 이해가 안 될 때 **`wait-what` 한 단어**를 쏘면, 에이전트가

멈추고 맥락을 정리해 다시 설명한다. 재설명 스타일도 정해져 있어 한 문장 한 의미, 능동태,

쉬운 단어의 단순 기술 문체(ASD-STE100 스타일)로 다시 쓴다. 프로젝트에 용어집(GLOSSARY.md)

이 있으면 그 용어를 쓴다.

- 쓰는 법: 답변이 계속 이해되지 않을 때 그냥 `wait-what`

- "다시 설명해줘"와 차이가 없어 보이지만, **무엇이 문제였는지 묻지 않아도** 형식·길이·

  어휘 수준을 정해서 다시 쓴다는 게 편하다. 리듬이 생긴다.

## 6. claude-seo — SEO 전문 장비

**출처**: [AgriciDaniel/claude-seo](https://github.com/AgriciDaniel/claude-seo) (MIT) · 허브 + 하위 스킬 26종 + 서브에이전트 19종

앞의 다섯은 "태도"를 바꾸는 스킬이라면, 이건 에이전트에 달아주는 **전문 장비**다. 사이트

전체 SEO 감사를 10~15분에 끝내며(최대 17개 에이전트 병렬), JS로 그려지는 페이지는 내장

헤드리스 브라우저(Chromium)로 렌더링해 분석한다. 요구 사항은 Claude Code 1.0.33 이상,

Python 3.11~3.14.

| 그룹 | 대표 기능 |

|---|---|

| 사이트 전체 | `audit`(점수·우선순위 리포트), `technical`(크롤링·인덱싱·Core Web Vitals), `sitemap` |

| 페이지·콘텐츠 | `page`, `content`(E-E-A-T), `schema`(구조화 데이터), `images` |

| AI 검색 신영역 | `geo`(AI Overviews·ChatGPT·Perplexity 인용 가능성), `agentic`(llms.txt·에이전트 접근성) |

| 전략·기획 | `plan`, `cluster`(키워드 클러스터링), `content-brief`, `programmatic` |

| 로컬·커머스 | `local`(GBP·리뷰), `ecommerce`, `hreflang`, `backlinks` |

| 데이터 연동 | GSC·PageSpeed·CrUX·GA4 실측, PDF 보고서 |

특히 `geo`와 `agentic`이 시대에 맞다. 검색 유입의 판이 "구글 1페이지"에서 "AI가 당신

사이트를 인용하는가"로 옮겨 가는 중이라, **생성엔진 최적화(GEO)** 와 AI 에이전트 접근성

진단이 별도 커맨드로 존재한다. 무료·사이트당 과금 없음·사용량 제한 없음(MIT)이고,

실시간 SERP·키워드 볼륨이 필요하면 DataForSEO 같은 유료 API를 선택 연동하는 구조다.

---

## 설치·적용 방법

### 스킬의 설치 원리

스킬은 결국 규칙 문서(SKILL.md) 하나다. 스킬을 지원하는 에이전트라면 **사용자 디렉터리의

스킬 폴더에 복사**하는 것으로 끝난다 — Claude Code는 `~/.claude/skills/<이름>/`,

ZCode는 `~/.zcode/skills/<이름>/`. Cursor 같은 규칙 파일 기반 도구는 저장소의 `.cursor/rules`

파일을 쓰면 된다. 머신별 로컬 설치라, 서버·노트북·윈도우 PC마다 한 번씩 해줘야 한다.

예시 — karpathy-guidelines를 폴더째 받기 (URL은 각 리포에서 확인한 실제 경로):

```bash

mkdir -p ~/.claude/skills/karpathy-guidelines

curl -o ~/.claude/skills/karpathy-guidelines/SKILL.md \

  https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/skills/karpathy-guidelines/SKILL.md

```

### 리포별 설치 경로

| 스킬 | 실제 위치 (raw URL 기준) |

|---|---|

| karpathy-guidelines | `multica-ai/andrej-karpathy-skills` → `skills/karpathy-guidelines/SKILL.md` |

| frontend-design | `anthropics/skills` → `skills/frontend-design/SKILL.md` |

| grill-me·grilling·handoff·wait-what | `mattpocock/skills` → `skills/productivity/<스킬명>/SKILL.md` |

규칙 파일 통짜 방식도 있다 — 프로젝트 루트의 `CLAUDE.md`에 붙이면 에이전트가 읽는다:

```bash

curl https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md

```

claude-seo는 규모가 있는 툴박스라 플러그인 방식이 깔끔하다 (Claude Code 안에서):

```

/plugin marketplace add AgriciDaniel/claude-seo

/plugin install claude-seo@agricidaniel-claude-seo

/seo setup        # Python 런타임 + Chromium 구성 (최초 1회)

/seo doctor       # 준비 상태 확인

```

### 발동 방식 이해하기

- **자동 발동형**(karpathy-guidelines, frontend-design): 설명문에 작업 조건이 적혀 있어

  코딩·UI 작업이 시작되면 에이전트가 알아서 읽는다

- **이름 호출형**(grill-me, handoff, wait-what, claude-seo): 채팅에 스킬 이름을 그대로

  쓰면 된다 — "grill-me 돌려줘", "handoff 문서 써줘", "seo audit https://내사이트"

- 설치 직후라도 세션에 이름이 바로 안 잡히면 **새 세션을 열면 된다** — 스킬·커맨드 목록은

  세션 시작 시 스캔된다

---

## 스킬이 잘 먹히고 있는지 확인하는 법

karpathy 스킬 README의 체크리스트가 모든 스킬에 통용되는 기준이 된다. 설치 후 몇 주간:

1. **diff가 깔끔하다** — 요청한 변경만 들어 있다 (karpathy-guidelines, Surgical Changes)

2. **질문이 구현보다 먼저 온다** — 엉뚱하게 만들어 놓고 고치는 일이 줄었다 (동일·원칙 1)

3. **계획 단계에서 허점이 걸러진다** — 구현 시작 전 질문 라운드가 돌았다 (grill-me)

4. **세션이 끊겨도 작업이 이어진다** — 인계 문서가 남는다 (handoff)

5. **만든 UI가 "AI가 만든 페이지"로 안 보인다** (frontend-design)

---

## 마치며

AI 코딩 에이전트의 품질 문제는 대부분 "모델이 나빠서"가 아니라 **규칙과 장비가 없어서**

생긴다. 위 여섯 종은 각각 67줄짜리 규칙 파일이거나 잘 정리된 오픈소스 패키지일 뿐인데,

설치만으로 에이전트의 일하는 방식이 달라진다. 잘 안 맞는 부분은 파일을 열어 자기

프로젝트 규칙으로 고쳐 쓰면 된다 — 규칙 문서니까.

**출처**

- Andrej Karpathy의 원 관찰: [x.com/karpathy](https://x.com/karpathy/status/2015883857489522876)

- [multica-ai/andrej-karpathy-skills](https://github.com/multica-ai/andrej-karpathy-skills) (MIT)

- [anthropics/skills](https://github.com/anthropics/skills) — frontend-design 외 공식 스킬 다수

- [mattpocock/skills](https://github.com/mattpocock/skills) (MIT) — grill-me, grilling, handoff, wait-what 등

- [AgriciDaniel/claude-seo](https://github.com/AgriciDaniel/claude-seo) (MIT)