andrej-karpathy-skills
무엇인가
andrej-karpathy-skills는 Claude Code의 동작을 바꾸는 마크다운 지침 파일 하나로 구성된다. 실행 파일이나 라이브러리가 아니라, 코딩 에이전트가 코드를 읽고 쓰는 방식을 텍스트 규칙으로 고정하는 산출물이며, 에이전트 지침 파일 계열에 속한다.
어떻게 동작하나
내용은 네 가지 원칙으로 나뉜다. Think Before Coding은 가정을 명시하고 모호하면 질문하며 더 단순한 대안이 있으면 되짚으라고 요구한다. Simplicity First는 요청받지 않은 기능·추상화·설정 가능성·불가능한 상황의 예외 처리를 금지한다. Surgical Changes는 기존 코드와 주석, 서식, 죽은 코드를 건드리지 않고 자신의 변경이 만든 미사용 import·변수·함수만 정리하도록 한다. Goal-Driven Execution은 명령형 작업을 검증 가능한 성공 기준으로 바꿔 에이전트가 스스로 반복하게 만든다. 이 파일은 Claude Code 플러그인으로 설치되어 모든 프로젝트에 적용되거나, 프로젝트의 CLAUDE.md로 병합된다. 저장소에는 Cursor용 프로젝트 규칙 `.cursor/rules/karpathy-guidelines.mdc`도 함께 들어 있다.
무엇과 다른가
기능을 더하는 도구가 아니라 에이전트의 기본 행동을 교정하는 지침이라는 점이 다르다. 프로젝트마다 CLAUDE.md를 복사해 넣는 방식과 달리 플러그인 설치는 여러 프로젝트에 같은 규칙을 한 번에 적용한다. Cursor에서는 같은 규칙이 프로젝트 규칙 파일로 적용되어 두 편집기에서 동일한 기준이 유지된다.
어떻게 쓰나
설치는 두 갈래다. Claude Code 안에서 마켓플레이스를 추가한 뒤 플러그인을 설치하는 경로와, 새 프로젝트에 CLAUDE.md를 만들거나 기존 파일에 내용을 덧붙이는 경로가 README에 제시된다. Cursor 연동 설정과 다른 프로젝트로 규칙을 옮기는 방법은 CURSOR.md에 정리되어 있다.
전제와 한계
강제 수단이 없는 텍스트 규칙이므로 에이전트가 항상 따르는 것은 보장되지 않는다. 사소한 오타 수정이나 명백한 한 줄 변경에는 전체 규칙을 적용하지 말고 판단하라고 README가 명시한다. 프로젝트 고유 지침과 병합해 쓰도록 설계되었고 라이선스는 MIT다.
관련 논문 2
유사 스킬
- nopua위협과 평가 압박 대신 신뢰를 전제로, 에이전트가 불확실성을 밝히고 완료 전 검증과 숨은 결함 탐색을 수행하도록 규칙을 주입하는 Claude Code용 프롬프트 팩이다.
- guard-skills코딩 에이전트가 만든 코드·테스트·문서를 커밋 전에 검토하는 가드 스킬 묶음이다. Skills CLI로 설치해 diff 단위로 적용한다.
- i-have-adhd코딩 에이전트의 응답에서 답을 먼저 꺼내도록 출력 형식을 강제하는 Claude Code 스킬이다. 10개 규칙을 SKILL.md에 담아 슬래시 명령으로 적용한다.
- prompt-master대상 AI 도구를 판별해 9개 의도 차원을 추출하고, 토큰 효율 감사까지 거쳐 복사 가능한 프롬프트 한 블록을 내놓는 Claude Code용 프롬프트 생성 스킬이다.