본문으로 건너뛰기
에이전트 Skills 전체 목록

Skills For Real Engineers (mattpocock/skills)

  • 추천0
  • GitHub 별326K
  • 개발라이선스MIT

바이브 코딩이 아닌 진짜 엔지니어링용 스킬 모음. 되묻기 · 스펙 · 티켓 · TDD · 코드 리뷰를 작게 쪼개 조합해 써요

원본:mattpocock/skills

요약

바이브 코딩이 아닌 진짜 엔지니어링용 스킬 모음. 되묻기 · 스펙 · 티켓 · TDD · 코드 리뷰를 작게 쪼개 조합해 써요

설명

Skills For Real Engineers

skills.sh

진짜 엔지니어를 위한 스킬

제가 매일 쓰는 에이전트 스킬입니다. 바이브 코딩이 아니라 진짜 엔지니어링을 하기 위한 것입니다.

실제 애플리케이션을 개발하는 것은 어렵습니다. GSD, BMAD, Spec-Kit 같은 방식은 과정을 통째로 맡아서 도와주려 합니다. 하지만 그러는 동안 여러분의 통제권을 빼앗고, 과정에서 생긴 버그를 해결하기도 어렵게 만듭니다.

이 스킬들은 작고, 고쳐 쓰기 쉽고, 서로 조합할 수 있도록 설계했습니다. 어떤 모델에서도 동작하고, 수십 년간의 엔지니어링 경험에 뿌리를 두고 있습니다. 마음껏 만져 보고, 내 것으로 만드세요. 즐기세요.

이 스킬들의 변경 소식과 제가 만드는 새 스킬 소식을 계속 받고 싶다면, 약 6만 명의 다른 개발자와 함께 제 뉴스레터에 가입하세요.

뉴스레터 가입하기

설치 (30초 설정)

플러그인은 스스로 업데이트됩니다. skills.sh는 고칠 수 있는 파일을 내 프로젝트에 복사해 주고, 업데이트는 직접 해야 합니다. 에이전트마다 하나만 고르세요. 둘 다 설치하면 모든 스킬이 두 번씩 생깁니다.

1. 스킬 받기

Claude Code

claude plugin install mattpocock-skills@claude-plugins-official

기본으로 스스로 업데이트됩니다.

Codex

codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock

시작할 때 스스로 업데이트됩니다.

GitHub Copilot (CLI와 VS Code)

copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocock

그런 다음 한 번, ~/.copilot/settings.json에 다음을 추가하세요.

{
  "extraKnownMarketplaces": {
    "mattpocock": { "source": { "source": "github", "repo": "mattpocock/skills" }, "autoUpdate": true }
  }
}

VS Code에서는 Chat: Install Plugin From Source를 실행하고 https://github.com/mattpocock/skills를 입력하세요. 하루에 한 번 업데이트됩니다.

Gemini CLI (수동 업데이트)

gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity

업데이트하려면 두 명령을 다시 실행하세요.

그 밖의 에이전트, 또는 고칠 수 있는 파일 (수동 업데이트)

npx skills@latest add mattpocock/skills -a <agent>  # cursor, opencode, devin, windsurf, amp, pi; omit -a to choose

설치 프로그램이 어떤 스킬을 받을지 물으면 setup-matt-pocock-skills를 포함하세요. 업데이트하려면 npx skills@latest update를 실행하고, 새 스킬을 받으려면 add를 다시 실행하세요.

2. /setup-matt-pocock-skills 실행

에이전트에서 저장소마다 한 번 실행하세요. 이런 것을 합니다.

  • 어떤 이슈 트래커를 쓸지 묻습니다(GitHub, GitLab, 로컬 파일, 또는 설명해 주는 어떤 것이든).
  • 티켓을 분류할 때 어떤 라벨을 붙이는지 묻습니다(/triage가 라벨을 씁니다).
  • 우리가 만드는 문서를 어디에 저장할지 묻습니다.

3. 자, 이제 준비됐습니다.

이 스킬이 있는 이유

Claude Code, Codex 등 코딩 에이전트에서 자주 보는 실패 유형을 고치려고 이 스킬들을 만들었습니다.

#1: 에이전트가 내가 원하는 것을 하지 않았다

"아무도 자신이 무엇을 원하는지 정확히 알지 못한다"

David Thomas & Andrew Hunt, The Pragmatic Programmer

문제. 소프트웨어 개발에서 가장 흔한 실패 유형은 어긋남입니다. 개발자가 내가 원하는 것을 안다고 생각합니다. 그러다 그가 만든 것을 보고서야 전혀 나를 이해하지 못했다는 걸 깨닫습니다.

AI 시대에도 똑같습니다. 나와 에이전트 사이에는 소통의 간극이 있습니다. 이를 고치는 방법이 그릴링 세션(grilling session) 입니다. 에이전트가 내가 만들려는 것에 대해 자세한 질문을 하게 하는 것입니다.

해결책은 다음을 쓰는 것입니다.

이 둘은 제가 만든 스킬 중 가장 인기 있습니다. 시작하기 전에 에이전트와 생각을 맞추고, 지금 하려는 변경에 대해 깊이 생각하도록 도와줍니다. 변경을 할 때마다 항상 쓰세요.

#2: 에이전트가 너무 장황하다

보편적인 언어(ubiquitous language)가 있으면, 개발자끼리의 대화와 코드의 표현이 모두 같은 도메인 모델에서 나옵니다.

Eric Evans, Domain-Driven-Design

문제: 프로젝트 초기에는 개발자와 소프트웨어를 쓰는 사람들(도메인 전문가)이 보통 서로 다른 언어로 말합니다.

에이전트에서도 같은 긴장을 느꽈습니다. 에이전트는 보통 프로젝트에 던져지고 용어는 알아서 파악하라는 요구를 받습니다. 그래서 한 단어면 될 걸 20단어로 말합니다.

해결책은 공통 언어입니다. 프로젝트에서 쓰는 전문 용어를 에이전트가 해독하도록 도와주는 문서입니다.

예시

제 course-video-manager 저장소에 있는 용어집 예시입니다(스킬이 규칙을 바꾸기 전의 이전 이름인 CONTEXT.md로 남아 있는 고정 커밋입니다). 어느 쪽이 더 읽기 쉬울까요?

  • 이전: "강좌의 섹션 안에 있는 레슨을 '실제'로 만들 때(즉 파일 시스템에 자리를 부여할 때) 문제가 있습니다"
  • 이후: "물질화 연쇄(materialization cascade)에 문제가 있습니다"

이 간결함은 세션이 지날수록 도움이 됩니다.

이 기능은 /grill-with-docs에 들어 있습니다. 그릴링 세션이지만, AI와 공통 언어를 만들고 설명하기 어려운 결정을 ADR로 남기는 데 도움이 됩니다.

얼마나 강력한지 설명하기 어렵습니다. 이 저장소에서 가장 멋진 기법일지도 모릅니다. 써 보고 직접 확인해 보세요.

[!TIP] 공통 언어는 장황함을 줄이는 것 외에도 장점이 많습니다.

  • 변수, 함수, 파일 이름이 공통 언어로 일관되게 짓어집니다
  • 그 결과 에이전트가 코드베이스를 더 쉽게 탐색합니다
  • 더 간결한 언어를 쓸 수 있어서 에이전트가 생각에 쓰는 토큰이 줄어듭니다

#3: 코드가 동작하지 않는다

"항상 작고 신중한 단계로 나아가라. 피드백의 속도가 곳 내 속도의 한계다. 너무 큰 작업은 절대 맡지 마라."

David Thomas & Andrew Hunt, The Pragmatic Programmer

문제: 나와 에이전트가 무엇을 만들지 의견을 맞췄다고 해 봅시다. 그래도 에이전트가 여전히 형편없는 결과물을 내놓으면 어떻게 해야 할까요?

피드백 루프를 점검할 때입니다. 자기가 만든 코드가 실제로 어떻게 동작하는지 피드백이 없으면, 에이전트는 눈을 감고 비행하는 것과 같습니다.

해결책: 흔히 쓰는 피드백 루프가 필요합니다. 정적 타입, 브라우저 접근, 자동화된 테스트입니다.

자동화된 테스트에서는 red-green-refactor 루프가 필수입니다. 에이전트가 실패하는 테스트를 먼저 쓰고, 그다음 그 테스트를 통과시키는 방식입니다. 이렇게 하면 에이전트가 일정한 수준의 피드백을 받아 훨씬 나은 코드를 만듭니다.

어느 프로젝트에나 끌어넣을 수 있는 /tdd 스킬을 만들었습니다. red-green-refactor를 권장하고, 좋은 테스트와 나쁜 테스트가 무엇인지 에이전트에게 충분히 안내합니다.

디버깅용으로는 /diagnosing-bugs 스킬도 만들었습니다. 최고의 디버깅 관행을 단계별로 관문을 두는 규율 있는 루프로 담았습니다.

#4: 진흙덩어리를 만들었다

"시스템 설계에 매일 투자하라."

Kent Beck, Extreme Programming Explained

"가장 좋은 모듈은 깊다. 단순한 인터페이스로 많은 기능에 접근할 수 있게 해 준다."

John Ousterhout, A Philosophy Of Software Design

문제: 에이전트로 만든 대부분의 앱은 복잡하고 바꾸기 어렵습니다. 에이전트는 코딩을 크게 빠르게 해 주지만, 그만큼 소프트웨어 엔트로피도 빨리 늘립니다. 코드베이스가 전례 없는 속도로 복잡해집니다.

해결책은 AI 기반 개발에 대한 상당히 새로운 접근입니다. 코드 설계를 신경 쓰는 것입니다.

이 스킬들의 모든 계층에 이것이 녹아 있습니다.

  • /to-spec는 스펙을 만들기 전에 어떤 모듈을 건드릴지 질문합니다.

그리고 무엇보다 /improve-codebase-architecture는 코드베이스를 훑어 깊게 만들 기회를 찾아 후보로 넘겨 줍니다. 며칠에 한 번씩 내 코드베이스에 돌리길 권합니다. 이것은 조사이지 구조가 아닙니다. 정말 오래된 코드베이스에서는 진짜 후보를 찾아내지만, 엉킨 진흙을 대신 풀어 주지는 않습니다.

정리

소프트웨어 엔지니어링의 기본기는 어느 때보다 중요합니다. 이 스킬들은 그 기본기를 반복 가능한 습관으로 압축하려는 제 최선의 노력이며, 여러분이 커리어 최고의 앱을 출시하도록 돕기 위한 것입니다. 즐기세요.

참고 자료

스킬은 누가 호출할 수 있는지를 기준으로 나뉝니다. 사용자가 호출하는(User-invoked) 스킬은 초안처럼 직접 입력할 때만 쓸 수 있고(예: /grill-me), 역할이 조율입니다. 모델이 호출하는(Model-invoked) 스킬은 사용자가 불러도 되고, 작업에 맞으면 에이전트가 자동으로 꺼내 쓸 수도 있으며, 재사용 가능한 규율을 담고 있습니다. 사용자가 호출하는 스킬은 모델이 호출하는 스킬을 부를 수 있지만, 다른 사용자 호출 스킬은 절대 부를 수 없습니다.

엔지니어링

코드 작업에 매일 쓰는 스킬입니다.

사용자가 호출

  • ask-matt: 내 상황에 어떤 스킬이나 흐름이 맞는지 묻습니다. 이 저장소의 사용자 호출 스킬들을 연결해 주는 길잡이입니다.
  • grill-with-docs: 프로젝트의 도메인 모델도 함께 만드는 그릴링 세션입니다. 용어를 다듬고 GLOSSARY.md와 ADR을 그 자리에서 갱신합니다.
  • triage: 이슈를 분류 역할의 상태 기계를 따라 이동시킵니다.
  • improve-codebase-architecture: 코드베이스에서 설계를 깊게 만들 기회를 찾아 시각적인 HTML 보고서로 보여 주고, 고른 후보를 끝까지 되물습니다.
  • setup-matt-pocock-skills: 엔지니어링 스킬을 쓰도록 이 저장소를 설정합니다(이슈 트래커, 분류 라벨, 도메인 문서 구조). 다른 엔지니어링 스킬을 쓰기 전에 저장소마다 한 번 실행하세요.
  • to-spec: 지금까지의 대화를 스펙으로 바꾸어 이슈 트래커에 게시합니다. 인터뷰 없이, 이미 논의한 내용을 종합할 뿐입니다.
  • to-tickets: 계획, 스펙, 대화 어느 것이든 트레이서 불릿(tracer-bullet) 티켓 묶음으로 쪼갭니다. 각 티켓은 서로 막는 관계를 적고, 로컬 파일에는 텍스트로, 실제 트래커에는 기본 제공 차단 링크로 작성합니다.
  • implement: 스펙이나 티켓 묶음에 적힌 작업을 만듭니다. 미리 합의한 경계선에서 /tdd를 구동하고, 커밋하기 전 /code-review로 마무리합니다.
  • implement-spec: 스펙 하나를 통합 브랜치 하나에서 통째로 구현합니다. 티켓을 작업 그래프로 다루고, 준비된 티켓들에 구현 서브에이전트를 병렬로 보내 최대한 동시에 돌리고, 마지막에 /code-review로 마무리합니다.
  • wayfinder: 에이전트 세션 하나로 담기 힘든 큰 작업을 이슈 트래커의 결정 티켓 지도로 계획하고, 목적지까지의 길이 분명해질 때까지 하나씩 해결합니다.
  • retro: 세션이 끝난 뒤 코딩 에이전트의 환경(탐색, 자동 점검, 코딩 표준, 안내 파일, 도구)을 개선할 점을 심각한 순서대로 제안합니다.

모델이 호출

  • prototype: 설계 질문에 답하려고 버릴 프로토타입을 만듭니다. 상태·로직 질문에는 공유할 수 있는 HTML 파일 하나, 화면 질문에는 한 경로에서 전환할 수 있는 완전히 다른 UI 변형 여러 개를 만듭니다.
  • diagnosing-bugs: 어려운 버그와 성능 저하를 위한 규율 있는 진단 루프입니다. 이 버그에서 빨간불이 들어오는 피드백 루프를 만들고 → 최소화 → 가설 → 계측 → 수정 → 회귀 테스트.
  • research: 신뢰할 만한 1차 자료로 질문을 조사하고, 출처가 달린 Markdown 파일로 저장소에 남깁니다. 백그라운드 에이전트로 실행합니다.
  • tdd: red-green-refactor 루프로 하는 테스트 주도 개발. 수직 조각 하나씩 기능을 만들거나 버그를 고칩니다.
  • domain-modeling: 프로젝트의 도메인 모델을 적극적으로 만들고 다듬습니다. 용어를 용어집과 대조해 따져 묻고, 극단적인 시나리오로 시험하고, GLOSSARY.md와 ADR을 그 자리에서 갱신합니다.
  • codebase-design: 깊은 모듈을 설계하는 공통 규율과 어휘입니다. 작은 인터페이스 뒤에 많은 동작을 두고, 깔끔한 이음새(seam)에 놓아, 그 인터페이스로 테스트할 수 있게 합니다.
  • code-review: 고정된 지점 이후의 diff를 두 축으로 리뷰합니다. 표준(저장소의 코딩 표준과 Fowler 코드 냄새 기준을 따르는가?)과 스펙(최초 이슈/스펙을 충실히 구현했는가?)을 병렬 서브에이전트로 돌려 서로 영향을 주지 않게 합니다.
  • pr: PR 본문이 갖춰야 할 형식입니다. 변경을 가장 분명히 보여 주는 작은 시각 자료로 쓴 요약, 제대로 동작한다는 전후 증거, 병합 위험 판단(되돌릴 수 없는지 있는지, 영향 범위)을 넣습니다.
  • wizard: 사람만 할 수 있는 단계(인프라 마련, 자격 증명이나 CI 비밀 값 설정, 낙선 외부 대시보드 따라가기, 일회성 마이그레이션이나 전환)를 안내하는 대화형 bash 마법사를 만듭니다.

생산성

코드에 한정되지 않는 일반 작업 흐름 도구입니다.

사용자가 호출

  • grill-me: 계획이나 설계에 대해, 설계 트리의 모든 가지가 해결될 때까지 끈질기게 인터뷰를 받습니다.
  • handoff: 현재 대화를 인수인계 문서로 압축해 다른 에이전트가 작업을 이어가게 합니다.
  • teach: 새 기술이나 개념을 여러 세션에 걸쳐 가르칩니다. 현재 디렉터리를 상태를 유지하는 교육 작업 공간으로 씁니다.
  • to-questionnaire: 혼자 답할 수 없는 결정을, 답할 수 있는 한 사람을 위한 Markdown 질문지로 바꿉니다. 비동기로 채우거나 회의로 함께 채웁니다. 주제가 아니라 보내는 일(누구를 위한 것인지, 무엇을 돌려받아야 하는지)에 대해 되물습니다.
  • wait-what: 메시지가 와닿지 않는 순간 바로 쓰세요. 에이전트가 내가 모르는 맥락을 덧붙여, GLOSSARY.md의 어휘를 써서 쉽운 말로 다시 설명합니다.

모델이 호출

  • grilling: 계획, 결정, 아이디어에 대해 설계 트리의 모든 가지가 해결될 때까지 끈질기게 인터뷰합니다. grill-me, grill-with-docs, triage, wayfinder, improve-codebase-architecture의 바탕이 되는 재사용 가능한 인터뷰 부품입니다.
  • writing-for-agents: 에이전트를 위한 문서 쓰기입니다. 스킬, AGENTS.md/CLAUDE.md, 그리고 에이전트가 포인터로 도달하는 모든 문서가 해당합니다.

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0