IROUMISM
AI에게 일을 시켜본 사람이라면 한 번쯤 겪습니다. 어렵게 다듬은 프롬프트로 좋은 결과를 얻었는데, 다음 작업에서는 처음부터 다시 설명하고 있는 자신을 발견하죠. "테스트부터 짜라", "바로 코드 쓰지 말고 설계를 먼저 보여달라", "다 됐다고 하지 말고 검증 결과를 보여달라" — 매번 같은 말을 반복합니다.
문제는 프롬프트가 일회용이라는 데 있습니다. 잘 만든 작업 방식이 한 번 쓰고 사라지면 품질은 그때그때 운에 맡겨집니다. Claude Code 사용자 사이에서 빠르게 퍼지고 있는 오픈소스 스킬 프레임워크 Superpowers는 이 문제를 정면으로 다룹니다.
Superpowers란 무엇인가 — Claude Code 스킬 프레임워크
Superpowers는 AI 코딩 에이전트를 위한 스킬 프레임워크이자 개발 방법론입니다. Jesse Vincent(깃허브 사용자명 obra)가 만든 커뮤니티 오픈소스 프로젝트로, 라이선스는 MIT이고, Claude Code의 공식 플러그인 마켓에서 바로 설치할 수 있습니다. (Anthropic이 만든 제품은 아니지만, 공식 마켓에 올라온 인기 프로젝트입니다.)
핵심 아이디어는 단순합니다. 잘 검증된 작업 절차를 "스킬(skill)"이라는 재사용 가능한 단위로 만들어 두고, 에이전트가 작업을 시작할 때 알아서 꺼내 쓰게 한다는 것입니다. 프롬프트를 매번 새로 쓰는 대신, 한 번 정리한 일하는 방식을 자산으로 쌓습니다.
스킬(Skill)은 어떻게 생겼나 — 마크다운 한 장의 작업 절차
스킬은 거창한 코드가 아니라 마크다운 파일 한 장입니다. 파일 맨 위에 "이 스킬은 언제 쓰는가"를 적은 짧은 머리말이 있고, 그 아래에 "어떻게 하는가"를 적습니다. 에이전트는 작업을 받으면 먼저 관련 스킬이 있는지 확인하고, 있으면 그 절차를 따릅니다.
Superpowers에 기본으로 들어 있는 대표적인 스킬들은 이렇습니다.
| 스킬 | 하는 일 |
|---|---|
| brainstorming | 코드를 쓰기 전에 무엇을 만들지 질문으로 좁혀 설계를 도출 |
| writing-plans | 설계를 2~5분짜리 작은 작업 단위로 쪼갠 실행 계획으로 |
| test-driven-development | 테스트를 먼저 쓰고, 실패를 확인하고, 통과할 최소 코드만 작성 |
| subagent-driven-development | 계획을 여러 에이전트에 나눠 작업하고 단계별로 검토 |
| systematic-debugging | 버그가 나면 고치기 전에 원인을 체계적으로 분석 |
| verification-before-completion | "다 됐다"고 말하기 전에 증거로 검증 |
Superpowers는 어떻게 작동하나
설치해 두면 사용자가 특별히 할 일은 없습니다. 예를 들어 "로그인 기능을 만들어줘"라고 하면, 보통의 에이전트는 곧장 코드를 쏟아내지만, Superpowers가 켜진 에이전트는 이렇게 반응합니다.
"코드부터 쓰기 전에 몇 가지 확인할게요. 로그인은 이메일/비밀번호 방식인가요, 소셜 로그인도 포함인가요?" → (요구사항을 좁힌 뒤) "이렇게 설계하려고 합니다. 괜찮으면 작은 작업 단위로 계획을 세우겠습니다." → 승인하면 테스트부터 작성하고, 검증 결과를 보여주며 단계별로 진행.
급하게 달려들지 않고 먼저 합의하고, 테스트로 검증하며 진행하는 — 일 잘하는 동료에게 기대하는 방식이 에이전트의 기본값이 되는 셈입니다.
프롬프트와 스킬은 무엇이 다른가
프롬프트는 그때그때의 지시입니다. 잘 써도 그 대화가 끝나면 사라지죠. 스킬은 한 번 정리해 두면 관련 작업마다 자동으로 적용되는 작업 절차입니다. 매번 다시 설명할 필요가 없고, 마크다운 파일이라 코드처럼 버전 관리하고 팀과 공유할 수 있습니다. "프롬프트를 잘 쓰는 기술"에서 "일하는 방식을 자산으로 정리해 두는 역량"으로 무게중심이 옮겨가는 것입니다.
왜 중요한가
- 품질과 일관성: 테스트 우선, 단계별 검토, 완료 전 검증 같은 규율이 매번 자동으로 적용됩니다. "그럴듯하지만 틀린" 결과물이 줄어듭니다.
- 재사용: 한 번 잘 정리한 절차는 모든 작업에, 그리고 팀 전체에 적용됩니다.
- 응용 범위: Claude Code를 중심으로 하지만, 다른 에이전트 환경에서도 같은 발상을 응용할 수 있게 설계됐습니다.
물론 만능은 아닙니다. 스킬을 잘못 정의하면 에이전트가 오히려 엉뚱한 절차를 고집할 수 있어서, "어떤 작업 방식을 절차로 남길 가치가 있는가"를 가리는 판단이 여전히 중요합니다. 그럼에도 방향은 분명합니다 — 좋은 결과는 도구 하나가 아니라, 검증된 일하는 방식을 자산으로 쌓는 데서 나옵니다.
참고로 이건 개발 이야기처럼 들리지만, 경리·고객 응대·보고서 작성처럼 매번 반복되는 회사 업무에 그대로 옮길 수 있는 발상입니다.
Superpowers 설치 방법 (Claude Code)
Claude Code를 쓰고 있다면 한 줄로 설치할 수 있습니다(공식 마켓).
/plugin install superpowers@claude-plugins-official
제작자가 운영하는 마켓을 직접 추가해 설치할 수도 있습니다.
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
설치 후에는 별도 설정 없이, 작업을 시작할 때 관련 스킬이 자동으로 적용됩니다. 더 자세한 내용과 직접 만들 수 있는 스킬 구조는 공식 저장소 github.com/obra/superpowers에서 볼 수 있습니다.
이로미즘은 이 발상을 어떻게 쓰는가
저희도 콘텐츠 자동화 서비스 카이로스AI를 만들고 운영하면서, 매번 새로 지시하는 대신 리서치 · 원고 · 검수 · 발행 같은 반복 작업을 에이전트가 따르는 절차로 정리해 자산으로 쌓아 왔습니다. Superpowers가 개발 영역에서 보여 주는 것을, 저희는 기업의 업무 전반에 똑같이 적용합니다. "도구를 도입한다"가 아니라 "우리 회사가 일하는 방식을 에이전트가 따를 수 있는 절차로 정리한다" — 이것이 좋은 자동화의 출발점입니다.
자주 묻는 질문
개발자가 아니어도 의미가 있나요? 도구 자체는 코딩 에이전트를 위한 것이지만, 핵심 발상(잘 만든 작업 절차를 재사용 가능한 형태로 자산화한다)은 모든 업무 자동화에 그대로 적용됩니다.
설치에 사전 조건이 있나요? 최신 버전의 Claude Code가 필요합니다. 설치 후에는 작업을 시작하면 관련 스킬이 자동으로 적용됩니다.
꼭 Claude에서만 되나요? Claude Code를 중심으로 하지만, 다른 코딩 에이전트 환경에서도 같은 방식을 응용할 수 있습니다.
AI를 도입했는데 결과가 들쭉날쭉하다면, 보통 '도구'가 아니라 '절차'가 문제입니다. 이로미즘의 30분 무료 진단에서는 귀사의 반복 업무 중 가장 먼저 자산화할 1~2가지를 함께 짚어 드립니다. 영업이 아니라 진단이 목적이니, 도입 여부는 그다음에 편하게 결정하시면 됩니다.