mattpocock/skills

★ 224,352오늘 +1,894Shell

AI 코딩 에이전트가 삼천포로 빠지지 않게 잡아주는 재사용 가능한 '스킬' 모음집

mattpocock/skills는 Claude Code, Codex 같은 AI 코딩 에이전트가 코드를 짜기 전에 사용자에게 질문을 던지고, 프로젝트 용어를 일관되게 공유하고, 테스트 주도 개발 루프를 돌리고, 주기적으로 코드베이스 설계를 점검하도록 유도하는 '스킬' 파일 모음이다. 각 스킬은 거대한 프레임워크가 아니라 작고 수정 가능한 지시문 형태로 되어 있다. Claude Code 플러그인으로 통째로 설치하거나, skills.sh 설치기로 프로젝트에 파일을 직접 복사해 넣어 자유롭게 고칠 수 있다.

무엇을 하는 레포인가

AI 코딩 에이전트에서 흔히 겪는 네 가지 문제를 겨냥한다: 원하는 걸 제대로 이해 못하는 것, 답변이 너무 장황한 것, 만든 코드가 실제로 작동하지 않는 것, 코드베이스가 시간이 지나며 진흙탕이 되는 것.
/grill-me와 /grill-with-docs 스킬은 코드를 짜기 전에 에이전트가 사용자에게 계획을 캐묻게 만들고, /grill-with-docs는 여기에 더해 CONTEXT.md라는 공유 용어집과 ADR(설계 결정 기록) 문서를 함께 갱신해 에이전트 답변을 점점 더 간결하고 정확하게 만든다.
/tdd 스킬은 실패하는 테스트를 먼저 쓰고 통과시키는 red-green-refactor 루프를 강제해 에이전트가 일관된 피드백을 받게 하고, /diagnosing-bugs는 어려운 버그를 단계별로 파고드는 훈련된 디버깅 절차를 제공한다.
/improve-codebase-architecture는 코드베이스를 스캔해 설계를 개선할 수 있는 지점('deepening opportunities')을 찾아 HTML 보고서로 보여주는데, 제작자는 이것이 오래되고 뒤엉킨 코드를 자동으로 고쳐주는 도구가 아니라 후보를 찾아주는 조사 도구라고 밝힌다.
스킬은 사용자가 직접 입력해야 실행되는 'user-invoked'(예: /triage, /to-spec)와 에이전트가 상황에 맞게 알아서 불러오는 'model-invoked'(예: tdd, code-review)로 나뉘며, 설치는 자동 업데이트되는 읽기 전용 Claude Code 플러그인 방식과, 파일을 직접 편집 가능하게 복사하는 skills.sh CLI 방식 중 선택할 수 있다.

왜 중요한가

AI 코딩 에이전트가 일상 개발 업무에서 차지하는 비중이 커지면서, 개발자의 통제권을 빼앗는 무거운 AI 프레임워크 대신 가볍고 특정 모델에 종속되지 않으면서 에이전트를 정렬시키고 규율 있게 만들어주는 방법이 중요해지고 있다. 스타 224352개를 받으며 숙련된 엔지니어들이 실제로 AI 에이전트 워크플로를 어떻게 구성하는지 보여주는 실용적 참고 자료로 널리 채택되고 있다.

이 레포의 용어

Claude Code 플러그인 · Anthropic의 코딩 에이전트 Claude Code에 통째로 설치되는, 자동 업데이트되는 읽기 전용 확장 기능 묶음
skills.sh · 스킬 파일을 프로젝트에 직접 복사해 넣어 사용자가 편집할 수 있게 해주는 설치 도구
red-green-refactor · 실패하는 테스트를 먼저 작성한 뒤(red) 통과시키고(green) 코드를 정리하는(refactor) 테스트 주도 개발 절차
ADR · 설계 관련 결정과 그 이유를 기록해두는 문서 형식(Architecture Decision Record)
CONTEXT.md · 프로젝트에서 쓰는 전문 용어와 도메인 개념을 정리해 에이전트와 사람이 같은 언어로 소통하게 돕는 문서

레포 원문 소개 (영문)

Skills for Real Engineers. Straight from my .agents directory.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

mattpocock/skills

무엇을 하는 레포인가

왜 중요한가

이 레포의 용어

주목받는 레포

METAL LAB 최신 기사