스킬로 해 보는 실제 작업

이 저장소는 Andrej Karpathy의 관찰을 바탕으로 네 가지 규칙을 정리한 커뮤니티 프로젝트입니다. 공식 Andrej Karpathy 스킬로 오해하지 않습니다.

네 가지 규칙

• 코드를 쓰기 전에 가정과 모르는 부분을 드러냅니다.
• 요청을 해결하는 가장 작은 구현을 고릅니다.
• 요청과 관계없는 코드·주석·서식을 바꾸지 않습니다.
• 성공 기준을 정하고 테스트나 실제 결과로 확인합니다.

적용 여부는 설명이 아니라 diff에서 확인합니다. 바뀐 모든 줄이 요청과 직접 연결되는지 살펴봅니다.

claude-video는 영상 URL이나 로컬 파일에서 자막과 화면 프레임을 가져옵니다. Claude는 두 자료를 함께 읽고 특정 시점의 발화와 화면을 연결합니다.

언제 고르나요

• 튜토리얼에서 버튼이 언제, 어떤 순서로 등장하는지 찾을 때
• 광고나 발표 영상의 첫 장면과 첫 문장을 따로 분석할 때
• 화면 녹화에서 오류가 나타나는 순간을 찾을 때

공개 자막이 있으면 자막을 먼저 씁니다. 자막이 없는 영상은 외부 음성 인식 API로 넘어갈 수 있으므로 비용 조건을 확인합니다.

Superpowers는 소프트웨어 개발 절차를 여러 스킬로 묶은 플러그인입니다. 기능을 만들기 전에 요구사항을 정리하고, 계획을 확인한 뒤 구현과 검수를 진행합니다.

포함된 흐름

• 요구사항을 질문으로 구체화합니다.
• 승인한 요구사항을 작업 단위로 나눕니다.
• 테스트를 먼저 실행해 기대 동작을 고정합니다.
• 태스크별 구현 뒤 사양과 코드 품질을 나눠 검수합니다.

한 줄 수정과 여러 파일을 바꾸는 기능은 필요한 절차가 다릅니다. 작업 크기에 맞춰 적용 범위를 정합니다.

Understand-Anything은 코드베이스와 문서 폴더를 분석해 파일·함수·클래스·의존 관계를 지식 그래프로 저장합니다. 대시보드에서 노드를 누르면 역할과 연결 관계를 볼 수 있습니다.

언제 고르나요

• 처음 받은 프로젝트에서 어디부터 읽을지 정할 때
• 코드 변경이 어느 파일에 영향을 주는지 살펴볼 때
• 문서 폴더 안 주제와 연결 관계를 한 화면에서 찾을 때

첫 분석은 프로젝트 전체를 읽으므로 저장소가 크면 토큰 사용량도 커집니다. 작은 하위 폴더로 동작을 확인한 뒤 범위를 넓힙니다.

agentmemory는 코딩 에이전트의 세션 기록을 로컬 메모리 서버에 저장합니다. 다음 세션에서는 전체 기록을 다시 읽는 대신 현재 요청과 관련된 내용을 검색합니다.

무엇이 달라지납니다

• 지난 세션의 결정과 수정 이력을 다른 표현으로 검색할 수 있습니다.
• 여러 도구가 같은 메모리 서버를 쓰도록 연결할 수 있습니다.
• 웹 뷰어에서 기록된 세션과 메모리를 직접 확인할 수 있습니다.

자동 기록은 편하지만 저장 범위도 넓습니다. 설치 전에 저장 위치, 기록 대상, 삭제 방법을 확인합니다.

Codex의 Skill Creator는 새 스킬에 필요한 질문을 하고 SKILL.md 초안을 만듭니다. SKILL.md에는 name과 description이 필요하며, description은 스킬의 역할과 호출 조건을 설명합니다. Anthropic의 Skill Creator도 새 스킬을 만들거나 기존 스킬을 개선하고 실제 요청으로 결과를 확인하는 절차를 제공합니다.

만드는 순서

• 스킬 이름과 맡을 일, 사용할 때와 사용하지 않을 때, 결과 형태를 정합니다.
• SKILL.md 초안을 만듭니다.
• 실제 사용자가 말할 법한 요청 두세 개로 실행합니다.
• 결과를 보고 공통 문제를 고칩니다.
• 같은 요청을 다시 실행해 전후 결과를 비교합니다.

스킬은 한 번 만든 파일보다 반복해서 고친 작업 기준에 가깝습니다. 실제 결과의 아쉬운 점을 다음 버전에 반영합니다.

5분 실습 — 설치 전에 규칙 고치기

Claude Skill Library의 /grill-me는 비단순 제작 요청을 받으면 먼저 10~15개 질문을 요구합니다. 공개 압축 파일에는 2026년 9월 3일 확인 기준으로 SKILL.md 한 개가 들어 있습니다. 수업에서는 이 스킬을 설치하지 않고 규칙만 읽습니다.

1. /grill-me만 내려받아 압축을 풉니다. 이메일 입력을 요구하면 내려받지 않고 멈춥니다.
2. SKILL.md에서 description, Core rule, Handling pushback을 찾습니다.
3. 파일을 Claude나 Codex에 첨부하고 직접 해보기의 설치 전 검토 요청문을 보냅니다.

간단한 작업과 되돌리기 어려운 작업의 질문 수를 다르게 정하고 수정·오류 해결·형식 변경을 제외 조건으로 적으면 통과입니다. 외부 스킬은 출처와 파일 내용을 확인한 뒤 설치합니다.

eli5는 주제 하나를 그림 위주 설명 페이지로 만들어 주는 플러그인입니다. /eli5 뒤에 알고 싶은 것을 적으면 장면 서너 개로 나뉜 HTML 페이지 한 장이 만들어집니다. 이 수업에서는 결과를 받은 뒤 샘플과 내 결과 파일을 브라우저에서 직접 엽니다.

언제 씁니까

공식 문서를 읽었는데도 무엇이 무엇과 연결되는지 안 잡힐 때 씁니다. 요약과는 다릅니다. 요약은 원문을 짧게 줄이지만, eli5는 아는 것이 없다고 가정하고 처음부터 다시 설명합니다.

무엇이 나옵니까

장면마다 그림 하나와 문장 한두 개가 붙습니다. 화면을 위에서 아래로 내리면 개념이 순서대로 쌓이고 마지막 장면에서 정의로 닫힙니다. 전문 용어를 먼저 정의하지 않고 익숙한 상황에 빗대어 시작하기 때문에, 그 분야를 처음 보는 사람도 첫 장면에서 막히지 않습니다.

쉽게 만드는 과정에서 조건과 예외는 덜어 냅니다. 개념의 위치를 잡는 데까지가 이 도구의 몫이며 정확한 값이 필요한 순간에는 원문으로 돌아갑니다.