AI 코딩 에이전트에 '시니어 개발자 습관'을 심는다? 깃허브 스타 10.8만 addyosmani/agent-skills 설치·사용법·활용사례 총정리

2026. 10. 21. 00:26ㆍAI/AI 스킬·플러그인

addyosmani agent-skills 공식 배너 Spec Plan Build Test Review Simplify Ship
agent-skills 공식 배너 (출처: addyosmani/agent-skills GitHub README)

 

AI한테 "이 기능 만들어줘" 하면 정말 빨리 만들어 주죠.

그런데 막상 열어 보면 테스트는 없고, 요구사항은 대충 넘겨짚었고,
건드리지 말라는 파일까지 고쳐 놓은 경우, 한 번쯤 겪어 보셨을 거예요.

 

오늘 소개할 addyosmani/agent-skills는 바로 이 문제를 겨냥한 오픈소스예요.
AI 코딩 에이전트가 "시니어 개발자처럼 일하는 습관"을 따르게 만드는 스킬 모음이에요.

 

깃허브 스타가 10만 개를 넘었을 만큼 인기가 많은데요,
오늘은 이게 뭔지, 어떻게 설치하고 쓰는지, 실제로 써 본 사람들은 뭐라고 하는지까지 쉽게 정리해 볼게요.

 

한 줄 요약
agent-skills는 크롬·구글 클라우드 AI 출신 개발자 Addy Osmani가 만든 MIT 무료 스킬 팩이에요. Claude Code, Codex, Cursor, Gemini CLI 같은 AI 코딩 에이전트가 스펙 → 계획 → 구현 → 테스트 → 리뷰 → 출시 순서를 건너뛰지 않도록 25개의 워크플로(SKILL.md)와 9개의 슬래시 명령어(/spec, /plan, /build, /test, /review, /ship 등)를 제공해요. 설치는 npx skills add addyosmani/agent-skills 한 줄이면 돼요.

1. agent-skills가 뭐예요? 쉽게 설명하면

agent-skills 공식 사이트 skills.addy.ie 메인 화면
공식 사이트 skills.addy.ie 메인 화면

출처: skills.addy.ie

 

먼저 "스킬(Skill)"이 뭔지부터 짚고 갈게요.

스킬은 AI 에이전트에게 주는 업무 매뉴얼 파일(SKILL.md)이에요.


평소엔 이름과 설명만 살짝 들고 있다가, 상황이 맞으면 본문을 꺼내 읽고 그 순서대로 일해요.

agent-skills는 이런 스킬을 소프트웨어 개발 전 과정에 맞춰 묶어 놓은 패키지예요.


제작자는 크롬 DevTools·Lighthouse·Core Web Vitals 개발자 경험을 이끌었고,
구글에서 14년 넘게 일한 뒤 지금은 Anthropic에서 Claude Code 관련 일을 하는 Addy Osmani예요.

그가 블로그에서 한 말이 이 프로젝트를 가장 잘 설명해 줘요.

"시니어 엔지니어의 일은 대부분 diff(코드 변경분)에 드러나지 않는 부분이다. 스펙, 테스트, 리뷰, 범위 관리. AI 코딩 에이전트는 기본적으로 이 부분을 건너뛴다." (Addy Osmani 블로그 글 요지)

 

즉, AI가 "일단 돌아가게만" 만드는 지름길을 막고,
사람 시니어가 하듯 근거를 남기며 단계별로 일하게 만드는 게 목표예요.

 

6단계 라이프사이클 한눈에 보기

단계 명령어 하는 일
Define(정의) /spec 무엇을 만들지 스펙(PRD) 먼저 작성
Plan(계획) /plan 작고 검증 가능한 작업 단위로 쪼개기
Build(구현) /build 한 조각씩 구현하고 테스트 후 커밋
Verify(검증) /test 테스트로 "돌아간다"를 증명
Review(리뷰) /review 머지 전 5가지 축으로 코드 리뷰
Ship(출시) /ship 출시 체크리스트와 Go/No-Go 판단

 

여기에 /constraints(품질 기준 정하기), /webperf(웹 성능 점검), /code-simplify(코드 단순화)까지 합쳐 명령어는 총 9개예요.


2. 특징 · 장점 · 단점 솔직 정리

agent-skills 네 가지 핵심 장치 Anti-rationalization Verification gates Parallel personas In-repo evals
agent-skills가 내세우는 4가지 핵심 장치

출처: skills.addy.ie

 

핵심 특징 4가지

 

① 핑계 차단표(Anti-rationalization)
"테스트는 나중에 쓸게요", "이건 너무 간단해서 스펙이 필요 없어요" 같은
AI가 단계를 건너뛸 때 쓰는 핑계와 반박을 표로 미리 넣어 놨어요.

test-driven-development 스킬의 Common Rationalizations 핑계와 반박 표
TDD 스킬 안의 "Common Rationalizations" 표. 왼쪽이 AI의 핑계, 오른쪽이 반박이에요

출처: GitHub · test-driven-development/SKILL.md

 

② 검증 게이트(Verification)
모든 스킬은 "테스트 통과, 빌드 결과, 실제 실행 데이터" 같은 증거로 끝나야 해요.
"대충 맞는 것 같아요"는 완료로 인정하지 않아요.

 

③ 리뷰 페르소나(Personas)
/ship을 실행하면 코드 리뷰어, 보안 감사관, 테스트 엔지니어, 웹 성능 감사관
4명의 전문가 역할이 동시에 검토하고, 결과를 하나의 Go/No-Go로 합쳐 줘요.

 

④ 저장소 안의 평가(Evals)
스킬이 제대로 발동하는지, 스킬끼리 겹치지 않는지 자동으로 검사하는 테스트가 저장소에 들어 있어요.

 

장점

• 범위가 넓어요.

아이디어 정리부터 API 설계, UI 접근성, 보안, 성능, CI/CD, 모니터링, 출시까지 다 다뤄요.


• 도구를 안 가려요.

Claude Code, Codex, Cursor, Gemini CLI, Copilot, Windsurf, OpenCode, Kiro 등에서 쓸 수 있어요.


• 구글식 엔지니어링 원칙
(하이럼의 법칙, 테스트 피라미드, 약 100줄 단위 변경, 체스터턴의 울타리 등)이 실제 절차로 녹아 있어요.


• 사람이 단계마다 확인할 수 있어서, AI에게 통째로 맡기기 불안한 분께 잘 맞아요.


• MIT 라이선스 무료이고, 마크다운이라 열어서 읽고 고치기 쉬워요.

 

단점 (실제 이슈 기반)

• 컨텍스트 비용:
스킬 설명은 매 세션 항상 로드돼요. 한 사용자는 설명만 약 4.7KB라고 측정했어요.


• 작은 작업엔 과할 수 있어요.

한 줄 수정에 스펙·계획까지 돌리면 오히려 느려요.


• 스킬이 안 켜질 때가 있어요.

코드를 프롬프트에 바로 붙여 넣은 요청에서는 스킬이 잘 발동하지 않았다는 측정이 이슈로 올라왔어요.


• 명령어 충돌:

Claude Code 기본 /review와 이름이 겹쳐서 /agent-skills:review로 불러야 해요.


• 슬래시 명령어는 일부 도구 전용:

Copilot 등에서는 /spec 대신 스킬 이름으로 불러야 해요.


• JS/TS 위주 예시:

TDD 스킬 예시가 자바스크립트 쪽에 치우쳤다는 지적이 있어 개선 제안이 진행 중이에요.


3. 깃허브 순위 · 스타 · 포크 · 반응

addyosmani agent-skills 깃허브 저장소 화면 스타 109k 포크 11.3k
GitHub 저장소 화면 (2026년 10월 20일 기준)

출처: github.com/addyosmani/agent-skills

항목 수치 (2026.10.20 기준)
스타 약 10만 8,700개 (108.7k)
포크 약 1만 1,300개 (11.3k)
Watch 541명
기여자 33명 (Trendshift 집계)
공개일 2026년 2월 15일
최신 버전 0.6.13 (2026년 10월 13일), 릴리스 15개
라이선스 MIT (무료, 상업 이용 가능)
순위 GitHub Trending 전체 1위 3일 기록(Trendshift), Star History 글로벌 랭크 #117

agent-skills 깃허브 스타 히스토리 그래프 2026년 3월부터 10월까지
스타 증가 추이 그래프. 4월부터 가파르게 올라 10월에 10만 개를 넘었어요

출처: star-history.com

 

성장 속도가 정말 빨라요.
5월 초 제작자 블로그 글에선 2만 7천 개였는데, 6월엔 약 5만 개, 10월엔 10만 개를 넘었어요.
최근 61일 동안만 스타가 약 1만 9,850개 늘었고, 자바스크립트 트렌딩에선 2위까지 올랐어요.

 

비슷한 계열인 Superpowers(약 30.2만 스타), Matt Pocock의 skills(약 29.8만 스타)보다는 작지만,
"전체 개발 라이프사이클을 다 다루는 스킬 팩"으로는 가장 많이 언급되는 프로젝트 중 하나예요.

 

커뮤니티 반응은?

• X(트위터)에서는 "/spec부터 /ship까지 팀 엔지니어링 프로세스를 스킬로 만들었다,

그중 interview-me가 제일 좋다"는 반응이 눈에 띄어요.


• 반대로 깃허브 이슈에서는 "몇 달 쓰다가 컨텍스트 부담 때문에 뺐다"는 솔직한 후기도 있어요.


• 제작자가 이런 비판 이슈에 직접 답하고 스킬을 다듬고 있다는 점은 좋은 신호예요.


4. 설치 방법 (도구별로 정리)

어떤 도구를 쓰든 가장 쉬운 방법은 한 줄 설치예요.
Node.js가 깔려 있다면 프로젝트 폴더에서 아래 명령을 실행해 보세요.

# 전체 25개 스킬 설치 (Claude Code, Cursor, Codex, Copilot, Cline 등 70+ 에이전트 지원)
npx skills add addyosmani/agent-skills

# 설치 전에 목록만 보기
npx skills add addyosmani/agent-skills --list

# 필요한 스킬만 골라 설치
npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill interview-me
npx skills add addyosmani/agent-skills --skill test-driven-development
TIP. 스킬 하나만 따로 설치하면 저장소 공용 체크리스트 폴더(references/)는 같이 안 따라와요. 체크리스트까지 쓰고 싶다면 전체 설치를 추천해요.

Claude Code (공식 추천)

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

 

설치 중 Permission denied (publickey) 오류가 나면 SSH 키 문제예요.
도커나 개발 컨테이너에서 자주 생기는데, 아래처럼 HTTPS로 바꿔 주면 돼요.

 

/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills

# 그래도 안 되면 (한 번만 설정)
git config --global url."https://github.com/".insteadOf git@github.com:

Codex / Gemini CLI / Antigravity / Command Code

# Codex (CLI v0.122 이상)
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

# Gemini CLI
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

# Antigravity CLI
agy plugin install https://github.com/addyosmani/agent-skills.git

# Command Code
cmd skills add addyosmani/agent-skills --global

Cursor · Copilot · Windsurf · 그 밖의 도구

Cursor는 .cursor/skills/에 스킬 폴더를, .cursor/rules/에는 짧은 규칙만 넣는 방식을 권장해요.
Copilot은 agents/ 페르소나와 .github/copilot-instructions.md를 활용해요.
스킬이 그냥 마크다운이라, 시스템 프롬프트나 규칙 파일을 받는 도구라면 사실상 어디서든 쓸 수 있어요.


5. 실제 사용 방법 (명령어 9개면 끝)

agent-skills 라이프사이클 6단계와 슬래시 명령어 표
단계별 명령어. Claude Code에서는 슬래시 명령어로 바로 실행돼요

출처: skills.addy.ie/lifecycle

명령어 언제 쓰나요? 핵심 원칙
/spec 무엇을 만들지 정할 때 코드보다 스펙 먼저
/plan 작업을 쪼갤 때 작고 원자적인 작업
/build 구현할 때 한 번에 한 조각
/test 동작을 증명할 때 테스트가 곧 증거
/constraints 팀 품질 기준을 정할 때 한 번 정하고 어디서나 강제
/review 머지 직전 코드 건강도 개선
/webperf 웹 성능 점검 최적화 전에 측정
/code-simplify 코드가 복잡해졌을 때 영리함보다 명확함
/ship 배포 직전 빠를수록 안전하다

기본 흐름은 이렇게

/spec   →  SPEC.md 작성 (무엇을, 왜, 어디까지)
/plan   →  tasks/plan.md (작업 목록 + 완료 기준)
/build  →  작업 하나씩: 실패하는 테스트 → 구현 → 통과 → 커밋
/test   →  전체 테스트 + 실제 브라우저 확인
/review →  정확성·가독성·구조·보안·성능 5축 리뷰
/ship   →  출시 체크리스트 + 롤백 계획 + Go/No-Go

 

계획을 매번 하나씩 승인하는 게 번거롭다면 /build auto를 쓰면 돼요.
계획을 한 번만 승인하면 모든 작업을 알아서 진행하되,
작업마다 테스트와 커밋은 그대로 하고 실패나 위험한 단계에서는 멈춰요.

 

agent-skills 24개 스킬 카탈로그 interview-me spec-driven-development test-driven-development
스킬 카탈로그 일부. 명령어 없이도 상황에 맞는 스킬이 자동으로 켜져요

출처: skills.addy.ie/skills

 

도구별 호출 방법 차이

• Claude Code: /spec처럼 슬래시 명령어 입력 (기본 /review와 겹치면 /agent-skills:review)
• Codex: @spec-driven-development처럼 @스킬이름 호출
• 그 외 도구: "spec-driven-development 스킬을 따라서 SPEC.md를 써 줘"처럼 스킬 이름을 넣어 요청

TIP. 처음이라면 3개만! 공식 문서는 spec-driven-development, test-driven-development, code-review-and-quality 세 개부터 시작하라고 권해요. 25개를 한꺼번에 다 켜 두는 건 컨텍스트 낭비라고 공식 문서도 말하고 있어요.
또 Claude Code처럼 자체 스킬 라우터가 있는 도구에서는 메타 스킬(using-agent-skills)을 항상 켜 두지 말라고 해요. 라우터가 두 개가 되어 꼬일 수 있거든요.

agent-skills ship 명령 4개 전문가 페르소나 code-reviewer test-engineer security-auditor web-performance-auditor
/ship을 실행하면 4명의 전문가 페르소나가 동시에 검토해요

출처: skills.addy.ie


6. 실제 사람들은 어떻게 쓰고 있을까? 베스트 사례

스타 수에 비해, 실제로 써 보고 결과를 숫자로 공개한 사례는 아직 많지 않아요.
그래서 "누가, 어떤 조건에서, 무엇을 확인했는지"가 분명한 사례만 골랐어요.

 

사례 ① 같은 모델·같은 코드로 Superpowers와 1:1 비교 실험

Claude Code superpowers vs agent-skills 비교 실험 커버 이미지
개발자 Om Mishra의 비교 실험 글 커버

출처: LinkedIn · Om Mishra, "Superpowers vs Agent-Skills"

 

개발자 Om Mishra는 Claude Code + Claude Sonnet 4.6, 같은 저장소, 같은 프롬프트로
스킬 팩만 바꿔서 실제 운영 중인 코드베이스에 복잡한 기능을 TDD로 추가해 봤어요.

항목 agent-skills Superpowers
첫 코드 변경까지 약 8분 약 12분
전체 소요 시간 약 22분 약 22분
검증 횟수 7회 (전체 446개 테스트 포함) 5회 (기능 주변 위주)
추가된 테스트 8개 7개
재계획 1회 1회

 

결정적인 차이는 검증 범위였어요.
agent-skills는 마지막에 전체 테스트를 돌리다가 기능 테스트로는 안 잡히던 호환성 문제를 찾아냈고,
그걸 고치면서 방어 테스트를 하나 더 추가했어요.

 

다만 이분은 큰 설계 고민이 필요한 일에는 여전히 Superpowers를 주력으로 쓴다고 했어요.
"요구사항이 분명하고 따라야 할 패턴이 있을 때 agent-skills가 특히 잘 맞는다"는 게 결론이에요.
한 사람의 단일 작업 실험이라는 점은 감안해서 보세요.

 

사례 ② 모델 업그레이드 전후로 스킬 성능 재측정

Driftproof라는 오픈소스 프로젝트 운영자는 모델이 sonnet-4-6에서 sonnet-5로 바뀌는 시점에
agent-skills의 스킬 3개를 같은 테스트 세트로 다시 돌려 봤어요.


코드 리뷰 스킬은 거의 그대로였지만, 일부 스킬은 특정 케이스에서 점수가 떨어졌다고 이슈(#432)로 공유했어요.

→ 시사점: 모델을 바꾸면 스킬 효과도 달라질 수 있어요. 중요한 프로젝트라면 업그레이드 후 한 번 점검해 보는 게 좋아요.

 

사례 ③ "몇 달 써 보고 뺐다"는 솔직한 후기

agent-skills 깃허브 이슈 433 Claude 5 세대 모델에서의 사용 후기
몇 달 사용 후 제거한 이유를 정리한 이슈 #433

출처: GitHub Issue #433

 

한 사용자는 Claude Code와 Cursor에서 몇 달간 쓰다가, 설정을 점검하며 이 팩을 뺐다고 해요.
이유는 ① 스킬 설명이 매 세션 컨텍스트를 차지하고, ② "핑계 차단표"가 최신 모델의 자체 판단과 겹치며,
③ Claude Code 기본 명령(/code-review, /security-review, /simplify, /plan)과 기능이 겹친다는 것이었어요.

 

본인도 "스킬이 틀렸다는 게 아니고, 전후 비교 데이터는 아직 없다"고 선을 그었어요.
이런 피드백 덕분에 스킬 설명을 다듬는 작업이 이어지고 있어요.

 

사례 ④ 메인테이너의 "스킬 발동률" 측정

공동 메인테이너 Federico Bartoli는 25개 스킬을 모두 켠 상태에서 같은 프롬프트를 6번씩 돌려 봤어요(#620).
그 결과 "이 함수 단순화해 줘", "이 diff로 커밋 메시지 써 줘"처럼

코드를 프롬프트에 붙여 넣은 요청에서는 담당 스킬이 거의 켜지지 않았어요.

 

그래서 지금 TDD 스킬 설명에는 "코드를 붙여 넣고 테스트를 언급하지 않아도 적용"이라는 문구가 추가돼 있어요.
실사용 팁: 확실하게 쓰고 싶을 땐 명령어나 스킬 이름을 직접 부르세요.

 

사례 ⑤ 세 가지 스킬 프레임워크 비교 정리

Superpowers Agent Skills Pocock 세 가지 AI 코딩 스킬 프레임워크 비교 일러스트
Superpowers · Agent Skills · Pocock 비교 글의 커버 일러스트

출처: DEV Community · jamilxt

구분 agent-skills Superpowers Matt Pocock skills
강점 기획~출시 전 과정, 단계별 사람 확인 긴 작업을 통째로 맡기기 요구사항 캐묻기(grill-me), 가벼운 일상 루프
잘 맞는 일 인증·테스트·보안 점검까지 갖춘 기능 출시, 팀 표준화 하룻밤 동안 큰 리팩터링 맡기기 요구사항이 흐릿할 때, 작은 작업
아쉬운 점 작은 작업엔 무거울 수 있음 과정이 가장 무거움 Claude Code 외 도구는 지원 편차

 

agent-skills 공식 비교 문서와 위 비교 글 모두 같은 결론이에요.
"절대적인 1등은 없고, 일의 모양에 맞춰 고르라"는 거예요.
참고로 두 개의 메타 스킬 프레임워크를 동시에 켜면 서로 충돌할 수 있으니 하나만 쓰는 게 좋아요.

 


7. 바로 따라 하는 실전 활용 시나리오 6가지

agent-skills 공식 튜토리얼 페이지 Learn the pack by shipping something
공식 튜토리얼 페이지. 프롬프트를 그대로 복사해 쓸 수 있어요

출처: skills.addy.ie/tutorials

 

아래 시나리오는 공식 튜토리얼과 가이드에 나온 흐름을 바탕으로 정리했어요.
프롬프트는 한국어로 바꿔 써도 되지만, 스킬 이름은 그대로 넣는 게 정확해요.

 

① 빈 폴더에서 앱 하나 완성하기 (입문, 30~45분)

공식 예제는 브라우저에서 돌아가는 습관 트래커예요. DB 없이 localStorage에 저장해요.

1) /spec + interview-me
   "습관 트래커를 만들고 싶어. 95% 확신이 들 때까지 한 번에 질문 하나씩 해 줘."
2) /spec  → SPEC.md (데이터 모델, 화면, 연속 기록 규칙, 하지 않을 것)
3) /plan  → tasks/plan.md
4) /build → "연속 기록 계산부터, 실패하는 테스트 먼저 쓰고 구현해 줘"
5) 저장 모듈 계약 설계 + 접근성 있는 UI
6) /test  → 전체 테스트 + 새로고침 후에도 데이터 유지 확인
7) /review → 습관 이름 XSS 방지, localStorage 데이터 검증
8) /ship  → 출시 체크리스트, 롤백 계획, Go/No-Go

→ 결과물: 앱 + SPEC.md + 작업 계획 + 테스트 + 출시 체크리스트까지 근거 문서가 같이 남아요.

 

② 남이 만든 코드에 기능 추가하기 (중급, 40~60분)

기존 서비스는 AI가 가장 사고를 많이 치는 곳이라, 순서가 조금 달라요.

1) context-engineering   → 저장소 규칙을 CLAUDE.md / AGENTS.md로 정리
2) source-driven-development → 공식 문서로 접근 방식 확인 + 출처 표시
3) /spec  → "이 엔드포인트에 rate limit 추가, 바뀌면 안 되는 것 명시"
4) doubt-driven-development → 기존 코드 동작에 대한 가정을 새 컨텍스트에서 반박 검증
5) /build → 현재 동작을 고정하는 테스트 먼저, 기능은 feature flag 뒤에
6) debugging-and-error-recovery → 재현·위치·축소·수정·재발 방지
7) /review → 약 100줄 이내, 기존 패턴과 맞는지
8) /ship  → 플래그로 단계적 배포 + 모니터링 + 롤백

 

③ 팀 PR 리뷰만 먼저 도입하기 (가장 안전한 시작)

공식 도입 가이드도 기존 코드베이스라면 "읽기만 하는 스킬부터" 시작하라고 해요.
code-review-and-quality는 코드를 바꾸지 않고 리뷰만 하니까 위험이 거의 없어요.

npx skills add addyosmani/agent-skills --skill code-review-and-quality
# Claude Code에서
/agent-skills:review

결과는 Critical / Nit / Optional / FYI 같은 심각도 라벨로 나와서, 머지를 막아야 할 것과 아닌 것이 바로 구분돼요.

 

④ 버그 고칠 때 "재발 방지 테스트"까지 받기

"이 테스트가 갑자기 실패해, debugging-and-error-recovery로 원인 찾아 줘"라고 요청하면
재현 → 위치 찾기 → 최소 사례로 축소 → 근본 수정 → 재발 방지 테스트 순서로 진행해요.
테스트를 억지로 통과시키는 게 아니라 원인을 남기는 게 핵심이에요.

 

⑤ 기획자·1인 창업자의 요구사항 정리

개발자가 아니어도 쓸모 있는 스킬이 interview-me와 idea-refine이에요.
"interview me"라고만 해도 AI가 한 번에 하나씩 질문하며 진짜 원하는 걸 끌어내 줘요.
그 결과를 /spec으로 넘기면 개발 외주나 AI 코딩에 바로 쓸 수 있는 스펙 문서가 돼요.

 

⑥ 배포 직전 마지막 점검 + 웹 성능 감사

/ship은 출시 체크리스트를 돌리고 4명의 페르소나가 동시에 검토해 Go/No-Go를 내려요.
웹 서비스라면 /webperf로 Core Web Vitals 기준 성능 점검도 따로 받을 수 있어요.
공식 튜토리얼엔 매일 밤 한 가지를 고치고 검증한 뒤 짧은 PR을 올리는 자동 루프 예제도 있어요.


8. 이런 분께 추천해요 / 이런 분은 비추천

추천 비추천
AI가 테스트 없이 코드를 막 만드는 게 불안한 분 한두 줄 고치는 작은 작업이 대부분인 분
팀에서 AI 사용 방식을 표준화하고 싶은 분 AI에게 긴 작업을 통째로 맡기고 싶은 분 (Superpowers가 더 맞을 수 있음)
보안·성능·출시 점검까지 한 번에 챙기고 싶은 분 컨텍스트(토큰) 사용량을 극도로 아껴야 하는 분
기존 프로젝트에 AI를 안전하게 들이고 싶은 분 이미 다른 스킬 프레임워크를 메타 라우터로 쓰고 있는 분

9. 자주 묻는 질문 (FAQ)

Q. addyosmani/agent-skills는 무료인가요?
A. 네, MIT 라이선스라 개인·회사 모두 무료로 쓸 수 있어요. 다만 Claude Code나 Codex 같은 에이전트 이용료는 별도예요.

 

Q. 설치는 어떻게 하나요?
A. npx skills add addyosmani/agent-skills 한 줄이면 돼요.

Claude Code는 /plugin marketplace 방식이 공식 추천이에요.

 

Q. 기존 프로젝트에도 쓸 수 있나요?
A. 네. 별도 마이그레이션 없이 프로젝트 루트에서 설치하면 돼요.

공식 가이드는 리뷰·디버깅 같은 읽기 위주 스킬부터 단계적으로 늘리라고 해요.

 

Q. Superpowers랑 뭐가 달라요?
A. agent-skills는 기획부터 출시까지 넓게, 단계마다 사람이 확인하는 방식이에요.

Superpowers는 긴 작업을 자율적으로 끝까지 돌리는 쪽에 강해요.

 

Q. Cursor에서도 /spec 같은 명령어가 되나요?
A. 슬래시 명령어는 Claude Code·Gemini CLI 등 어댑터가 있는 도구 위주예요.

Cursor에선 스킬 폴더를 넣고 스킬 이름으로 요청하면 돼요.

 

Q. 스킬이 자동으로 안 켜져요.
A. 코드를 붙여 넣은 요청에선 발동률이 낮다는 측정이 있어요. /spec, /review 같은 명령어나 스킬 이름을 직접 부르면 확실해요.

 


마무리: AI에게 "일 잘하는 습관"을 입혀 주는 도구

agent-skills는 AI를 더 똑똑하게 만드는 도구라기보다,
AI가 아는 걸 실제로 지키게 만드는 도구에 가까워요.

 

작은 작업엔 무거울 수 있고, 모델이 바뀌면 효과도 달라질 수 있어요.
그래도 "스펙 먼저, 테스트로 증명, 작게 나눠 리뷰"라는 원칙을 AI에게 강제하고 싶다면
지금 가장 손쉽게 시작할 수 있는 선택지예요.

 

처음엔 /spec, /test, /review 세 가지만 써 보세요.
AI가 만든 코드를 볼 때 마음이 한결 편해지는 걸 느끼실 거예요.

 

참고 자료
GitHub · addyosmani/agent-skills
공식 사이트 · skills.addy.ie
Addy Osmani 블로그 · Agent Skills
공식 비교 문서 · comparison.md
공식 도입 가이드 · adoption-guide.md
Om Mishra · Superpowers vs Agent-Skills
Issue #433
Issue #432
Issue #620
Trendshift · agent-skills
Star History

반응형