설명
"Skills For Real Engineers"는 Matt Pocock이 실제 엔지니어링 업무에서 매일 사용하는 Claude Code 및 코딩 에이전트용 스킬 모음입니다. GSD, BMAD, Spec-Kit처럼 전체 프로세스를 통제하는 방식과 달리, 이 스킬들은 개발자가 주도권을 유지하면서 AI 에이전트의 네 가지 핵심 실패 유형(요구사항 미스얼라인먼트, 과도한 장황함, 코드 품질 저하, 아키텍처 부채)을 체계적으로 해소합니다.
첫째, /grill-me와 /grill-with-docs 스킬은 작업 시작 전 에이전트가 개발자에게 상세한 질문을 던지며 요구사항을 철저히 정렬하는 "그릴링 세션"을 진행합니다. 둘째, /grill-with-docs는 그릴링에 더해 프로젝트 전용 공유 언어(CONTEXT.md)와 아키텍처 결정 기록(ADR)을 자동으로 생성하여 에이전트의 토큰 소비를 줄이고 코드베이스 일관성을 높입니다. 셋째, /tdd 스킬은 Red-Green-Refactor 루프를 강제해 에이전트가 실패 테스트를 먼저 작성하고 수정하게 만들어 코드 품질 피드백 루프를 확보합니다. 넷째, /diagnosing-bugs는 검증된 디버깅 베스트 프랙티스를 단순한 루프로 묶어 에이전트가 체계적으로 버그를 추적하게 합니다. 다섯째, /improve-codebase-architecture와 /to-spec은 설계 품질을 지속적으로 유지하도록 유도하며, 복잡도가 누적된 코드베이스를 주기적으로 구조 개선할 수 있게 합니다.
모든 스킬은 특정 플랫폼에 종속되지 않고 어떤 모델과도 함께 동작하므로 팀 환경에 유연하게 도입할 수 있습니다. 각 스킬이 독립적이고 소형이기 때문에 필요한 것만 골라 조합하거나 프로젝트 맥락에 맞게 자유롭게 수정할 수 있으며, 수십 년의 소프트웨어 엔지니어링 원칙(도메인 주도 설계, 실용주의 프로그래머, TDD 등)을 AI 에이전트 워크플로에 반영한 검증된 방법론을 즉시 활용할 수 있습니다.
skills.sh 설치 후 /setup-matt-pocock-skills 초기 설정 단계를 반드시 완료해야 하며, 이슈 트래커(GitHub, Linear, 로컬 파일) 선택과 레이블 설정을 직접 해야 합니다. 스킬 효과는 개발자가 그릴링 세션에 성실히 참여하는 정도에 따라 크게 달라지므로 "자동 완성"이 아닌 "사람이 주도하는 협업 도구"로 이해해야 합니다. 또한 README 일부(Reference 섹션 등)가 잘려 있어 전체 스킬 목록은 skills.sh 사이트나 뉴스레터를 통해 별도로 확인해야 합니다.
skills.sh 인스톨러로 원하는 스킬과 대상 에이전트를 선택해 설치하며, 30초 이내에 설정이 완료됩니다. 각 스킬은 에이전트가 슬래시 커맨드(/grill-me 등)로 호출할 수 있는 독립 모듈로 구성되어 있고, /grill-with-docs는 CONTEXT.md(공유 언어 문서)와 ADR을 프로젝트 지정 경로에 생성·관리합니다. 스킬들은 서로 조합 가능하며, 예를 들어 /to-spec으로 모듈 범위를 확인한 후 /tdd로 테스트 주도 구현을 진행하는 파이프라인을 만들 수 있습니다.
새로운 기능을 시작하기 전 요구사항을 에이전트와 철저히 정렬하고 싶을 때 /grill-me 또는 /grill-with-docs를 사용하세요. 레거시 코드베이스가 복잡도로 인해 수정이 어려워졌을 때 /improve-codebase-architecture를 며칠마다 한 번씩 실행하여 설계 품질을 유지하면 효과적입니다. TDD를 실천하고 싶지만 에이전트가 테스트를 건너뛰거나 형식적으로 작성하는 문제를 겪는 팀이라면 /tdd 스킬 도입이 즉각적인 개선을 가져다줍니다.