AI 코딩 스킬 비교, 요구사항⁠·구현⁠·검증 단계별 3종 차이

AI 코딩 에이전트에 붙이는 스킬 모음 세 가지, skills·agent-skills·pstack을 요구사항⁠·구현⁠·검증 세 단계로 나눠 비교했습니다. 셋 다 설계하고 테스트하고 검토한다고 소개하지만 일을 다루는 방식은 꽤 다릅니다. AI 코딩 스킬 비교 기준과 각 저장소의 설치 명령까지 함께 정리했습니다.

AI 코딩 스킬 3종, 무엇을 비교하나

스킬(skill)은 AI 코딩 에이전트에게 특정 작업 요령을 알려 주는 설명서 묶음입니다. Claude Code나 Codex에 설치해 두면 /grill-me처럼 이름을 불러 쓰거나, 작업에 맞을 때 에이전트가 알아서 꺼내 씁니다. 여기서 비교하는 세 가지는 모두 현업 개발자의 작업 방식을 스킬로 묶어 공개한 것입니다.

별(관심 표시) 수는 2026년 10월 21일 기준 skills 약 30만 개, agent-skills 약 11만 개입니다. pstack은 커서 공식 플러그인 저장소(cursor/plugins) 안에 들어 있습니다.

결론부터 말하면, 셋은 개발 단계를 하나씩 나눠 맡는 도구가 아닙니다. 겹치는 기능이 많고, 작업을 다루는 방식과 강조점이 다릅니다. 셋 중 어느 것이 낫다기보다 내 작업 방식에 맞춰 고르는 것이 맞습니다.

1. 요구사항을 정할 때

skills: 질문으로 빠진 조건을 채운다

skills는 내가 생각한 것과 AI가 이해한 것 사이의 간극을 줄이는 데 공을 들였습니다. grill-me와 grill-with-docs는 AI가 질문을 계속 던져 빠진 조건을 구체화하게 만드는 스킬입니다.

예를 들어 AI에게 정산 앱을 만들어 달라고 하면, 술값도 똑같이 나눌지 마신 사람끼리만 나눌지부터 확인하는 식입니다.

• 질문마다 추천 답을 곁들여 판단을 돕습니다.
• grill-with-docs는 기존 코드까지 확인하면서, 정한 용어는 용어집(GLOSSARY.md)에, 중요한 결정과 그 이유는 설계 결정 기록(ADR)에 남깁니다.
• grill-me는 코드가 없는 기획이나 일반 계획에 씁니다.

agent-skills: 요구사항을 전체 절차의 첫 단계로

agent-skills도 요구사항을 정리합니다. 다만 구현과 검증까지 이어지는 개발 절차의 첫 단계로 묶어 뒀습니다. /spec 명령(spec-driven-development 스킬)은 목표, 실행 명령, 코드 구조, 코드 스타일, 테스트 기준, 지켜야 할 경계까지 문서로 정하고, 다음 단계 /plan에서 이를 작은 작업으로 나눕니다.

skills의 질문 스킬이 필요할 때 꺼내 쓰는 도구라면, agent-skills는 요구사항 정리를 전체 흐름의 출발점으로 둔 셈입니다. agent-skills에도 한 번에 한 질문씩 묻는 interview-me 스킬이 따로 있습니다.

pstack: 계획보다 기존 코드 조사

pstack은 별도의 계획 스킬보다 실제 코드의 조사와 검증에 무게를 둡니다. /how는 지금 어떻게 작동하는지를, /why는 왜 그렇게 만들어졌는지를 찾습니다. /why는 연결된 MCP(AI가 외부 서비스를 쓰게 해 주는 연결)로 커밋 기록, 이슈, 문서, 채팅 기록을 함께 뒤집니다.

예를 들어 송금 요청을 하루 한 번으로 제한한 코드가 있다면, 바로 바꾸기 전에 기록에서 그렇게 만든 이유를 찾고 확인된 사실과 추측을 구분합니다.

요구사항 단계 고르는 기준

새로 정할 조건은 질문으로 맞추고, 이미 있는 조건은 기록에서 이유를 찾습니다. 실제 작업에서는 둘 다 필요할 때가 많습니다.

2. 코드를 만들고 고칠 때

세 가지 모두 코드 품질을 다루지만 관리하는 방식이 다릅니다.

skills: 필요한 도구를 골라 쓴다

기능 하나를 바꿀 때마다 관련 없는 곳까지 함께 고쳐야 한다면 improve-codebase-architecture를 씁니다. 코드를 훑어 묶어서 정리할 후보와 이유를 보고서로 보여 주고, 사람이 하나를 고르면 질문을 주고받으며 방향을 정합니다. 목표는 테스트하기 쉽고 AI가 길을 잃지 않는 구조입니다. 대신 고쳐 주지는 않는 점검 도구입니다.

agent-skills: 작업을 나누고 순서까지 정한다

정산 앱이라면 화면을 전부 만든 뒤 연결하지 않습니다. 영수증 하나를 넣으면 사람별 금액이 나오는 데까지를 먼저 끝까지 완성합니다. 작은 기능 하나를 구현하고, 테스트하고, 커밋한 뒤 다음으로 넘어가는 방식(incremental-implementation 스킬)입니다.

눈에 띄는 장치가 하나 있습니다. AI가 단계를 건너뛸 때 댈 법한 핑계와 그 반박을 스킬마다 표로 넣어 뒀습니다. "간단해서 테스트가 필요 없다", "직접 확인했으니 충분하다", "테스트는 나중에 추가하겠다" 같은 이유로 필요한 단계를 넘기지 않게 하려는 것입니다.

pstack: 여러 설계안을 겨루게 한다

pstack은 큰 변경에서 여러 설계안을 겨루게 합니다. /arena는 같은 과제를 여러 에이전트가 동시에 풀게 한 뒤, 가장 나은 안을 바탕으로 다른 안의 좋은 부분을 합칩니다.

구현 단계 고르는 기준

지금 구조의 문제를 짚고 싶은지(skills), 개발 순서를 잡고 싶은지(agent-skills), 여러 설계안을 비교하고 싶은지(pstack)에 따라 꺼낼 도구가 달라집니다.

3. 결과를 확인할 때

셋 모두 검증을 중요하게 다룹니다. 그래서 "테스트 기능이 있다"는 것만으로는 고르는 기준이 되지 않습니다. 무엇을 어떻게 확인하게 하는지를 봐야 합니다.

skills의 tdd

tdd 스킬은 테스트 주도 개발(TDD)의 레드-그린-리팩터 순서를 따릅니다. 원하는 동작을 검사하는 테스트를 먼저 쓰고, 그 테스트가 실패하는지 확인한 뒤, 구현해서 통과시킵니다. 먼저 실패를 보는 이유는 그 테스트가 정말 문제를 잡아내는지 확인하기 위해서입니다.

agent-skills: 별도 검증⁠·리뷰 단계

agent-skills는 이런 확인을 작업마다 절차로 두고, /test와 /review라는 별도의 검증⁠·리뷰 단계를 둡니다. 중요한 판단은 새로운 맥락의 검토자(이전 대화를 모르는 다른 에이전트)가 다시 의심해 보게 합니다.

pstack: 다른 모델의 검토와 실제 실행 확인

pstack의 /interrogate는 다른 계열의 모델들에게 코드 변경을 따로 검토하게 하고, 깨뜨려 보게 합니다. agent-skills와 pstack 모두 작업하던 AI의 판단을 다시 살피지만, pstack은 모델 자체를 달리해 다른 관점의 지적을 얻도록 구성했다는 차이가 있습니다.

실제 실행 결과로도 확인합니다. 정산 앱 화면에 "정산 완료"가 떠도 실제로 송금 요청 알림은 안 갔을 수 있습니다. 빌드 성공만으로는 이런 문제를 알 수 없습니다.

pstack의 기본 진입점 /poteto-mode는 할 일과 완료를 확인할 방법을 주면, 작업 종류(버그 수정, 기능 추가, 성능 개선 등)에 맞는 절차를 골라 진행합니다. 버그 수정이라면 이렇게 갑니다.

• 문제를 직접 재현합니다.
• 로그로 원인을 좁혀 고칩니다.
• 같은 조건에서 다시 확인합니다.
• 실패하던 결과와 통과한 결과를 그대로 붙여 보여 줍니다.

세 스킬 모두에서 가져갈 것은 하나입니다. 완료를 어떤 결과로 확인할지 작업을 시작할 때 함께 정합니다.

4. 내 작업에 맞는 AI 코딩 스킬 고르기

skills가 맞는 경우

지금 작업 방식은 그대로 두고, 질문, 테스트, 구조 점검 같은 도구를 필요한 만큼만 더하고 싶을 때입니다. 스킬 하나하나가 작고 고쳐 쓰기 쉽게 만들어져 있습니다.

agent-skills가 맞는 경우

요구사항부터 배포까지 이어지는 절차와 단계별 확인 기준을 갖추고 싶을 때입니다. /spec, /plan, /build, /test, /review, /ship 순서로 흐름이 정해져 있습니다.

pstack이 맞는 경우

기존 코드를 깊이 조사하고, 여러 설계안 비교와 다른 모델의 검토, 실제 실행 확인까지 쓰고 싶을 때입니다. 커서에서 가장 잘 돌고, Claude Code에서도 플러그인으로 쓸 수 있습니다.

고르기 전에 스스로 물어볼 것

• 내 작업에 질문⁠·테스트⁠·구조 개선 도구를 필요한 만큼만 더하고 싶은가.
• 요구사항부터 배포까지 이어지는 절차와 확인 기준이 필요한가.
• 기존 코드 조사, 여러 설계안, 다른 모델의 검토, 실제 실행 확인이 필요한가.
• 어느 쪽을 고르든, 작업을 시작할 때 "완료를 어떤 결과로 확인할지" 먼저 적어 두었는가.

세 스킬은 겹치는 기능이 많아 한꺼번에 깔면 같은 일을 하는 스킬이 여럿 생깁니다. 하나를 골라 몇 주 써 본 뒤 부족한 부분만 다른 쪽에서 가져오는 편이 덜 헷갈립니다.

세 스킬 설치 명령 (Claude Code 기준)

아래는 각 저장소 공식 안내에 적힌 Claude Code용 설치 명령입니다(2026년 10월 기준). claude로 시작하는 줄은 터미널에, /plugin으로 시작하는 줄은 Claude Code 입력창에 넣습니다. 셋 다 플러그인이라, 설치할 때 상세 화면에서 들어갈 스킬을 확인하고 범위(나만 쓰기, 이 저장소의 모든 사람, 이 저장소의 나만)를 고릅니다. 명령은 바뀔 수 있으니 설치 전에 저장소 문서를 한 번 확인합니다.

skills 설치

터미널에서 실행합니다. 설치한 뒤 작업할 저장소에서 /setup-matt-pocock-skills를 한 번 실행해 이슈 관리 도구와 문서 위치를 정합니다.

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

agent-skills 설치

Claude Code 입력창에서 차례로 입력합니다. /review는 Claude Code에 같은 이름의 기본 명령이 있어서 /agent-skills:review로 부릅니다. 마켓플레이스를 추가할 때 SSH 오류가 나면 첫 줄을 /plugin marketplace add https://github.com/addyosmani/agent-skills.git로 바꿔 넣습니다.

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

pstack 설치

Claude Code 입력창에서 차례로 입력합니다. Claude Code에서는 명령 앞에 플러그인 이름이 붙어 /poteto-mode가 /pstack:poteto-mode가 됩니다. 처음에 /pstack:setup-pstack으로 쓸 모델을 고릅니다.

/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins

설치 확인과 지우기

• 확인: 입력창에 /plugin을 치고 Installed 탭에 플러그인이 보이는지 봅니다. 터미널에서는 claude plugin list로 볼 수 있습니다. 설치 끝에 "Run /reload-plugins to apply."가 나오면 /reload-plugins를 입력합니다.
• 업데이트: 공식 마켓플레이스에서 받은 skills는 스스로 업데이트됩니다. agent-skills와 pstack처럼 직접 추가한 마켓플레이스는 자동 업데이트가 꺼져 있어 claude plugin update pstack@cursor-plugins처럼 직접 받거나, /plugin의 마켓플레이스 탭에서 자동 업데이트를 켭니다.
• 지우기: /plugin의 Installed 탭에서 고르고 Uninstall을 누르거나, 터미널에서 claude plugin uninstall 플러그인@마켓플레이스를 실행합니다. 예를 들어 skills는 claude plugin uninstall mattpocock-skills@claude-plugins-official입니다.

저장소 주소는 아래와 같습니다.

• skills: github.com/…
• agent-skills: github.com/…
• pstack: github.com/…