Claude Code / Cursor 개발 필수 스킬 4가지 설정법

Claude Code / Cursor 개발 필수 스킬 4가지 설정법

AI 코딩 에이전트(Claude Code, Cursor)를 쓸 때 "그냥 시키는 대로 코드를 뱉는" 상태에서 벗어나게 해주는 스킬 4개를 정리했다. 각 스킬은 서로 다른 축을 커버하기 때문에 겹치지 않고 같이 쓸 수 있다.

스킬	관여하는 영역
Karpathy Guidelines	사고방식 전반 (가정 명시, 최소 수정, 검증 기준)
Ponytail	코드량 (과잉설계 방지, YAGNI)
Caveman	말투/응답 토큰량 (불필요한 설명 압축)
Superpowers	개발 프로세스 자체 (기획 → 계획 → TDD → 검증)

---

1. Karpathy Guidelines

Andrej Karpathy가 지적한 "LLM 코딩의 흔한 실수 패턴"을 CLAUDE.md 파일 하나로 방지하는 원칙 모음이다. 별도 프로그램이 아니라 순수 텍스트 파일이라 이식성이 가장 좋다.

핵심 원칙

• 가정 드러내기 — 애매하면 짐작하지 않고 명시
• 과잉설계 방지 — 요청하지 않은 기능·추상화 금지
• 외과수술식 수정 — 필요한 부분만 건드리기
• 검증 가능한 성공 기준 — 확인 가능한 완료 조건 먼저 정하기

Claude Code 설정

curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

프로젝트 루트에 두면 세션 시작 시 자동으로 읽힌다. 이미 CLAUDE.md가 있다면 덮어쓰지 말고 뒤에 이어붙이기(append) 하는 것을 권장한다.

Cursor 설정

mkdir -p .cursor/rules
curl -o .cursor/rules/karpathy.mdc https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

프로젝트 전체가 아니라 모든 프로젝트에 적용하고 싶다면 홈 디렉토리의 ~/.cursor/rules/에 넣거나, Cursor Settings → Rules → User Rules에 내용을 붙여넣으면 된다.

커스터마이징
받은 파일 그대로 쓰지 말고 스택, 명령어, 컨벤션, 금지사항을 추가해서 120줄 이내로 다듬는 것이 좋다.

---

2. Ponytail

"이 코드 진짜 필요해?"를 강제로 묻는 YAGNI 결정 사다리 스킬이다. 과잉설계 함정(예: 날짜 피커 라이브러리 대신 <input type="date">)을 잡아내는 데 특화되어 있다.

Claude Code 설정

/plugin marketplace add DietrichGebert/ponytail
/plugin add ponytail@ponytail

설치 후 첫 세션에서 hook 신뢰(trust) 여부를 확인하라는 프롬프트가 뜨면 승인한다. node가 PATH에 잡혀 있어야 정상 작동하며, 정상 작동 시 상태줄에 [PONYTAIL] 뱃지가 표시된다.

Cursor 설정

mkdir -p .cursor/rules
# 저장소의 .cursor/rules 안 규칙 파일을 복사

Claude Code의 hook 기반 자동 활성화·상태줄 표시는 재현되지 않지만, 핵심 규칙 내용은 동일하게 적용된다.

리뷰 기능
코드 작성 후 /ponytail-review를 입력하면 과잉설계된 부분만 짚어준다. 단, 버그·보안 이슈는 다루지 않으므로 일반 코드 리뷰와 병행해야 한다.

---

3. Caveman

Claude의 응답 자체를 압축하는 스킬이다. 코드를 줄이는 게 아니라 서론·반복 설명·과한 안내문 같은 텍스트를 없애 출력 토큰을 줄인다.

설치 (Skills CLI, 여러 툴 공유 가능)

npx skills add https://github.com/juliusbrussee/caveman --skill caveman -g

글로벌(-g) 설치 시 여러 호환 툴이 공유하는 폴더에 들어가 Cursor 등에서도 인식될 수 있다.

Cursor 개별 설정

mkdir -p .cursor/rules
# 저장소 규칙 파일을 .cursor/rules/에 복사

참고

• lite / full / ultra 강도를 선택해서 저장 가능
• 위험한 작업(테이블 삭제 등)에서는 자동으로 정상 모드로 돌아옴
• 팀원과 세션을 공유하거나 PR 코멘트로 남길 계획이면 lite 모드를 권장

---

4. Superpowers

코드 스타일이 아니라 개발 프로세스 전체를 강제하는 프레임워크다. Jesse Vincent(obra)가 만들었으며 14개 스킬이 세트로 묶여 있다.

핵심 흐름

brainstorming(요구사항 탐색) → writing-plans(계획 작성)
→ TDD(실패하는 테스트 먼저 작성) → 실행 → verification(완료 검증)

Claude Code 설정

/plugin install superpowers@claude-plugins-official

Cursor 설정
Cursor 마켓플레이스에서 "Superpowers" 검색 후 설치하거나, 채팅창에 아래 명령 입력:

/add-plugin superpowers

Cursor 팀이 공식 인증(Verified)한 몇 안 되는 플러그인이라 설치가 가장 간단하다.

설치 확인 방법
새 기능을 요청했을 때 AI가 바로 코드를 쓰지 않고 요구사항을 먼저 되묻는다면 정상 작동 중인 것이다.

---

스코프(적용 범위) 정리

구분	Claude Code	Cursor
전역(모든 프로젝트)	~/.claude/skills/ 또는 플러그인 설치	~/.cursor/rules/ 또는 Settings → User Rules
프로젝트 단위	프로젝트 루트 CLAUDE.md 또는 ./.claude/skills/	프로젝트 루트 .cursor/rules/

플러그인/스킬은 한 번 설정해두면 이후 세션마다 자동으로 로드되며, 매번 다시 설정할 필요는 없다.

---

추천 조합

넷 다 무조건 설치하기보다는 필요에 따라 조합하는 것이 좋다.

• 기본 3종: Karpathy + Ponytail + (Claude Code 내장) /code-review — 사고방식 → 코드 최소화 → 검증의 파이프라인 구성
• 프로세스까지 강제하고 싶다면: Superpowers 추가 — 다만 Karpathy의 검증 기준 원칙과 일부 겹치므로 굳이 둘 다 넣을 필요는 없음
• 토큰 비용이 부담될 때만: Caveman 추가

스킬 폴더는 dotfiles처럼 작고 계속 줄어드는 방향으로 관리하는 것이 이상적이다. 안 쓰는 스킬은 지우고, 부족한 부분은 직접 CLAUDE.md에 써넣는 것이 장기적으로 더 낫다.