mattpocock/skills — 실무 엔지니어링을 위한 에이전트 스킬 모음

AI 요약

Matt Pocock은 AI 에이전트가 개발 절차를 통째로 대신하는 방식 대신, 개발자가 통제하고 필요에 맞게 고칠 수 있는 작고 조합 가능한 스킬을 공개했습니다. Claude Code와 Codex를 비롯한 여러 에이전트에서 사용할 수 있으며, 저자는 이를 에이전트 코딩에서 흔히 생기는 실패를 엔지니어링 관행으로 줄이려는 시도라고 설명합니다.

설치 방식

Claude Code에서는 claude plugins install mattpocock-skills 명령이나 세션 안의 /plugin install mattpocock-skills로 설치합니다. 공식 마켓플레이스에 등록된 플러그인은 전체 스킬을 읽기 전용 묶음으로 설치하고, 새 버전이 나오면 자동으로 업데이트합니다.

Codex 등에서는 npx skills@latest add mattpocock/skills를 실행해 사용할 스킬과 설치할 코딩 에이전트를 고릅니다. 이 방식은 스킬 파일을 저장소에 복사하므로 직접 수정할 수 있습니다. 변경 사항은 자동으로 덮어쓰지 않으며, 최신 버전은 npx skills update로 가져옵니다. 두 설치 방식을 함께 쓰면 스킬이 중복될 수 있으니 하나를 고르라고 안내합니다. Codex 네이티브 플러그인은 향후 작업 목록에 있습니다.

저장소마다 설치 프로그램을 한 번 실행하면 이슈 트래커를 GitHub, Linear, 로컬 파일 중에서 고르고, 분류 라벨과 문서 저장 위치를 설정합니다. setup-matt-pocock-skills를 설치 대상으로 선택해야 나머지 스킬의 설정 흐름을 사용할 수 있습니다.

요구사항과 도메인 언어

저자는 개발에서 반복되는 실패 원인으로 개발자와 요청자 사이의 요구사항 불일치를 꼽습니다. /grill-me는 코드 작업이 아닌 계획이나 설계를 두고 사용자에게 세부 질문을 이어갑니다. /grill-with-docs는 같은 인터뷰에 프로젝트의 도메인 모델과 문서 작업을 더합니다. CONTEXT.md에 프로젝트 용어를 정리하고, 설명하기 어려운 결정을 ADR로 남깁니다.

예를 들어 “강의 안의 수업 자료를 실제 파일 시스템에 배치하는 문제”라는 설명을 “materialization cascade”라는 공통 용어로 줄일 수 있습니다. 저자는 용어를 통일하면 변수와 함수, 파일 이름도 일관되게 정리되고 에이전트가 코드베이스를 탐색하기 쉬워지며, 같은 개념을 설명하는 데 드는 토큰도 줄어든다고 설명합니다.

피드백 루프와 설계

코드가 실제로 어떻게 동작하는지 확인하지 못하면 에이전트가 방향을 잃습니다. /tdd는 실패하는 테스트를 먼저 작성한 뒤 구현하고 리팩터링하는 red-green-refactor 흐름을 안내합니다. /diagnosing-bugs는 버그나 성능 저하를 재현하고, 범위를 줄이고, 가설을 세우고, 계측한 뒤 수정과 회귀 테스트로 이어지는 단계별 진단을 돕습니다. 저자는 정적 타입 검사, 브라우저 접근, 자동화 테스트도 피드백 루프의 일부로 제시합니다.

에이전트가 코드를 빠르게 만들수록 복잡성도 빠르게 쌓일 수 있다는 점에서 코드 설계도 다룹니다. /to-spec은 명세 작성 전에 수정 대상 모듈을 확인하고, /improve-codebase-architecture는 기능을 더 깊은 모듈에 모을 후보를 조사해 HTML 보고서로 보여줍니다. 이 스킬은 오래된 코드베이스를 자동으로 정리하지는 않으며, 개선 후보를 찾는 조사 도구로 설명됩니다.

스킬은 호출 주체에 따라 나뉩니다. 사용자가 직접 입력하는 스킬은 작업 흐름을 조율하고, 모델 호출 스킬은 사용자가 실행하거나 상황에 따라 에이전트가 골라 쓰는 반복 가능한 작업 규율을 담습니다. /implement는 명세나 티켓을 구현하면서 합의한 지점마다 TDD를 적용하고 코드 리뷰로 마무리합니다. 그 밖에 티켓 분할, 대규모 작업 계획, 코드 리뷰, 병합 충돌 해결, 조사와 프로토타입 제작 등의 스킬도 제공합니다.

원문: GitHub / 번역·요약: Trawling