코딩 에이전트와 나 사이의 소통 단절을 메우는 실전 워크플로우 모음
에이전트가 요구사항을 오해하거나, 불필요하게 긴 설명을 하거나, 엉망진창인 코드를 만들어내는 상황을 겪어본 적 있다면 이 저장소가 답이 될 수 있습니다. 이는 코딩 에이전트가 실제 엔지니어링 작업을 수행할 때 발생하는 대표적인 실패 패턴을 해결하기 위해 설계된 스킬 세트입니다. 각 스킬은 작고 조합 가능하며, 특정 모델에 종속되지 않아 자유롭게 수정하고 내 방식대로 다듬을 수 있습니다.
에이전트 실패 패턴을 타겟으로 한 설계
저자는 코딩 에이전트 사용 중 자주 마주하는 네 가지 문제를 해결하는 데 초점을 맞췄습니다. 첫째, 에이전트가 사용자의 의도를 정확히 이해하지 못하는 문제를 해결하기 위해 /grill-me와 /grill-with-docs를 제공합니다. 이 스킬들은 개발 시작 전 에이전트가 사용자에게 상세한 질문을 던져 요구사항을 명확히 하는 '그릴링 세션'을 진행합니다. 둘째, 에이전트가 프로젝트 용어를 모르고 불필요하게 많은 단어를 사용하는 문제를 해결하기 위해 공유 언어 문서를 구축합니다. 이를 통해 에이전트는 복잡한 설명 대신 프로젝트 고유 용어를 사용해 더 간결하고 정확한 응답을 생성합니다. 셋째, 코드가 실제로 동작하지 않는 문제를 방지하기 위해 /tdd와 /diagnosing-bugs를 통해 피드백 루프를 강화합니다. 마지막으로, 에이전트가 빠르게 코드를 생성하면서 소프트웨어 엔트로피가 증가하는 문제를 막기 위해 /improve-codebase-architecture로 코드베이스의 구조적 깊이를 정기적으로 점검합니다.
사용자 호출과 모델 호출 스킬의 구분
이 저장소의 스킬은 누가 호출할 수 있는지에 따라 두 가지로 나뉩니다. 사용자 호출 스킬은 사용자가 직접 명령을 입력할 때만 작동하며, 주로 워크플로우를 오케스트레이션하는 역할을 합니다. 예를 들어 /grill-me나 /triage는 사용자가 명시적으로 실행해야 합니다. 반면 모델 호출 스킬은 사용자가 직접 실행할 수도 있지만, 에이전트가 작업 맥락에 맞다고 판단하면 자동으로 호출할 수 있는 재사용 가능한 규율을 담고 있습니다. /tdd나 code-review가 여기에 해당하며, 사용자 호출 스킬은 모델 호출 스킬을 호출할 수 있지만 다른 사용자 호출 스킬을 호출할 수는 없습니다. 이러한 구조는 복잡한 워크플로우를 관리하면서도 에이전트가 필요한 시점에 적절한 도구를 활용할 수 있게 합니다.
설치 방식과 초기 설정
설치는 두 가지 방식으로 진행되며, 각각 다른 철학을 따릅니다. 첫 번째는 Claude Code 플러그인 설치로, 전체 스킬 세트를 읽기 전용 번들로 설치하여 저자의 업데이트를 자동으로 받는 구독형 방식입니다. 두 번째는 skills.sh를 통해 편집 가능한 스킬 파일을 프로젝트에 복사하는 방식으로, 파일을 직접 수정하고 커스터마이징할 수 있습니다. 두 방식을 동시에 설치하면 모든 스킬이 중복되므로 하나만 선택해야 합니다. 설치 후 /setup-matt-pocock-skills를 실행하여 이슈 트래커(GitHub, Linear, 로컬 파일), 트리아지 라벨, 문서 저장 위치를 설정하면 준비가 완료됩니다. 이 설정은 저장소별로 한 번만 수행하면 됩니다.
적용 전 확인 사항
이 스킬 세트는 코딩 에이전트를 일상적으로 사용하는 개발자에게 적합하며, 특히 에이전트와의 소통 효율성을 높이고 싶은 사람에게 유용합니다. 또한, CONTEXT.md와 ADR(아키텍처 결정 기록) 문서를 유지보수하는 습관이 필요하며, 이는 초기 학습 곡선이 있을 수 있습니다. README는 특정 모델이나 프레임워크에 종속되지 않는다고 명시하지만, Claude Code와 Codex를 주요 대상으로 언급하고 있으므로 다른 에이전트와의 호환성은 직접 테스트해봐야 합니다. 마지막으로, 스킬 파일은 편집 가능하므로 프로젝트 특성에 맞게 수정할 의지가 있는 사용자에게 더 큰 가치를 제공합니다.
